Vstupy pro modul Agent

Vaše API integrace mohou být také přístupné pomocí Agent modulu.

Pro povolení API integrací pro vašeho Agent musíte kromě ostatních konfiguračních záložek popsaných v předchozích kapitolách vyplnit záložku Vstupy pro Agent.

Definování API integrací pro Agent

Klíčové požadavky:

• 1️⃣ Zajistěte, aby integrace fungovala samostatně

• Vyplňte všechna potřebná data pro plné povolení integrace (viz předchozí kapitoly). Integrace musí fungovat sama o sobě — bez Agent.

• 2️⃣ Poskytněte čitelný popis

• Do pole Vstupy pro Agent -> Popis popište integraci jasně a přirozeně "lidskými slovy". Pokud je popis srozumitelný člověku, měl by být srozumitelný i pro Agent.

• 3️⃣ Definujte zdroj požadovaných vstupních $context parametrů

• 🅰️ Discussion

  • Při volání API endpointu jsou tyto $context parametry převzaty z existující diskuze (například z předchozích částí konverzace nebo z dat načtených na začátku relace). Toto jsou $context, které již můžete vidět pod 4 Jak najít diskuze (hovory, chaty, e-maily) a měly by existovat před použitím Agent v dialog flow.
  • Alternativně mohou být takové kontexty vytvořeny pomocí 1️⃣ Přidat/Upravit integrace.
  • Agent se na tyto kontexty nebude ptát, i když jsou vyžadovány pro integraci, ale aktuálně chybí. Tyto kontexty "krmíte" Agent — ten je jednoduše použije tak, jak jsou, bez čtení nebo ověřování jejich obsahu.

  • 🅱️ Agent

  • Očekáváte, že Agent sám shromáždí požadované informace před voláním API endpointu.

  • Agent zkontroluje a požádá uživatele o tyto kontexty, pokud jsou vyžadovány pro pokračování dialogu.

  • Pokud požadované kontexty již v diskuzi existují, Agent je může přečíst a použít — ale nezapomeňte v promptu specifikovat, které kontexty by Agent měl hledat.

  • Pokud požadované kontexty ještě neexistují, Agent může přímo požádat uživatele, aby je poskytl.

  • Příklad použití: Uživatel zmíní číslo objednávky na začátku konverzace, před použitím modulu Agent. Později, když Agent začne a potřebuje zavolat integraci pro získání detailů objednávky:

    • Použije existující kontext $order_number, pokud je již k dispozici, nebo
    • Zeptá se uživatele na číslo objednávky, pokud takový kontext neexistuje.

💡

• Agent nemá přístup ke všem vašim kontextům ve výchozím nastavení. Pokud potřebujete, aby Agent použil konkrétní kontext, musíte mu to explicitně říct.
• Agent nemůže "vidět" hodnoty kontextů, jejichž vstupní zdroj je nastaven na Discussion — pouze je používá bez čtení hodnot.

• Naopak Agent může vidět hodnotu, pokud mu necháte shromáždit a vyplnit kontext výběrem vstupního zdroje Agent. Tyto kontexty budou zahrnuty a zpracovány jako součást promptu před voláním integrace.

• ❗Nikdy nenechte Agent jednat jako zdroj pro vaše API klíče nebo přístupové tokeny nastavením jejich zdroje na Agent — místo toho je poskytněte bezpečně v kódu pre-process, nebo je vygenerujte jinde v dialog flow odděleně od Agent a nastavte jejich zdroj na Discussion.

Viz také 🤖 Agent Module pro více informací o API integracích pro Agent.