← Všechny články

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:

  1. Vstupní pole se vyprázdní a zadaná data z obrazovky zmizí.
  2. Karta zůstane interaktivní.
  3. 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álPostupMechanismus
Webové portály (WebChat)Attachment middlewareDeaktivace karty na straně klienta
Microsoft TeamsUniversal ActionsNahrazení karty na straně serveru
Microsoft 365 CopilotBez 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.Execute v 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.Execute a hodnotou verb. 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.Execute na 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.