11. listopadu 2026
Jak deaktivovat Adaptive Cards po odeslání v agentech Copilot Studio
U agentů Copilot Studio můžete po odeslání formuláře kartu deaktivovat ve vlastním webovém portálu nebo ji v Teams nahradit potvrzením. V kanálu Microsoft 365 Copilot ale podle stavu popsaného k červenci 2026 není podporovaný ani jeden z těchto postupů.
Neoficiální české shrnutí a překlad článku Microsoftu. Web není oficiálním kanálem Microsoftu. Originál: Disabling Adaptive Cards After Submission in Copilot Studio Agents (Copilot Studio CAT Blog).
Dva ověřené postupy umožňují Adaptive Cards po odeslání deaktivovat nebo nahradit: první je určený vlastním webovým portálům s WebChat, druhý Microsoft Teams s využitím Universal Actions.
Nasadili jste agenta s formulářem v Adaptive Card. Uživatel jej vyplní, klikne na tlačítko pro odeslání a právě zadaná data zmizí. Karta dál vypadá jako běžný formulář, takže uživatel předpokládá, že odeslání selhalo. Vyplní ji znovu, odešle podruhé a tentokrát dostane chybu.
Ve skutečnosti se nic nepokazilo. Agent data přijal a správně zpracoval. Karta to jen uživateli nijak nepotvrdila. Při nasazení mezi tisíce zaměstnanců se taková drobnost může proměnit ve skutečný problém pro podporu.
Řešení existuje, ale záleží na tom, kde je Váš agent dostupný. Ve vlastním webovém portálu máte jiné možnosti než v Microsoft Teams. Tento článek popisuje oba postupy i omezení kanálu Microsoft 365 Copilot.
Proč k tomu dochází
Adaptive Cards ve výchozím stavu nemají zabudované chování „po odeslání deaktivovat“. Když uživatel kartu odešle:
- Vstupní pole se vyprázdní a zadaná data z obrazovky zmizí.
- Karta zůstane interaktivní.
- Druhé odeslání vyvolá chybu, protože konverzace už mezitím pokračovala dál.
Jde o chování platformy, nikoli o chybu v logice Vašeho agenta. Agent data přijal a zpracoval správně, uživatel to ale neví.
Dva postupy pro dva kanály
Volba řešení závisí na kanálu, ve kterém je agent dostupný:
| Kanál | Postup | Mechanismus |
|---|---|---|
| Webové portály (WebChat) | Attachment middleware | Deaktivace karty na straně klienta |
| Microsoft Teams | Universal Actions | Nahrazení karty na straně serveru |
| Microsoft 365 Copilot | Bez podporovaného náhradního řešení | Action.Execute se neuplatní |
Nejprve následují oba funkční postupy a poté možnosti pro kanál Microsoft 365 Copilot, kde nelze použít ani jeden z nich.
Postup 1: Vlastní webové portály (BotFramework-WebChat)
Tento postup funguje u agentů vložených do vlastních webových portálů nebo samoobslužných stránek pomocí sady SDK BotFramework-WebChat, kde máte pod kontrolou klientskou aplikaci.
Nevztahuje se na Employee Self-Service (ESS) agent pro Microsoft 365. Přes podobné zaměření běží ESS v kanálu Microsoft 365 Copilot. Klientskou aplikaci zde nehostujete, a middleware tedy nemáte kam zapojit. Tomuto kanálu se věnuje samostatná část níže.
Princip je jednoduchý: ve WebChat použijete attachment middleware, který ověří, zda karta patří k nejnovější zprávě bota. Pokud ne, tedy pokud už konverzace pokročila dál, vykreslí kartu jako deaktivovanou.
Základní logika
Middleware zachytává vykreslování Adaptive Cards a porovnává příslušnou aktivitu s poslední zprávou v úložišti stavu:
const attachmentMiddleware =
() =>
next =>
({ activity, attachment, ...others }) => {
const { activities } = store.getState();
const messageActivities = activities.filter(
activity => activity.type === 'message'
);
const recentBotMessage = messageActivities.pop() === activity;
switch (attachment.contentType) {
case 'application/vnd.microsoft.card.adaptive':
return (
<AdaptiveCardContent
actionPerformedClassName="card__action--performed"
content={attachment.content}
disabled={!recentBotMessage}
/>
);
default:
return next({ activity, attachment, ...others });
}
};
Klíčový je řádek disabled={!recentBotMessage}. Jakmile bot odešle novou zprávu, předchozí karta se deaktivuje. Vstupní pole budou jen pro čtení a tlačítka přestanou reagovat.
Vizuální potvrzení pomocí CSS
Aby bylo zřejmé, že uživatel tlačítko už použil, přidejte CSS třídu pro provedené akce:
#webchat .card__action--performed {
background-color: #0063b1 !important;
border-color: #0063b1 !important;
color: White !important;
}
Použité tlačítko získá sytě modrý vzhled, který uživateli vizuálně signalizuje dokončení akce.
Zapojení do WebChat
Při vykreslení WebChat předejte middleware jako parametr:
<ReactWebChat
attachmentMiddleware={attachmentMiddleware}
directLine={directLine}
store={store}
/>
Jde o řešení na straně klienta. Zabrání opakovanému odeslání přes uživatelské rozhraní, ale nevynucuje toto omezení na serveru. Pro většinu scénářů samoobslužných portálů to postačuje.
Kompletní funkční ukázka je k dispozici v repozitáři BotFramework-WebChat.
Postup 2: Microsoft Teams (Universal Actions)
V Teams nemůžete použít middleware pro WebChat, protože nemáte pod kontrolou klientskou aplikaci. Širší souvislosti návrhu agentů pro Teams popisuje článek o návrhových vzorech agentů pro Teams. Pro tento konkrétní problém slouží Universal Actions: model, který agentovi umožňuje reagovat na akci v kartě a vrátit novou kartu místo původní.
Jak Universal Actions fungují
sequenceDiagram
participant User
participant Teams
participant Agent as Copilot Studio Agent
User->>Teams: Fills out card, clicks Submit
Teams->>Agent: Sends invoke activity with verb
Agent->>Agent: Processes data, branches on verb
Agent->>Teams: Returns replacement card (HTTP 200)
Teams->>User: Original card replaced with confirmation
Místo Action.Submit karta používá Action.Execute s jedinečnou hodnotou verb, která identifikuje akci. Když uživatel klikne na tlačítko, Teams odešle do Copilot Studio aktivitu typu invoke. Téma ji zachytí, zpracuje data a vrátí novou kartu. Teams pak původní kartu nahradí novou.
Uživatel místo formuláře uvidí potvrzení. Nemusí přemýšlet, zda se odeslání podařilo, a nemůže formulář znovu odeslat.
Krok 1: Připravte kartu s Action.Execute
Začněte libovolnou Adaptive Card. Pokud nechcete JSON psát ručně, můžete nechat kartu vygenerovat pomocí Copilot a následně upravit její akce. Zásadní změna se týká tlačítek: nahraďte Action.Submit za Action.Execute a přidejte verb.
Akční tlačítka Adaptive Card s Action.Execute
{
"type": "ActionSet",
"actions": [
{
"type": "Action.Execute",
"title": "Submit",
"verb": "feedbackSubmitForm",
"data": { "actionType": "submitted" },
"fallback": "Action.Submit",
"style": "positive"
},
{
"type": "Action.Execute",
"title": "Skip",
"verb": "feedbackSkipForm",
"data": { "actionType": "skipped" },
"associatedInputs": "none",
"fallback": "Action.Submit"
}
]
}
Použijte "fallback": "Action.Submit", aby karta v klientech bez podpory Universal Actions přešla na náhradní způsob odeslání.
Krok 2: Odešlete kartu pomocí uzlu Send a message
V Copilot Studio použijte uzel Send a message s JSON definicí Adaptive Card. Nepoužívejte uzel Ask with Adaptive Card. Ten interně používá Action.Submit a nespustí tok invoke/refresh potřebný k nahrazení karty.
Krok 3: Vytvořte téma, které zachytí invoke
Vytvořte téma spouštěné aktivitou typu invoke. Příchozí data zpracujte pomocí následujícího schématu, abyste získali hodnotu verb:
kind: Record
properties:
action:
type:
kind: Record
properties:
data:
type:
kind: Record
properties:
userResponse: String
id: String
title: String
type: String
verb: String
trigger: String
Poté rozvětvěte zpracování podle resultData.action.verb:
feedbackSubmitForm→ zpracujte vstup a vraťte kartu s poděkováním.feedbackSkipForm→ vraťte potvrzení o přeskočení formuláře.
Krok 4: Vraťte náhradní kartu
Odpověď musí dodržet formát odpovědi Universal Action:
Odpověď Universal Action s náhradní kartou
{
"statusCode": 200,
"type": "application/vnd.microsoft.card.adaptive",
"value": {
"type": "AdaptiveCard",
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"version": "1.5",
"body": [
{
"type": "TextBlock",
"text": "Thank you for your feedback!",
"weight": "Bolder",
"size": "Medium",
"wrap": true
},
{
"type": "TextBlock",
"text": "Your response has been recorded.",
"wrap": true,
"isSubtle": true
}
]
}
}
Původní karta se nahradí. Neobsahuje už tlačítka ani vstupní pole, pouze jednoznačné potvrzení.
Testujte přímo v Teams, nikoli v testovacím panelu Copilot Studio. Tok invoke/refresh nemusí v testovacím panelu fungovat.
Kompletní řešení připravené k importu, které vytvořil Nghiem Doan, je dostupné v repozitáři CopilotStudioSamples.
A co kanál Microsoft 365 Copilot?
Oba předchozí postupy předpokládají, že buď ovládáte klientskou aplikaci (WebChat), nebo agent běží v Teams (Universal Actions). V kanálu Microsoft 365 Copilot neplatí ani jeden z těchto předpokladů. Toto omezení je stále důležitější, protože v něm přibývají agenti včetně Employee Self-Service (ESS) agent od Microsoftu.
Stav popsaný k červenci 2026 je následující:
- Middleware pro WebChat nelze použít. Klientskou aplikaci nehostujete, takže attachment middleware nemáte kam zapojit.
- Universal Actions se nespustí.
Action.Executev Adaptive Cards patří mezi nepodporované typy uzlů v kanálu Microsoft 365 Copilot. Tok invoke/refresh, který kartu nahrazuje, se proto vůbec nespustí.
Podle tohoto stavu neexistuje podporovaný způsob, jak v Microsoft 365 Copilot po odeslání kartu deaktivovat nebo nahradit. Praktickým řešením je přizpůsobit tomu návrh interakce: kde je to možné, používejte karty jen k předávání informací. Vstupy sbírejte pomocí uzlu Question nebo v běžné konverzaci namísto karty, která spoléhá na odesílání formuláře. Text na kartě formulujte tak, aby uživatel rozuměl tomu, že jeho odpověď byla přijata, i když po kliknutí nevidí změnu.
U ESS je záměna obzvlášť snadná. Zaměřením připomíná samoobslužný portál, takže se může zdát, že řešení pro WebChat bude fungovat i zde. ESS ale běží v kanálu Microsoft 365 Copilot, kde nelze využít tento zásah na straně klienta ani nahrazení karty dostupné v Teams. Problém vypadá stejně, technické možnosti jsou však jiné.
Hlavní závěry
- Adaptive Cards se po odeslání automaticky nedeaktivují. Toto chování musíte implementovat sami.
- Pro vlastní webové portály použijte attachment middleware ve WebChat, který karty deaktivuje na straně klienta. Jde o přímočaré řešení s jasným vizuálním výsledkem.
- Pro Microsoft Teams použijte Universal Actions s
Action.Executea hodnotouverb. Téma v Copilot Studio zachytí invoke, zpracuje data a vrátí náhradní kartu. - Oba postupy řeší stejný problém uživatelského prostředí, ale jiným mechanismem. Volbu určuje kanál, ve kterém agent běží.
- V kanálu Microsoft 365 Copilot, kde běží také ESS, podle popsaného stavu nefunguje ani jeden postup. Akce
Action.Executena kartách nejsou podporované, proto je nutné přizpůsobit návrh interakce tomu, co uživatel uvidí po odeslání. - Kvůli zpětné kompatibilitě do karet s Universal Actions vždy přidejte
"fallback": "Action.Submit".
Kvalitní uživatelské prostředí stojí na detailech
Adaptive Cards jsou jedním z nejlepších způsobů, jak v agentovi sbírat strukturované vstupy. Bez potvrzení ale uživatel jen odhaduje, zda se jeho data skutečně odeslala. Rozdíl mezi agentem, který působí rozbitě, a dotaženým řešením často spočívá v jediném okamžiku: co uživatel uvidí bezprostředně po kliknutí na tlačítko pro odeslání.
Pokud tento okamžik ošetříte na straně klienta ve WebChat nebo na straně serveru v Teams, odstraníte jednu z drobných frustrací, které postupně snižují důvěru v agenta, aniž by je uživatelé vůbec nahlásili jako chybu.
Před nasazením další karty proto sami klikněte na tlačítko pro odeslání a sledujte, co se stane. Pokud se z pohledu uživatele nestane nic, upravte chování podle možností daného kanálu.