Domain 1 of 3 · Chapter 21 of 22

Configure adaptive cards

Unlock the complete study guide + 1,040 practice questions across 16 full exams.

Bundled into the existing Designing and Building Integrated AI Agent Solutions in Copilot Studio premium course — no separate purchase.

14-day money-back guarantee — no questions asked.

Included in this chapter:

  • What a card is, and who renders it
  • Choosing the node: informational or interactive
  • Authoring the payload: designer, JSON, Power Fx
  • From input ids to topic variables
  • While the card waits: invalid responses and interruptions
  • Consecutive cards and stale submissions
  • Schema versions and the hosts that cap them
  • Test where the card will actually run
  • Exam patterns and the answers that look right

Where an Adaptive Card can sit in a topic

DecisionCard on a Message nodeCard on a Question nodeAdaptive Card node (Ask with Adaptive Card)
What the card is forShowing information; the conversation continues automaticallyShowing information alongside the question the node asksAn interactive form the user is expected to submit
Submit buttonNot requiredNot requiredAt least one, or the card belongs on a Message node
Where the user's input landsNothing is captured from the cardIn the Question node's own Save user response as variable, from the question, not from the cardIn card output variables, one per input element id
Invalid-response and interruption settingsNone on the cardThe Question node's own reprompt and topic-switching propertiesHow many reprompts, Retry prompt, and Allow switching to another topic
More than one card in the nodeCarousel (default) or ListCarousel (default) or ListOne card
Making the content dynamicReference topic variables from the card's propertiesReference topic variables from the card's propertiesAlso offers Formula mode, which converts the JSON payload to a Power Fx formula and cannot be converted back

Decision tree

Must values come back?judge the topic step, not the layoutnoyesCard on a Message or Question nodeinformational, no submit button neededCarousel or List when the node holds severalAny host capped at 1.5?Teams, live chat widget, Copilot ChatyesnoAdaptive Card node at version 1.5at least one submit buttonone payload for Teams, live chat and webuse Action.SubmitButtons need Action.Execute?a separate axis from the versionyesnoAction.Execute is not availableBot Framework Web Chat supports 1.6but does not support Action.Executefall back to Action.SubmitAdaptive Card node up to version 1.6web channel only in the target setthe canvas will not preview a 1.6 cardthe test chat will
Cheat sheet

Cheat sheet

  • Use Ask with Adaptive Card when the topic must collect a card submission
  • Include at least one submit action in an interactive card
  • Correct generated card output variables with Edit Schema
  • Configure invalid-response reprompt and topic interruption behavior
  • Target the lowest Adaptive Card schema supported by required hosts
  • Give repeated card submit actions unique identifiers
  • Test cards on each published host, not only test chat

Unlock with Premium — includes all practice exams and the complete study guide.

References

  1. Adaptive Cards overview - Microsoft Copilot Studio
  2. Design informational Adaptive Cards for agent responses
  3. Ask with Adaptive Cards - Microsoft Copilot Studio
  4. Send a message - Microsoft Copilot Studio
  5. Collect user input with interactive Adaptive Cards
  6. Adaptive Cards for agent design
  7. Apply channel-specific considerations for Adaptive Cards
  8. Key concepts - Publish and deploy your agent - Microsoft Copilot Studio