ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Function Tools

Funkčné nástroje

Poskytnite svojim AI agentom funkčné nástroje, ktoré počas konverzácie volajú externé API — načítajú údaje o zákazníkoch, rezervujú termíny, aktualizujú záznamy — s typovanými parametrami.

Funkčné nástroje umožňujú vašim AI agentom počas telefonických hovorov volať externé API. Použite ich na vyhľadávanie údajov o zákazníkoch, kontrolu dostupnosti, rezervovanie termínov alebo vykonanie ľubovoľnej akcie, ktorú váš backend podporuje.

Ako to funguje

  1. Definujete nástroje pomocou schémy (aké argumenty nástroj prijíma)
  2. Poskytnete konfiguráciu endpoint (kam ThunderPhone volá vaše API) — alebo ju vynecháte, aby ste prijímali volania nástrojov na webhooku organizácie
  3. Počas hovoru sa AI na základe konverzácie rozhodne, kedy použiť nástroj
  4. ThunderPhone zavolá váš endpoint s argumentmi nástroja
  5. Odpoveď vášho API sa odošle späť AI na pokračovanie v konverzácii
FunkciaKde sa spúšťaNastavenie
Vstavané nástrojeThunderPhonePokyny v prompte; niektoré nástroje vyžadujú aj nastavenie agenta
Pripojenia aplikáciíThunderPhone a pripojený poskytovateľPripojte účet a priraďte schválené akcie
Pripojenia API a funkčné nástrojeVaše HTTP APIDefinujte endpoint a schému alebo prijímajte volania funkcií cez webhook
Servery MCPVzdialený server MCPPridajte server, zistite jeho nástroje a priraďte ho agentovi

Schéma nástroja

Každý nástroj má nasledujúcu štruktúru:

{
  "type": "function",
  "function": {
    "name": "search_appointments",
    "description": "Find available appointment slots for a given date",
    "parameters": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "Date in YYYY-MM-DD format"
        },
        "service": {
          "type": "string",
          "description": "Type of service (e.g., 'consultation', 'follow-up')"
        }
      },
      "required": ["date"]
    }
  },
  "endpoint": {
    "url": "https://api.example.com/appointments/search",
    "method": "POST",
    "headers": {
      "X-Api-Key": "your-api-key"
    }
  },
  "timeout": 120
}

Konfigurácia nástroja

PoleTypPovinnéPopis
timeoutčísloNieMaximálny čas vykonávania v sekundách (predvolené: 20, maximum: 180 alebo 600 s wait_mode: "hold")
wait_modereťazecNieČo volajúci počuje počas vykonávania nástroja: updates (predvolené), krátke hovorené aktualizácie; alebo hold, hudba počas čakania. Pozrite si Dlhé čakania: režim podržania a neskoršia odpoveď
call_startobjektNieNástroj sa automaticky spustí aj na začiatku každého telefonátu, pred pozdravom. Pozrite si Spustenie nástroja na začiatku hovoru

Definícia funkcie

PoleTypPovinnéPopis
namereťazecÁnoIdentifikátor nástroja, jedinečný medzi nástrojmi jedného hovoru. Rôzni agenti môžu mať vlastný nástroj s rovnakým názvom
descriptionreťazecÁnoVysvetľuje AI, kedy má tento nástroj použiť
parametersobjektÁnoSchéma JSON pre argumenty nástroja

Konfigurácia endpointu

PoleTypPovinnéPopis
urlreťazecÁnoURL endpointu vášho API
methodreťazecNieMetóda HTTP (predvolené: POST)
headersobjektNieVlastné hlavičky, ktoré sa majú zahrnúť

Dva spôsoby volania

Požiadavka, ktorú váš server prijme, závisí od toho, či nástroj obsahuje endpoint:

Nástroj s endpointNástroj bez endpoint
Kam smeruje požiadavkaPriamo na endpoint.urlNa staršiu URL webhooku vašej organizácie
TeloVybraný formát požiadavky (predvolene samotné argumenty)Obálka telephony.tool / web.tool
HlavičkyVaše endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, a pri telefonických hovoroch aj čísla hovoruContent-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature
Podpisový kľúčTajný kľúč webhooku organizácieTajný kľúč webhooku organizácie

