Cards sample using AgentApplication

[tracyboehrer]

This, like the one in JS, is an adaptation of the one from BF, without Dialogs, and with the addition of AgentApplication.AdaptiveCards.

This also adds some helper methods in Channels to determine support for cards. Teams doesn't support several.

Note: This uses the new style of Program.cs that Matt used in the Auth samples.

[Copilot]

Copilot reviewed 16 out of 22 changed files in this pull request and generated 2 comments.

Files not reviewed (6)

• src/Microsoft.Agents.SDK.sln: Language not supported
• src/samples/HandlingCards/HandlingCards.csproj: Language not supported
• src/samples/HandlingCards/Resources/DynamicSearchCard.json: Language not supported
• src/samples/HandlingCards/Resources/StaticSearchCard.json: Language not supported
• src/samples/HandlingCards/appManifest/manifest.json: Language not supported
• src/samples/HandlingCards/appsettings.json: Language not supported

Comments suppressed due to low confidence (1)

src/samples/HandlingCards/Cards.cs:18

• The initialization of _cardCommands is incorrect. Replace the repeated assignment and square brackets with a proper collection initializer, e.g., 'new List { ... }'.

static IList<CardCommand> _cardCommands = _cardCommands = [

[rido-min]

AllowAnonymoys should be added when IsDevelopment==true

[rido-min]

can we use defaults, that can be overriden with launchSettings?

why not 3978?

[rido-min]

this file produces Warnings in VS

Warning Property name is not allowed by the schema HandlingCards D:\Agents-for-net\src\samples\HandlingCards\Resources\DynamicSearchCard.json 37

Warning Value must conform to at least one of the associated schemas
| Value must be one of the following values: "compact", "expanded"
| or
| Value must match the regular expression ^([c|C][o|O][m|M][p|P][a|A][c|C][t|T])|([e|E][x|X][p|P][a|A][n|N][d|D][e|E][d|D])$ HandlingCards D:\Agents-for-net\src\samples\HandlingCards\Resources\DynamicSearchCard.json 48

[rido-min]

When running the sample on Teams, I got two issues

1. ReceiptCard is not rendered, instead I got: Go back to the main window to see this content.
2. AnimationCard throws

Error: ReplyToActivity operation returned an invalid status code '(400) BadRequest'
HelpLink Url: https://aka.ms/AgentsSDK-Error07
Stack Trace: at Microsoft.Agents.Connector.RestClients.ConversationsRestClient.HandleExceptionResponse(HttpResponseMessage httpResponse, AgentErrorDefinition errorMessage, CancellationToken cancellationToken, String[] errors) in D:\Agents-for-net\src\libraries\Client\Microsoft.Agents.Connector\RestClients\ConversationsRestClient.cs:line 519
at Microsoft.Agents.Connector.RestClients.ConversationsRestClient.ReplyToActivityAsync(String conversationId, String activityId, IActivity body, CancellationToken cancellationToken) in D:\Agents-for-net\src\libraries\Client\Microsoft.Agents.Connector\RestClients\ConversationsRestClient.cs:line 263
at Microsoft.Agents.Connector.RestClients.ConversationsRestClient.ReplyToActivityAsync(IActivity activity, CancellationToken cancellationToken) in D:\Agents-for-net\src\libraries\Client\Microsoft.Agents.Connector\RestClients\ConversationsRestClient.cs:line 234
at Microsoft.Agents.Builder.ChannelServiceAdapterBase.SendActivitiesAsync(ITurnContext turnContext, IActivity[] activities, CancellationToken cancellationToken) in D:\Agents-for-net\src\libraries\Builder\Microsoft.Agents.Builder\ChannelServiceAdapterBase.cs:line 85
at Microsoft.Agents.Builder.TurnContext.<>c__DisplayClass37_0.<g__SendActivitiesThroughAdapter|1>d.MoveNext() in D:\Agents-for-net\src\libraries\Builder\Microsoft.Agents.Builder\TurnContext.cs:line 281

[rido-min]

I was wondering this sample shows the value of:

Agents-for-net/src/libraries/Builder/Microsoft.Agents.Builder/App/AgentApplicationBuilder.cs

Line 50 in b74150f

public AgentApplicationBuilder WithAdaptiveCardOptions(AdaptiveCardsOptions adaptiveCardOptions)

However since it's not using the builder, I guess this has to be configured via appSettings, and seems the sample does not require it.

In which cases the Application requires WithAdaptiveCardOptions ?

[tracyboehrer]

I was wondering this sample shows the value of:

Agents-for-net/src/libraries/Builder/Microsoft.Agents.Builder/App/AgentApplicationBuilder.cs

Line 50 in b74150f

public AgentApplicationBuilder WithAdaptiveCardOptions(AdaptiveCardsOptions adaptiveCardOptions)

However since it's not using the builder, I guess this has to be configured via appSettings, and seems the sample does not require it.

In which cases the Application requires WithAdaptiveCardOptions ?

I don't know. This portion of the sample came from the Teams AI SDK adaptiveCards.a.typeAheadBot. They didn't explicitly set that either. i.e., It just uses the default of "verb".

[rido-min]

I noticed the AdaptiveCard is always configured in the ctor

Agents-for-net/src/libraries/Builder/Microsoft.Agents.Builder/App/AgentApplication.cs

Line 58 in b74150f

AdaptiveCards = new AdaptiveCard(this);

Do we still need the "WithAdaptiveCards" method in the builder?

[tracyboehrer]

Well I don't think we even need Builder. But that is another discussion. The entire thing is there for as much back-compat as we could leave.

It would appear AdaptiveCard.OnActionSubmit has some clues around that option.

[tracyboehrer]

Also, this sample doesn't show OnExecute yet either.

[tracyboehrer]

When running the sample on Teams, I got two issues

1. ReceiptCard is not rendered, instead I got: Go back to the main window to see this content.
2. AnimationCard throws

Error: ReplyToActivity operation returned an invalid status code '(400) BadRequest' HelpLink Url: https://aka.ms/AgentsSDK-Error07 Stack Trace: at Microsoft.Agents.Connector.RestClients.ConversationsRestClient.HandleExceptionResponse(HttpResponseMessage httpResponse, AgentErrorDefinition errorMessage, CancellationToken cancellationToken, String[] errors) in D:\Agents-for-net\src\libraries\Client\Microsoft.Agents.Connector\RestClients\ConversationsRestClient.cs:line 519 at Microsoft.Agents.Connector.RestClients.ConversationsRestClient.ReplyToActivityAsync(String conversationId, String activityId, IActivity body, CancellationToken cancellationToken) in D:\Agents-for-net\src\libraries\Client\Microsoft.Agents.Connector\RestClients\ConversationsRestClient.cs:line 263 at Microsoft.Agents.Connector.RestClients.ConversationsRestClient.ReplyToActivityAsync(IActivity activity, CancellationToken cancellationToken) in D:\Agents-for-net\src\libraries\Client\Microsoft.Agents.Connector\RestClients\ConversationsRestClient.cs:line 234 at Microsoft.Agents.Builder.ChannelServiceAdapterBase.SendActivitiesAsync(ITurnContext turnContext, IActivity[] activities, CancellationToken cancellationToken) in D:\Agents-for-net\src\libraries\Builder\Microsoft.Agents.Builder\ChannelServiceAdapterBase.cs:line 85 at Microsoft.Agents.Builder.TurnContext.<>c__DisplayClass37_0.<g__SendActivitiesThroughAdapter|1>d.MoveNext() in D:\Agents-for-net\src\libraries\Builder\Microsoft.Agents.Builder\TurnContext.cs:line 281

Does a ReceiptCard show in Teams using JS? Or BF SDK? I suspect not even if the Channels doc indicates it does.

This is an awkward sample. Several cards don't work in Teams, and why I added more "Channels.Supports*" methods.

[tracyboehrer]

Will need to ping the Teams folks about ReceiptCard. Some other cards did that same Go back to the main window to see this content. response, but those were listed as not supported.

https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0#card-action-support-by-channel

Dropped support for AnimationCard on Teams since the doc indicates not supported.

[tracyboehrer]

@rido-min Update from branch. ReceiptCard will still be outstanding.