Open in
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
- Definujete nástroje pomocou schémy (aké argumenty nástroj prijíma)
- 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 - Počas hovoru sa AI na základe konverzácie rozhodne, kedy použiť nástroj
- ThunderPhone zavolá váš endpoint s argumentmi nástroja
- Odpoveď vášho API sa odošle späť AI na pokračovanie v konverzácii
| Funkcia | Kde sa spúšťa | Nastavenie |
|---|---|---|
| Vstavané nástroje | ThunderPhone | Pokyny 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ástroje | Vaše HTTP API | Definujte endpoint a schému alebo prijímajte volania funkcií cez webhook |
| Servery MCP | Vzdialený server MCP | Pridajte 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
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
timeout | číslo | Nie | Maximálny čas vykonávania v sekundách (predvolené: 20, maximum: 180 alebo 600 s wait_mode: "hold") |
wait_mode | reťazec | Nie | Č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_start | objekt | Nie | Ná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
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | reťazec | Áno | Identifiká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 |
description | reťazec | Áno | Vysvetľuje AI, kedy má tento nástroj použiť |
parameters | objekt | Áno | Schéma JSON pre argumenty nástroja |
Konfigurácia endpointu
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
url | reťazec | Áno | URL endpointu vášho API |
method | reťazec | Nie | Metóda HTTP (predvolené: POST) |
headers | objekt | Nie | Vlastné 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 endpoint | Nástroj bez endpoint | |
|---|---|---|
| Kam smeruje požiadavka | Priamo na endpoint.url | Na staršiu URL webhooku vašej organizácie |
| Telo | Vybraný formát požiadavky (predvolene samotné argumenty) | Obálka telephony.tool / web.tool |
| Hlavičky | Vaše endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, a pri telefonických hovoroch aj čísla hovoru | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| Podpisový kľúč | Tajný kľúč webhooku organizácie | Tajný 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-keyVlastné 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 webhookovX-ThunderPhone-Signature— starší HMAC-SHA256 presných bajtov tela požiadavky s rovnakým kľúčom, stále odosielaný pre existujúce overovačeX-ThunderPhone-Call-ID— ID aktuálneho hovoruX-ThunderPhone-From-NumberaX-ThunderPhone-To-Number— čísla From a To hovoru vo formáte E.164. Majú rovnaký význam akofrom_numberato_numbervtelephony.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 čísloX-ThunderPhone-Call-Direction—inboundalebooutbound, 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čuje | Vetou 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 s | Vetou pri spustení nástroja, potom hudbu pri podržaní, kým nepríde výsledok |
Maximálny timeout | 180 s | 600 s |
| Čakajúce odpovede | Odovzdajú sa agentovi ako výsledok | Ná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-V2podpisuje č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, priGET/DELETEprá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:
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}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ý symbol | Hodnota |
|---|---|
{{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
Vyvolávajte akcie hovorov spravované platformou bez definovania koncového bodu.
Nástroje spravované platformou pre HubSpot, Salesforce, Kalendár Google, Tabuľky Google a Cal.com — bez potreby koncového bodu.
Pripojte server MCP a nechajte agenta volať jeho nástroje.
Opakovane použiteľné integrácie REST, ktoré môžete pripojiť k agentom.
Jeden pomocník na overovanie webhookov a volaní nástrojov.