Obe cesty sú blokujúce — AI počas vety čaká na výsledok. Predvolený časový limit je 20 s; ak chcete povoliť dlhšie vykonávanie, nastavte timeout nástroja na najvyššej úrovni, maximálne však na platformou stanovených 180 s. Obslužné rutiny udržiavajte rýchle. Pri čakaní na osobu alebo pomalú úlohu použite režim podržania. Kombinácia je možná: pri hovore, ktorého organizácia má URL webhooku, sa nástroje s endpoint volajú priamo a ostatné sa vrátia k webhooku.

Priame volania koncových bodov

Keď AI vyvolá nástroj, ktorý má endpoint, ThunderPhone odošle požiadavku na vašu URL adresu:

Hlavičky požiadavky

POST /appointments/search HTTP/1.1
Host: api.example.com
Content-Type: application/json
X-ThunderPhone-Signature-V2: t=1767225600,v1=5f2c...
X-ThunderPhone-Signature: abc123...
X-ThunderPhone-Call-ID: 987654321
X-ThunderPhone-From-Number: +14155550199
X-ThunderPhone-To-Number: +14155550100
X-ThunderPhone-Call-Direction: inbound
X-Api-Key: your-api-key

Vlastné hlavičky z vášho endpoint.headers sa vždy zahrnú doslovne spolu s týmito hlavičkami v mennom priestore ThunderPhone:

  • X-ThunderPhone-Signature-V2 — HMAC-SHA256 s časovou pečiatkou nad metódou, cestou, dopytom a telom, s kľúčom tajomstva webhooku vašej organizácie. Overte ho a odmietnite požiadavky staršie ako 5 minút; pozrite si Overenie podpisov webhookov
  • X-ThunderPhone-Signature — starší HMAC-SHA256 presných bajtov tela požiadavky s rovnakým kľúčom, stále odosielaný pre existujúce overovače
  • X-ThunderPhone-Call-ID — ID aktuálneho hovoru
  • X-ThunderPhone-From-Number a X-ThunderPhone-To-Number — čísla From a To hovoru vo formáte E.164. Majú rovnaký význam ako from_number a to_number v telephony.complete: pri odchádzajúcom hovore je From číslo vášho agenta a To je volaná osoba. Číslo sa vynechá, keď je ID volajúceho skryté alebo nejde o telefónne číslo
  • X-ThunderPhone-Call-Direction — inbound alebo outbound, aby ste vedeli určiť, ktoré číslo patrí zákazníkovi

Hlavičky s číslami hovoru sa odosielajú iba pri telefónnych hovoroch. Testy cez web, widget, v reálnom čase a Talk v prehliadači nemajú telefónne číslo a tieto hlavičky vynechávajú. Testovacie hovory z editora agenta a simulácie AI obsahujú číslo simulovaného volajúceho. Podpisy nezahŕňajú hlavičky: V2 podpisuje časovú pečiatku, metódu, cestu, dopyt a telo. Ak potrebujete mať čísla podpísané, načítajte ich namiesto toho z tela: formát požiadavky retell obsahuje všetky tri a vapi obsahuje číslo zákazníka.

Content-Type: application/json sa nastaví, pokiaľ ho váš endpoint.headers neprepíše — vlastný Content-Type má prednosť.

Formát požiadavky

Každé pripojenie API má nastavenie request_format. Keď má importovaný nástroj naďalej volať koncový bod vytvorený pre danú platformu, zvoľte vapi alebo retell. Nové aj existujúce pripojenia predvolene používajú standard.

Pre POST / PUT / PATCH ThunderPhone vybraný obal serializuje kanonicky (zoradené kľúče, kompaktné oddeľovače). Oba podpisy pokrývajú presne tieto bajty.

Standard

standard odosiela iba argumenty nástroja bez obalu. Toto je predvolené nastavenie a zachováva pôvodné telo požiadavky ThunderPhone bajt po bajte:

{"date":"2025-01-02","service":"consultation"}

Vapi

vapi odosiela serverovú správu tool-calls od Vapi vo formáte zdokumentovanom službou Vapi. call.id je ID hovoru ThunderPhone. Pri telefonických hovoroch je call.customer.number číslo druhej strany, rovnako ako v objekte hovoru Vapi: volajúci pri prichádzajúcom hovore, volaná osoba pri odchádzajúcom hovore. Neuvádza sa, ak je toto číslo skryté alebo ak nejde o telefónne číslo. id volania nástroja je jedinečné pre dané vyvolanie a opätovne sa používa na priradenie výsledku koncového bodu. Hovor sa zobrazí v zoznamoch toolCallList aj toolWithToolCallList, pričom function.arguments je objekt JSON:

