Microsoft.Agents.Core.Models Namespace

Classes

AadResourceUrls

The AadResourceUrls.

ActionTypes

Defines values for CardAction Types.

Activity
ActivityEventNames

Define values for common event names used by activities of type Event.

ActivityImportance

Defines values for ActivityImportance.

ActivityTreatment

The type ActivityTreatment indicates that this object will contain metadata to indicate to clients how the activity should be handled.

ActivityTreatmentTypes

Treatment types for ActivityTreatment.

ActivityTypes

Defines values for ActivityTypes.

AdaptiveCardInvokeAction

Defines the structure that arrives in the Activity.Value.Action for Invoke activity with Name of 'adaptiveCard/action'.

AdaptiveCardInvokeResponse

Defines the structure that is returned as the result of an Invoke activity with Name of 'adaptiveCard/action'.

AdaptiveCardInvokeValue

Defines the structure that arrives in the Activity.Value for Invoke activity with Name of 'adaptiveCard/action'.

AIEntity

The AI Citations Entity.

AnimationCard

An animation card (Ex: gif or short video clip).

AppearanceImage

Represents how the citation will be rendered.

Attachment

An attachment within an activity.

AttachmentLayoutTypes

Defines values for AttachmentLayoutTypes.

AudioCard

Audio card.

BasicCard

A basic card.

CallerIdConstants

Constants used to populate the CallerId property.

CardAction

A card action represents a clickable or interactive button for use within cards or as suggested actions. They are used to solicit input from users.Despite their name, card actions are not limited to use solely on cards.

Card actions are meaningful only when sent to channels.

Channels decide how each action manifests in their user experience.In most cases, the cards are clickable. In others, they may be selected by speech input.In cases where the channel does not offer an interactive activation experience (e.g., when interacting over SMS), the channel may not support activation whatsoever.The decision about how to render actions is controlled by normative requirements elsewhere in this document (e.g.within the card format, or within the suggested actions definition).

CardImage

An image on a card.

ChannelAccount

Channel account information needed to route a message.

ChannelId

Represents a channel identifier, optionally including a sub-channel. Provides parsing, equality, and conversion operations for channel IDs.

Channels

Channel definitions. The various "support" methods come from: https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0

Citation

Citations used in the message.

CitationUtils
ClientCitation

The client citation.

ClientCitationAppearance

The client citation appearance.

ClientCitationIconName

Represents the different possible values for the client citation icon name.

CommandResultValue<T>

The value field of a ICommandResultActivity contains metadata related to a command result. An optional extensible data payload may be included if defined by the command result activity name. The presence of an error field indicates that the original command failed to complete.

CommandValue<T>

The value field of a ICommandActivity contains metadata related to a command. An optional extensible data payload may be included if defined by the command activity name.

ContactRelationUpdateActionTypes

Defines values for ContactRelationUpdateActionTypes.

ConversationAccount

Conversation accounts represent the identity of conversations within a channel. In channels that support only a single conversation between two accounts (e.g. SMS), the conversation account is persistent and does not have a predetermined start or end. In channels that support multiple parallel conversations (e.g. email), each conversation will likely have a unique ID.

ConversationParameters

Parameters for creating a new conversation.

ConversationReference

The conversationReference type contains a reference into another conversation. In its most minimal form, this reference may only contain the IDs of the target conversation. Implementers may wish to carry additional information in the conversationReference, such as the identity and roles of participants, and the ID of a specific activity within the conversation. Consumers of the conversationReference type are not provided any de facto guarantees about the validity or consistency of the IDs within the object; this is instead conferred by the sender who created the object.

The conversationReference type is frequently used to store a reference to a conversation so it can be later retrieved and used to continue a conversation.

DeliveryModes

DeliveryModes define how an Agent receiving an Activity replies to the sender. DeliveryMode

EndOfConversationCodes

Defines values for EndOfConversationCodes.

Entity

Entities carry metadata about an activity or conversation. Each entity's meaning and shape is defined by the type field. Additional type-specific fields sit as peers to the type field.

Some Microsoft entities may have a preexisting field called type. Parties integrating these entities into the activity entity format are advised to define field-level mapping to resolve conflicts with the type field name and other incompatibilities with serialization requirement A2001 as part of the IRI defining the entity type.

Frequently, entities used within Activity Protocol are also expressed elsewhere using JSON-LD[17]. The entity format is designed to be compatible with JSON-LD contexts, but does not require senders or receivers to implement JSON-LD to successfully process an entity.

EntityExtension
EntityTypes
Error

Object representing error information.

ExpectedReplies

Contents of the reply to an operation which returns expected Activity replies.

Extensions

Extension methods for converting strongly typed Card objects to Attachment.

Fact

Set of key-value pairs. Advantage of this section is that key and value properties will be rendered with default style information with some delimiter between them. So there is no need for developer to specify style information.

