3️⃣ Vstupy pro modul Agenta | Daktela Documentation

Vaše integrace API mohou být také přístupné prostřednictvím https://coworkersai.atlassian.net/wiki/spaces/KB/pages/203685889/Agent+Module?atlOrigin=eyJpIjoiYjMxNjA0MDU3YmY1NGZkZmJkMjVjODk3NTc0YzdlYWUiLCJwIjoiYyJ9.

Chcete-li povolit integrace API pro svého agenta, musíte vyplnit záložku Vstupy pro Agenta kromě ostatních konfiguračních záložek popsaných v předchozích kapitolách.

⬆️ Agent by měl shromažďovat a používat informace `$latitude` a `$longitude` pro tuto integraci.

Definice integrací API pro Agenta

Klíčové požadavky:

1️⃣ Ujistěte se, že integrace je funkční sama o sobě
- Vyplňte všechna potřebná data pro plné aktivování integrace (viz předchozí kapitoly). Integrace musí být funkční sama o sobě – bez Agenta.
2️⃣ Poskytněte čitelný popis pro člověka
- V poli Inputs for Agent -> Description popište integraci jasně a přirozeně "lidsky řečené”. Pokud je popis srozumitelný člověku, měl by být také srozumitelný Agentovi.
3️⃣ Definujte zdroj požadovaného vstupu $context parametrů
- 🅰️ Diskuse
  - Při volání API endpointu jsou tyto $context parametry převzaty z existující diskuse (například z předchozích částí konverzace nebo z načítaných dat na začátku sezení). Jedná se o $contexts, které již vidíte pod Podrobnosti diskuse, a ty by měly existovat před použitím Agenta v dialogovém toku.
  - Alternativně mohou být tyto kontexty vytvořeny kódem pre-processu.
  - Agent nebude ptát na tyto kontexty, i když jsou nezbytné pro integraci, ale aktuálně chybí. Tyto kontexty "krmíte" Agentovi – jednoduše je použije tak, jak jsou, bez čtení nebo ověřování jejich obsahu.
- 🅱️ Agent
  - Očekáváte, že sám Agent shromáždí požadované informace před voláním API endpointu.
  - Agent zkontroluje a požádá uživatele o kontexty, pokud jsou nezbytné pro pokračování dialogu.
    - Pokud v diskusi již existují požadované kontexty, Agent je může přečíst a použít – ale nezapomeňte v promptu specifikovat, které kontexty by měl Agent prohledat.
    - Pokud požadované kontexty dosud neexistují, může je Agent požádat uživatele přímo.
    - Příklad použití: Uživatel zmíní číslo objednávky na začátku konverzace, před použitím modulu Agenta. Později, když Agent začne a potřebuje volat integraci pro získání podrobností o objednávce, bude:
      - Použije existující kontext $order_number, pokud je již dostupný, nebo
      - Požádá uživatele o čí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 výslovně uvést.
Agent nemůže „vidět” hodnoty kontextů, jejichž zdroj vstupu je nastaven na Diskuse – pouze je používá bez čtení hodnot.
Agent naopak může vidět hodnoty, pokud mu umožníte sbírat a vyplňovat kontext výběrem zdroje vstupu Agent. Tyto kontexty budou zahrnuty a zpracovány jako součást promptu před voláním integrace.
- ❗Nikdy nenechávejte Agenta jednat jako zdroj vašich API klíčů nebo přístupových tokenů nastavením jejich zdroje na Agent – místo toho je bezpečně poskytněte v kódu pre-processu nebo je generujte jinde v dialogovém toku odděleně od Agenta a nastavte jejich zdroj na Diskuse.

Také si přečtěte 🤖 Modul pro agenta | 🤖 Tools and API Integrations, kde naleznete více informací o API integracích pro Agenta.