{
  "message": {
    "type": "tool-calls",
    "timestamp": 1725000000123,
    "call": { "id": "987654321" },
    "toolCallList": [
      {
        "id": "call_00112233445566778899aabbccddeeff",
        "type": "function",
        "function": {
          "name": "search_appointments",
          "arguments": { "date": "2025-01-02", "service": "consultation" }
        }
      }
    ],
    "toolWithToolCallList": [
      {
        "type": "function",
        "function": { "name": "search_appointments" },
        "toolCall": {
          "id": "call_00112233445566778899aabbccddeeff",
          "type": "function",
          "function": {
            "name": "search_appointments",
            "arguments": { "date": "2025-01-02", "service": "consultation" }
          }
        }
      }
    ]
  }
}

Polia určené iba pre Vapi, ako napríklad assistant, artifact a celý objekt call, sa neodosielajú.

Vráťte obal odpovede Vapi so zodpovedajúcim ID volania nástroja:

{
  "results": [
    {
      "toolCallId": "call_00112233445566778899aabbccddeeff",
      "result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
    }
  ]
}

ThunderPhone poskytne AI rozbalený reťazec result. Z dôvodu kompatibility prijíma aj hodnotu JSON z koncových bodov, ktoré ju už vracajú. Hodnota error namiesto result sa AI vráti ako chyba nástroja. Ak koncový bod vráti chybný alebo nezhodný obal Vapi, ThunderPhone zaznamená varovanie a namiesto zlyhania hovoru použije štandardné spracovanie odpovede.

Retell

retell odosiela požiadavku dokumentovanú pre vlastnú funkciu Retell:

{
  "name": "search_appointments",
  "call": {
    "call_id": "987654321",
    "from_number": "+14155550199",
    "to_number": "+14155550100",
    "direction": "inbound"
  },
  "args": { "date": "2025-01-02", "service": "consultation" }
}

Pri telefonických hovoroch objekt call obsahuje call_id, from_number, to_number a direction (inbound alebo outbound), teda názvy polí, ktoré používa objekt telefonického hovoru Retell. Zodpovedajú hlavičkám s číslami hovoru a na rozdiel od hlavičiek sú zahrnuté v oboch podpisoch. Číslo, ktoré je skryté alebo nie je telefónnym číslom, sa vynechá. Pri testoch Talk na webe, vo widgete, v reálnom čase a v prehliadači obsahuje iba call_id. ThunderPhone nezahŕňa polia špecifické pre Retell, ktoré pri odoslaní nemôže spoľahlivo poskytnúť, napríklad agent_id, transcript, transcript_object, metadata alebo dynamické premenné. Retell prijíma ľubovoľné telo odpovede; ThunderPhone ho odovzdá pomocou štandardného spracovania odpovedí.

Pre GET / DELETE sa argumenty odosielajú ako parametre dopytu a telo je prázdne bez ohľadu na request_format. Podpis V2 pokrýva reťazec dopytu v odoslanom tvare; starší podpis sa vypočíta nad prázdnym bajtovým reťazcom. Pozrite si Overenie podpisov webhookov.

Odpoveď

Vráťte odpoveď JSON s výsledkom nástroja:

{
  "available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
  "timezone": "America/Los_Angeles"
}

Odpoveď sa naformátuje a poskytne AI, aby mohla pokračovať v konverzácii. Odpovede iné než JSON sa zabalia ako {"data": "<text>"}; časové limity a zlyhania pripojenia sa AI nahlásia ako chyby, takže sa agent môže ospravedlniť a pokračovať namiesto zaseknutia.

Odosielanie v režime webhooku

Nástroje bez endpoint sa odosielajú na staršiu webhookovú URL vašej organizácie ako podpísaná požiadavka telephony.tool (telefonické hovory) alebo web.tool (webové volania). Na rozdiel od notifikácií auditu, ktoré sa doručujú na koncové body webhookov po vykonaní, táto požiadavka je samotným vykonaním — vaša odpoveď HTTP je výsledkom nástroja.

{
  "type": "telephony.tool",
  "data": {
    "call_id": 987654321,
    "tool_name": "search_appointments",
    "arguments": { "date": "2026-04-21" },
    "from_number": "+14155550199",
    "to_number": "+15551234567"
  }
}

web.tool obsahuje origin_domain namiesto from_number / to_number. Odpovedzte s výsledkom nástroja vo formáte JSON — s rovnakým kontraktom odpovede ako pri priamych volaniach endpointu. Požiadavka je podpísaná webhookovým tajomstvom organizácie a obsahuje obe hlavičky podpisu, rovnako ako každý iný webhook.


