Gebruik Adaptieve kaarten in Copilot Studio

Note

Dit artikel beschrijft functies die worden gebruikt in agenten of agentstromen die gebruikmaken van het standard harness.

Adaptieve kaarten beschrijven de inhoud van de gebruikersinterface in JSON. Een host-app, zoals Microsoft Teams, rendert de kaart in de eigen interface. Gebruik kaarten in agenten om gebruikersinput te verzamelen of informatie te tonen.

De host-app bepaalt welke kaartversies en functies worden ondersteund. Kies een schemaversie die werkt in elk kanaal waar je je agent publiceert.

Note

Copilot Studio ondersteunt de Adaptieve kaarten schemaversie 1.6 en eerder. De juiste schemaversie is echter afhankelijk van de beoogde host-app:

  • Het Bot Framework Webchat-onderdeel (het standaardpatroon voor websiteintegratie) ondersteunt versie 1.6, maar biedt geen ondersteuning voor Action.Execute
  • De live chatwidget (gebruikt voor Omnichannel for Customer Service) is beperkt tot versie 1.5
  • Teams is ook beperkt tot versie 1.5

Bovendien worden in Copilot Studio alleen versie 1.6-kaarten weergegeven in de testchat, niet op het canvas.

Meer informatie vindt u in AdaptiveCard.

Kies de node die bij jouw taak past:

Tip

Maak cards in de ingebouwde ontwerper zoals beschreven in Ask questions with Adaptieve kaarten, of hergebruik een card uit een ander onderwerp en pas deze aan voor je taak.

Lees meer over het schema en de voorbeelden bij Adaptieve kaarten.

Aanbevolen procedures voor interactieve kaarten

Wanneer je interactieve Adaptieve kaarten gebruikt (kaarten met Submit-knoppen), voeg dan gegevens toe die de kaart of actie in elke Submit-actie identificeren. Valideer die gegevens bij het verwerken van het antwoord, vooral wanneer eerdere kaarten zichtbaar blijven. Een vaste actie-identificator onderscheidt acties; het voorkomt op zichzelf geen dubbele inzendingen en het identificeert op zichzelf niet elke weergegeven instantie van een kaart.

Meer informatie over het gedrag van de knop Verzenden voor agents met opeenvolgende kaarten.