GeoCoordinates

GeoCoordinates (entity type: "https://schema.org/GeoCoordinates").

HandoffEventFactory

Contains utility methods for creating various event types.

HandoffEventNames

Defines values for handoff event names.

HeroCard

A Hero card (card with a single, large image).

IActivityExtensions

Public Extensions for IActivity. type

InnerHttpError

Object representing inner http error.

InputHints

Defines values for InputHints.

InstallationUpdateActionTypes

Defines values for InstallationUpdateActionTypes.

InvokeResponse

A tuple class containing an HTTP status code and a JSON-serializable object.

InvokeResponse<T>

A tuple class containing an HTTP status code and a JSON-serializable object. The HTTP status code is, in the invoke activity scenario, what will be set in the resulting POST. The body of the resulting POST will be the JSON-serialized content from the Body property.

MediaCard

Media card.

MediaEventValue

Supplementary parameter for media events.

MediaUrl

Media URL.

Mention

Mention information (entity type: "mention").

MessageFactory

Contains utility methods for various message types a Agent can return.

MessageReaction

Message reaction object.

MessageReactionTypes

Defines values for MessageReactionTypes.

OAuthCard

A card representing a request to perform a sign in via OAuth.

PagedMembersResult

Page of members.

Place

Place (entity type: "https://schema.org/Place").

ProductInfo
ReceiptCard

A receipt card.

ReceiptItem

An item on a receipt card.

ResourceResponse

A response containing a resource ID.

RoleTypes

Defines values for RoleTypes.

SearchInvokeOptions

Defines the query options in the SearchInvokeValue for Invoke activity with Name of 'application/search'.

SearchInvokeResponse

Defines the structure that is returned as the result of an Invoke activity with Name of 'adaptiveCard/search'.

SearchInvokeTypes

Defines values for SearchInvokeTypes. See SearchInvokeValue.

SearchInvokeValue

Defines the structure that arrives in the Activity.Value for Invoke activity with Name of 'application/search'.

SemanticAction

Represents a reference to a programmatic action.

SemanticActionStates

Indicates whether the semantic action is starting, continuing, or done.

SensitivityUsageInfo

The sensitivity usage info.

SensitivityUsageInfoPattern

The sensitivity usage info pattern.

SigninCard

A card representing a request to sign in.

SignInConstants

Names for signin invoke operations in the token protocol.

SignInResource

A type containing information for single sign-on.

SpeechConstants

Defines constants that can be used in the processing of speech interactions.

StreamInfo

Stream information will be included in an Entity in the Activity.

StreamResults
StreamTypes

The type of streaming message being sent.

SuggestedActions

SuggestedActions that can be performed.

TextFormatTypes

Defines values for TextFormatTypes.

TextHighlight

Refers to a substring of content within another field.

Thing

Thing (entity type: "https://schema.org/Thing").

ThumbnailCard

A thumbnail card (card with a single, small thumbnail image).

ThumbnailUrl

Thumbnail URL.

TokenExchangeInvokeRequest

A request to exchange a token.

TokenExchangeInvokeResponse

The response object of a token exchange invoke.

TokenExchangeRequest

The TokenExchangeRequest.

TokenExchangeResource

Record for a token exchange request that is sent as part of Authentication.

TokenExchangeState

State object passed to the Token Service.

TokenOrSignInResourceResponse
TokenPollingSettings

Helps provide polling for token details.

TokenPostResource

Response schema sent back from Azure Token Service required to initiate a user token direct post.

TokenRequest

A request to receive a user token.

TokenResponse

A response that includes a user token.

TokenStatus

The status of a particular token.

Transcript

Transcript.

VideoCard

Video card.

Interfaces

IActivity

An Activity is the basic communication type for the Activity Protocol used with Agents.

ICommandActivity

Asynchronous external command.

ICommandResultActivity

Asynchronous external command result.

IContactRelationUpdateActivity

A user has added an Agent to their contact list, removed the Agent from their contact list, or otherwise changed the relationship between user and Agent.

IConversationUpdateActivity

The referenced conversation has been updated.

IEndOfConversationActivity

Conversation is ending, or a request to end the conversation.

IEventActivity

Asynchronous external event.

IHandoffActivity

Control of the conversation has been transferred, or a request to transfer control of the conversation.

IInstallationUpdateActivity

An Agent was installed or removed from a channel.

IInvokeActivity

Synchronous request to invoke an operation.

IMessageActivity

A message in a conversation.

IMessageDeleteActivity

Represents a request to delete a previous message activity in a conversation.

IMessageReactionActivity

A reaction to a Message Activity.

IMessageUpdateActivity

Represents a request to update a previous message activity in a conversation.

ISuggestionActivity

Represents a private suggestion to the Recipient about another activity.

ITraceActivity

Represents a point in a Agent's logic, to help with Agent debugging.

ITypingActivity

The From address is typing.