Dlhé čakania: režim podržania a neskoršia odpoveď

Niektoré nástroje čakajú na človeka: manažéra schvaľujúceho zľavu alebo vlastníka odpovedajúceho na otázku v službe Slack. Pre tieto nástroje nastavte wait_mode na "hold".

wait_mode: "updates" (predvolené)wait_mode: "hold"
Čo volajúci počujeVetou pri spustení nástroja, potom krátku vetu „stále pracujem“ približne po 12 s a ďalšiu približne každých 15 sVetou pri spustení nástroja, potom hudbu pri podržaní, kým nepríde výsledok
Maximálny timeout180 s600 s
Čakajúce odpovedeOdovzdajú sa agentovi ako výsledokNástroj zostane otvorený, kým nedoručíte výsledok

V režime podržania agent pri spustení nástroja povie jednu vetu (vlastnými slovami alebo vetu pri spustení nástroja nastavenú pre agenta) a potom volajúci počuje hudbu pri podržaní. Hudba sa stíši predtým, než agent povie výsledok. Nástroj, ktorý odpovie do jednej alebo dvoch sekúnd, neprehrá žiadnu hudbu. Keď agent komunikuje s hlasovým menu alebo hlasovou schránkou, namiesto toho používa hovorené aktualizácie, pretože hudba by mohla byť vnímaná ako odpoveď. Platí to aj pre hovor, pri ktorom sa počas podržania zistí, že ide o menu alebo schránku: hudba sa zastaví a prevezmú to hovorené aktualizácie. Rovnako sa to stane pri hovore, pri ktorom sa hudba nedá prehrať.

Ak volajúci počas podržania hovorí, hudba pokračuje a agent zatiaľ neodpovedá. Počuje, čo volajúci povedal, a odpovie na to spolu s výsledkom. Zavesenie ukončí hovor aj otvorený nástroj.

Odpovedať neskôr

Vlastná odpoveď vášho endpointu musí stále prísť do 180 s. Ak chcete volajúceho podržať dlhšie, okamžite odpovedzte s čakajúcim výsledkom:

{ "status": "pending", "request_id": "ask-4471" }

request_id je ľubovoľný reťazec s dĺžkou až 200 znakov, ktorý identifikuje túto požiadavku na vašej strane. Volajúci zostane na linke, kým pre ňu nedoručíte výsledok pomocou POST /v1/calls/{call_id}/tool-results. Hodnota call_id je v hlavičke X-ThunderPhone-Call-ID požiadavky nástroja.

curl -X POST https://api.thunderphone.com/v1/calls/987654321/tool-results \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "ask-4471",
    "result": { "answer": "Yes, book Tuesday at 10." }
  }'

Agent prečíta result ako odpoveď nástroja, rovnako ako keby ho vrátil váš endpoint. Ak žiadny výsledok nepríde pred uplynutím timeout nástroja, počítaného od okamihu volania nástroja, agent dostane informáciu, že neprišla žiadna odpoveď, a ponúkne volajúcemu ďalšie kroky, napríklad zanechanie odkazu.

Výsledok môžete odoslať kedykoľvek, aj predtým, než vaša čakajúca odpoveď dorazí do ThunderPhone. Odpoveď 202 znamená, že ju hovor prijal: prijala ju otvorená požiadavka alebo požiadavka samotného nástroja stále prebieha a jeho čakajúca odpoveď si ju prevezme. Výsledok, ktorý si nikdy neprevezme žiadna požiadavka (váš endpoint potom pre daný request_id odpovedal niečím iným než čakajúcim stavom), sa zahodí.

Ak má pripojenie transformáciu odpovede (kód, ktorý prepíše odpoveď vášho endpointu predtým, než ju agent uvidí), transformácia sa spustí na vlastnej odpovedi vášho endpointu predtým, než ThunderPhone skontroluje čakajúcu odpoveď, preto musí v čakajúcej odpovedi zachovať status a request_id. Nespúšťa sa pri výsledku, ktorý odošlete neskôr: agent dostane tento výsledok v podobe, v akej ho odošlete.

Plne duplexný agent nemá hudbu pri podržaní ani oznamovacie vety, preto sa pri jeho hovoroch nástroj v režime podržania správa ako nástroj v režime updates: čakajúca odpoveď sa dostane k agentovi ako výsledok nástroja.

Čakajúca odpoveď z nástroja v režime updates nezostáva otvorená: agent ju dostane ako výsledok nástroja.

