Akce

Načtení aktuálních dat během hovoru

Nechte agenta zeptat se vašeho systému na objednávku, stav skladu nebo účet, zatímco volající čeká.

S API nástroj RAG se agent uprostřed rozhovoru zeptá vašeho systému na aktuální data — stav objednávky, zásobu produktu, údaje o účtu — a odpoví podle nich. Kdy nástroj použít, agent rozhodne podle vašeho popisu.

Nastavení

1. Přidejte nástroj

   Otevřete agenta → Akce → Přidat nástroj → CRM a služby → API nástroj RAG.

2. Popište ho a nasměrujte na svůj endpoint

   Pole	Co zadat
   Název	např. Vyhledání objednávky
   Obecná podmínka	Kdy ho použít, např. zákazník se ptá na stav objednávky
   URL API endpointu	např. https://api.yourshop.com/orders/{order_id} — {placeholders} se vyplní hodnotami, které agent sesbírá
   HTTP metoda	GET, POST, PUT, DELETE nebo PATCH
   Zpráva při spuštění	Co agent řekne, zatímco čeká, např. Okamžik, ověřuji vaši objednávku
   Timeout požadavku (ms)	Jak dlouho čekat na odpověď; výchozí 5000
   Hlavičky, Query parametry	Volitelné pevné hodnoty, např. váš API klíč

3. Určete, co musí agent zjistit

   Schéma parametrů (JSON) uvádí hodnoty, které agent zjistí od volajícího a odešle — viz níže. Pokud povinná hodnota chybí, agent se na ni nejdřív zeptá.

tip

Vždy vyplňte Zpráva při spuštění — ticho během požadavku zní jako přerušený hovor.

Schéma parametrů

Není to samotné tělo požadavku, ale JSON Schema hodnot, které se mají zjistit. Kam se dostanou:

Případ	Kam hodnota jde
URL obsahuje {name}	Do URL
GET, DELETE	Zbytek jako ?key=value
POST, PUT, PATCH	Zbytek jako tělo JSON

Vyhledání objednávky podle čísla:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Číslo objednávky, na kterou se zákazník ptá, obvykle 6 až 10 číslic. Pokud ho neuvede, zeptej se."
    }
  },
  "required": ["order_id"]
}

Rezervace s několika hodnotami:

{
  "type": "object",
  "properties": {
    "product_id": { "type": "string", "description": "ID produktu z předchozího vyhledávání." },
    "quantity": { "type": "integer", "minimum": 1, "maximum": 10, "description": "Kolik kusů. Výchozí 1." },
    "delivery_method": { "type": "string", "enum": ["pickup", "home_delivery", "locker"], "description": "Jak chce zákazník zboží převzít." },
    "customer_email": { "type": "string", "format": "email", "description": "E-mail pro potvrzení. Pokud ho neuvede, zeptej se." }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Statický endpoint, např. otevírací doba: { "type": "object", "properties": {} }.

Dobrá schémata pro hlas:

• Držte je ploché: 3–5 hodnot.
• Ke každé hodnotě napište description s příklady — agenta vedou nejlépe.
• Pro pevné volby použijte enum: agent převede „tu modrou“ na blue.
• Hodnotu označte jako required jen tehdy, když bez ní požadavek nemůže fungovat.
• Používejte názvy ve snake_case, které odpovídají {placeholders} v URL.

Příklady použití

• Stav objednávky — „Kde je moje objednávka 482913?“
• Dostupnost — ověření zásob nebo volného stolu ve vašem vlastním systému.
• Dotazy k účtu — zůstatek, konec smlouvy, otevřené tikety.

Časté problémy

Problém	Co zkontrolovat
Agent nástroj nikdy nepoužije	Ať Obecná podmínka pojmenuje konkrétní požadavek
Váš endpoint dostává prázdné hodnoty	Názvy ve schématu musí přesně odpovídat {placeholders}
Agent řekne, že to nemohl ověřit	Váš endpoint odpovídal déle než timeout, nebo vrátil chybu

Související

• Znát volajícího ještě před začátkem hovoru — data před pozdravem
• MCP servery — mnoho nástrojů z jednoho serveru