Microsoft.Agents.Builder.App Namespace

Classes

Name Description
ActivityRouteAttribute

Attribute to define a route that handles activities matching a specific type or type pattern.

AgentApplication

Application class for routing and processing incoming requests.

AgentApplicationBuilder

A builder class for simplifying the creation of an AgentApplication instance.

AgentApplicationOptions

Options for the AgentApplication class. AgentApplicationOptions can be constructed via IConfiguration values or programmatically.

AgentAttribute
AgentExtensionAttribute<TExtension>

Base attribute for automatically generating an extension property on an AgentApplication subclass.

AgenticAuthorization
AgentInterfaceAttribute

Declares a transport protocol for interacting with the agent. This allows agents to expose the same functionality over multiple transport mechanisms.

AgentTransportProtocol

Defines constants for supported transport protocols for agent interfaces in Agents SDK Core.

AttachmentDownloader
ConversationUpdateEvents

Conversation update events.

ConversationUpdateRouteAttribute

Attribute to define a route that handles conversation update activities, optionally matching a specific event.

ConversationUpdateRouteBuilder

Provides a concrete builder for routing conversation update activities in an AgentApplication.

ConversationUpdateRouteBuilderBase<TBuilder>

Provides the generic base builder for routing conversation update activities in an AgentApplication.

EndOfConversationRouteAttribute

Attribute to define a route that handles end of conversation activities.

EventRouteAttribute

Attribute to define a route that handles event activities, optionally matching a specific event name or name pattern.

EventRouteBuilder

Provides a concrete builder for routing event activities in an AgentApplication.

EventRouteBuilderBase<TBuilder>

Provides the generic base builder for routing event activities in an AgentApplication.

FeedbackActionValue

The feedback loop data's action value.

FeedbackData

Data returned when the thumbsup or thumbsdown button is clicked and response is received.

FeedbackLoopRouteAttribute

Attribute to define a route that handles feedback loop invoke activities.

FeedbackRouteBuilder

Provides a concrete builder for routing feedback loop invoke activities in an AgentApplication.

FeedbackRouteBuilderBase<TBuilder>

Provides the generic base builder for routing feedback loop invoke activities in an AgentApplication.

HandoffRouteAttribute

Attribute to define a route that handles handoff action invoke activities.

HandoffRouteBuilder

Provides a concrete builder for routing handoff invoke activities in an AgentApplication.

HandoffRouteBuilderBase<TBuilder>

Provides the generic base builder for routing handoff invoke activities in an AgentApplication.

InputFile

Represents an upload file

InstallationUpdateRouteAttribute

Attribute to define a route that handles InstallationUpdate activities.

InvokeRouteBuilder

RouteBuilder for routing Invoke activities in an AgentApplication.

M365AttachmentDownloader

Downloads attachments from M365/Teams using the configured Token Provider (from IConnections).

M365AttachmentDownloaderOptions

The M365AttachmentDownloader options

MembersAddedRouteAttribute

Attribute to define a route that handles conversation update activities when members are added.

MembersRemovedRouteAttribute

Attribute to define a route that handles conversation update activities when members are removed.

MessageReactionsAddedRouteAttribute

Attribute to define a route that handles message reaction added activities.

MessageReactionsAddedRouteBuilder

RouteBuilder for routing message reactions added activities in an AgentApplication.

MessageReactionsRemovedRouteAttribute

Attribute to define a route that handles message reaction removed activities.

MessageReactionsRemovedRouteBuilder

RouteBuilder for routing message reactions removed activities in an AgentApplication.

MessageRouteAttribute

Attribute to define a route that handles message activities, optionally matching specific text or a text pattern.

MessageRouteBuilder

Provides a concrete builder for routing message activities in an AgentApplication.

MessageRouteBuilderBase<TBuilder>

Provides the generic base builder for routing message activities in an AgentApplication.

MultipleRouteSelector

Combination of String, Regex, and RouteSelectorAsync selectors.

Route
RouteAttribute

Adds an AgentApplication Routes

RouteAttributeHelper

Shared helper for applying sign-in handlers to a route builder.

RouteBuilder
RouteBuilderBase<TBuilder>

Provides a fluent builder for configuring and constructing a Route instance with custom selection logic, handlers, and routing options.

RouteRank
TurnContextExtensions

AgentApplication ITurnContext extensions

TypeRouteBuilder

Provides a concrete builder for routing activities by activity type in an AgentApplication.

TypeRouteBuilderBase<TBuilder>

Provides the generic base builder for routing activities by activity type in an AgentApplication.

TypingChannelStrategy

Concrete per-channel typing strategy with configurable initial delay and interval.

TypingOptions

Options for controlling the typing indicator behavior.

Interfaces

Name Description
IInputFileDownloader

A plugin responsible for downloading files relative to the current user's input.

IRouteAttribute

Defines a contract for attributes that add routing information to an agent application.

ITypingChannelStrategy

Defines per-channel timing parameters for the typing worker.

Enums

Name Description
RouteFlags
RouteType

Delegates

Name Description
AgentApplicationTurnError
FeedbackLoopHandler

Function for feedback loop activities

HandoffHandler

Function for handling handoff activities.

RouteHandler

The common route handler. Function for handling an incoming request.

RouteSelector

Function for selecting whether a route handler should be triggered.

TurnEventHandler

Turn event handler to do something before or after a turn is run. Returning false from beforeTurn lets you prevent the turn from running and returning false from afterTurn lets you prevent the Agents state from being saved.

Returning false from beforeTurn does result in the Agents state being saved which lets you track the reason why the turn was not processed. It also means you can use beforeTurn as a way to call into the dialog system. For example, you could use the OAuthPrompt to sign the user in before allowing the AI system to run.

TurnStateFactory

TurnState for an Agent is created at the beginning of a Turn by invoking the specified factory delegate.