Overenie podpisu

Priame volania nástrojov sa podpisujú rovnako ako webhooky pomocou webhookového tajného kľúča vašej organizácie:

  • X-ThunderPhone-Signature-V2 podpisuje časovú pečiatku, metódu, cestu a odoslané parametre dopytu, ako aj presné bajty tela. Odmietnite požiadavky, ktorých časová pečiatka sa od času na vašich hodinách líši o viac ako 5 minút.
  • X-ThunderPhone-Signature (starší) podpisuje iba bajty tela, pri GET / DELETE prázdny reťazec bajtov. Stále sa odosiela bez zmien.

Pomocné funkcie SDK kontrolujú hlavičku V2 vrátane 5-minútového časového okna:

Python
import json
 
from fastapi import FastAPI, HTTPException, Request
from thunderphone import verify_signature
 
app = FastAPI()
 
@app.post("/appointments/search")
async def search_appointments(request: Request):
    body = await request.body()
    query = request.scope.get("query_string", b"").decode("latin-1")
    path = request.url.path + (f"?{query}" if query else "")
 
    if not verify_signature(
        request.headers.get("X-ThunderPhone-Signature-V2"),
        secret=WEBHOOK_SECRET,
        method=request.method,
        path=path,
        body=body,
    ):
        raise HTTPException(status_code=401)
 
    data = json.loads(body)
    date = data["date"]
 
    # Look up availability
    slots = await get_available_slots(date)
 
    return {"available_slots": slots}
Node.js
import express from "express";
import { verifySignature } from "@thunderphone/sdk";
 
app.post('/appointments/search', express.raw({type: 'application/json'}), (req, res) => {
  const ok = verifySignature({
    header: req.header('X-ThunderPhone-Signature-V2'),
    secret: WEBHOOK_SECRET,
    method: req.method,
    path: req.originalUrl,
    body: req.body,
  });
  if (!ok) return res.status(401).send('Invalid signature');
 
  const { date, service } = JSON.parse(req.body);
 
  // Look up availability
  const slots = getAvailableSlots(date, service);
 
  res.json({ available_slots: slots });
});

Úplné návody — podpisovaný reťazec, praktický príklad, kód bez SDK, prípad GET / DELETE a upozornenie na absenciu tajného kľúča — nájdete v časti Overenie podpisov webhookov.


Príklad: Kompletný proces rezervácie

Tu je súbor nástrojov pre kompletný systém rezervácie termínov:

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_appointments",
        "description": "Find available appointment slots",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "service": { "type": "string" }
          },
          "required": ["date"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/search",
        "method": "POST",
        "headers": { "X-Api-Key": "key" }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "book_appointment",
        "description": "Book an appointment at a specific time",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "time": { "type": "string", "description": "HH:MM format" },
            "customer_name": { "type": "string" },
            "customer_phone": { "type": "string" }
          },
          "required": ["date", "time", "customer_name"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/book",
        "method": "POST",
        "headers": { "X-Api-Key": "key" }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "cancel_appointment",
        "description": "Cancel an existing appointment",
        "parameters": {
          "type": "object",
          "properties": {
            "confirmation_number": { "type": "string" }
          },
          "required": ["confirmation_number"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/cancel",
        "method": "POST",
        "headers": { "X-Api-Key": "key" }
      }
    }
  ]
}

Spustenie nástroja na začiatku hovoru

Nástroj sa môže spustiť aj automaticky na začiatku každého telefonického hovoru, predtým, než agent povie prvé slovo, takže pozdrav môže využiť výsledok. Bežným prípadom je vyhľadanie v CRM podľa čísla volajúceho: „Vitajte späť, Arthi! Chcete svoju obvyklú objednávku?“

Na paneli otvorte pripojenie API a nastavte možnosť Kedy sa spúšťa na Na začiatku každého telefonického hovoru, potom vyplňte hodnotu, ktorú má každý parameter dostať. Prostredníctvom API nastavte parameter trigger integrácie na call_start a jej parameter call_start_arguments (Pripojenia API), alebo pridajte blok call_start do vloženého nástroja:

{
  "type": "function",
  "function": {
    "name": "get_contact_by_phone",
    "description": "Look up a customer by phone number.",
    "parameters": {
      "type": "object",
      "properties": {
        "business_id": {"type": "string"},
        "phone_number": {"type": "string"}
      },
      "required": ["business_id", "phone_number"]
    }
  },
  "endpoint": {"url": "https://crm.example.com/contacts/lookup"},
  "call_start": {
    "arguments": {
      "business_id": "a0a81c23",
      "phone_number": "{{caller_number}}"
    }
  }
}

