Microsoft.Agents.Protocols.Primitives Namespace
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Aad |
The AadResourceUrls. |
Action |
Defines values for CardAction Types. |
Activity | |
Activity |
Define values for common event names used by activities of type Event. |
Activity |
Defines values for ActivityImportance. |
Activity |
Defines values for ActivityTypes. |
Adaptive |
Defines the structure that arrives in the Activity.Value.Authentication for Invoke activity with Name of 'adaptiveCard/action'. |
Adaptive |
Defines the structure that arrives in the Activity.Value.Action for Invoke activity with Name of 'adaptiveCard/action'. |
Adaptive |
Defines the structure that is returned as the result of an Invoke activity with Name of 'adaptiveCard/action'. |
Adaptive |
Defines the structure that arrives in the Activity.Value for Invoke activity with Name of 'adaptiveCard/action'. |
Animation |
An animation card (Ex: gif or short video clip). |
Attachment |
An attachment within an activity. |
Attachment |
Attachment data. |
Attachment |
Metadata for an attachment. |
Attachment |
Defines values for AttachmentLayoutTypes. |
Attachment |
Attachment View name and size. |
Audio |
Audio card. |
Basic |
A basic card. |
Caller |
Constants used to populate the CallerId property. |
Card |
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). |
Card |
An image on a card. |
Channel |
Channel account information needed to route a message. |
Channels | |
Command |
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. |
Command |
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. |
Contact |
Defines values for ContactRelationUpdateActionTypes. |
Conversation |
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. |
Conversation |
Conversation and its members. |
Conversation |
Parameters for creating a new conversation. |
Conversation |
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. |
Conversation |
A response containing a resource. |
Conversations |
Conversations result. |
Delivery |
Defines values for DeliveryModes. |
End |
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 non-Bot-Framework 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. |
Error |
Object representing error information. |
Error |
An HTTP API Error response. |
Expected |
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. |
Geo |
GeoCoordinates (entity type: "https://schema.org/GeoCoordinates"). |
Hero |
A Hero card (card with a single, large image). |
IActivity |
Public Extensions for IActivity. type |
Inner |
Object representing inner http error. |
Input |
Defines values for InputHints. |
Installation |
Defines values for InstallationUpdateActionTypes. |
Invoke |
A tuple class containing an HTTP status code and a JSON-serializable object. |
Invoke |
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. |
Media |
Media card. |
Media |
Supplementary parameter for media events. |
Media |
Media URL. |
Mention |
Mention information (entity type: "mention"). |
Message |
Contains utility methods for various message types a bot can return. |
Message |
Message reaction object. |
Message |
Defines values for MessageReactionTypes. |
OAuth |
A card representing a request to perform a sign in via OAuth. |
Paged |
Page of members. |
Place |
Place (entity type: "https://schema.org/Place"). |
Receipt |
A receipt card. |
Receipt |
An item on a receipt card. |
Resource |
A response containing a resource ID. |
Role |
Defines values for RoleTypes. |
Search |
Defines the query options in the SearchInvokeValue for Invoke activity with Name of 'application/search'. |
Search |
Defines the structure that is returned as the result of an Invoke activity with Name of 'adaptiveCard/search'. |
Search |
Defines values for SearchInvokeTypes. See SearchInvokeValue. |
Search |
Defines the structure that arrives in the Activity.Value for Invoke activity with Name of 'application/search'. |
Semantic |
Represents a reference to a programmatic action. |
Semantic |
Indicates whether the semantic action is starting, continuing, or done. |
Signin |
A card representing a request to sign in. |
Sign |
A type containing information for single sign-on. |
Speech |
Defines constants that can be used in the processing of speech interactions. |
Suggested |
SuggestedActions that can be performed. |
Text |
Defines values for TextFormatTypes. |
Text |
Refers to a substring of content within another field. |
Thing |
Thing (entity type: "https://schema.org/Thing"). |
Thumbnail |
A thumbnail card (card with a single, small thumbnail image). |
Thumbnail |
Thumbnail URL. |
Token |
A request to exchange a token. |
Token |
The response object of a token exchange invoke. |
Token |
The TokenExchangeRequest. |
Token |
Record for a token exchange request that is sent as part of Authentication. |
Token |
State object passed to the bot token service. |
Token |
Helps provide polling for token details. |
Token |
Response schema sent back from Azure Bot Service Token Service required to initiate a user token direct post. |
Token |
A request to receive a user token. |
Token |
A response that includes a user token. |
Token |
The status of a particular token. |
Transcript |
Transcript. |
Turn |
Values persisted for the lifetime of the turn as part of the ITurnContext. |
Video |
Video card. |
IActivity |
An Activity is the basic communication type for the Azure Bot Service 3.0 protocol. |
IAttachments |
Attachments operations. |
IBot |
Represents a bot that can operate on incoming activities. |
IBot |
Represents a bot adapter that can connect a bot to a service endpoint. This class is abstract. |
IChannel |
Handles creation of IConnectorClient and IUserTokenClient objects for use when handling incoming Activities. |
ICommand |
Asynchronous external command. |
ICommand |
Asynchronous external command result. |
IConnector |
The Bot Connector API allows communicating back to the incoming request. Typically to the Activity.ServiceUrl property. |
IContact |
A user has added a bot to their contact list, removed the bot from their contact list, or otherwise changed the relationship between user and bot. |
IConversations |
Conversations operations. |
IConversation |
The referenced conversation has been updated. |
IEnd |
Conversation is ending, or a request to end the conversation. |
IEvent |
Asynchronous external event. |
IHandoff |
Control of the conversation has been transferred, or a request to transfer control of the conversation. |
IInstallation |
A bot was installed or removed from a channel. |
IInvoke |
Synchronous request to invoke an operation. |
IMessage |
A message in a conversation. |
IMessage |
Represents a request to delete a previous message activity in a conversation. |
IMessage |
A reaction to a Message Activity. |
IMessage |
Represents a request to update a previous message activity in a conversation. |
IMiddleware |
Represents middleware that can operate on incoming activities. |
IMiddleware |
|
IStorage |
Defines the interface for a storage layer. |
IStore |
Exposes an ETag for concurrency control. |
ISuggestion |
Represents a private suggestion to the Recipient about another activity. |
ITrace |
Represents a point in a bot's logic, to help with bot debugging. |
ITurn |
Provides context for a turn of a bot. |
ITurn |
Provides context for a turn of a bot, where the context's Activity property is strongly typed. |
ITyping |
The From address is typing. |
IUser |
Client for access user token service. |
Bot |
The callback delegate for application code. |
Delete |
A method that can participate in delete activity events for the current turn. |
Next |
Encapsulates an asynchronous method that calls the next IMiddleware.OnTurnAsync(ITurnContext, NextDelegate, CancellationToken) or IBot.OnTurnAsync(ITurnContext, CancellationToken) method in the middleware pipeline. |
Send |
A method that can participate in send activity events for the current turn. |
Update |
A method that can participate in update activity events for the current turn. |