Argumenty potrebujú hodnotu pre každý povinný parameter, pretože pri začatí hovoru ich nikto nevypĺňa. Hodnoty môžu byť reťazce, čísla alebo booleovské hodnoty. Ukladajú sa a vracajú ako obyčajný text a agent ich vidí, preto tajné údaje, ako sú kľúče API, uchovávajte v hlavičkách pripojenia, nie tu. Reťazce môžu používať tieto zástupné symboly:

Zástupný symbolHodnota
{{caller_number}}Druhá osoba v hovore vo formáte E.164, napr. +61402122887: volajúci pri prichádzajúcom hovore, volaná osoba pri odchádzajúcom hovore
{{caller_number_national}}Rovnaké číslo v národnom formáte danej krajiny bez medzier, napr. 0402122887
{{agent_number}}Vlastné číslo agenta

Správanie:

  • Požiadavka je rovnaká ako požiadavka odoslaná pri volaniach vlastného nástroja agenta (rovnaký endpoint, hlavičky, formát požiadavky a podpis).
  • Nástroj sa spustí pri začatí hovoru a beží počas prehrávania akéhokoľvek pripájacieho tónu, úvodného hlásenia alebo oznámenia o nahrávaní. Pozdrav naň od tohto momentu čaká približne maximálne 3 sekundy. Pomalší výsledok sa agentovi odovzdá hneď po doručení na zvyšok hovoru. Pri odchádzajúcom hovore sa spustí pri uskutočnení hovoru, takže beží pri každom pokuse vrátane tých, ktoré nikto neprijme.
  • Pri agentovi, kde volajúci hovorí ako prvý, neexistuje pozdrav, na ktorý by sa čakalo; agent dostane výsledok hneď po jeho doručení.
  • Výsledok sa agentovi poskytne ako kontext pre celý hovor. V príkaze agentovi povedzte, ako ho má použiť; inak sa nahlas neprečíta.
  • Ak nástroj zlyhá alebo vyprší jeho časový limit, agent volajúceho pozdraví ako zvyčajne a nič o tom nepovie.
  • Agent môže nástroj aj naďalej zavolať neskôr počas hovoru.
  • Spúšťa sa pri telefonických hovoroch vrátane testovacích hovorov z panela na váš telefón a pri simuláciách AI, ktoré odosielajú číslo simulovaného volajúceho na váš endpoint. Nespúšťa sa pri testoch Hovor v prehliadači ani v reláciách webového widgetu, ktoré nemajú číslo volajúceho, pri hovoroch so skrytým identifikátorom volajúceho ani pri agentoch s krokmi.
  • Agent spustí naraz maximálne tri nástroje pri začatí hovoru.

Výsledok uveďte v príkaze, aby agent vedel, ako ho použiť, napríklad: „Ak vyhľadanie pri začatí hovoru našlo volajúceho, pozdravte ho krstným menom.“


Osvedčené postupy

Píšte jasné popisy

Pole description pomáha AI pochopiť, kedy má nástroj použiť. Presne uveďte, čo robí a kedy je vhodné ho použiť.

Správne spracúvajte chyby

Vrátte chybové správy, ktorým AI rozumie: {"error": "No slots available for that date"} namiesto všeobecných chýb 500.

Udržiavajte odpovede stručné

Vráťte iba to, čo AI potrebuje na pokračovanie v konverzácii. Výsledok nástroja zostáva v konverzácii a pri každom ďalšom ťahu sa znovu načíta, takže rozsiahly výsledok zvyšuje náklady a predlžuje zvyšok hovoru. Výsledky dlhšie ako 100 000 znakov sa skrátia na náhľad, o ktorom AI vie, že je neúplný, a pri veľmi dlhom hovore môžu byť staršie výsledky odstránené (AI môže nástroj zavolať znova). Pridajte parameter, aby AI mohla vyhľadať jednu položku alebo kategóriu naraz, a rozsiahly referenčný obsah, napríklad ponuky alebo katalógy, umiestnite do databázy znalostí. Odoslať testovaciu požiadavku na ovládacom paneli zobrazuje veľkosť každého výsledku a upozorní, keď je veľký.

Polia označené ako povinné používajte uvážlivo

Polia označte ako required iba vtedy, keď je to skutočne potrebné. Pred volaním nástroja AI požiada používateľa o povinné informácie.


Súvisiace