Open in
Funkcijski alati
Omogućite svojim AI agentima funkcijske alate koji tijekom razgovora pozivaju vanjske API-je — dohvaćaju podatke o korisnicima, rezerviraju termine, ažuriraju zapise — s tipiziranim parametrima.
Funkcijski alati omogućuju vašim AI agentima pozivanje vanjskih API-ja tijekom telefonskih poziva. Upotrijebite ih za dohvaćanje podataka o korisnicima, provjeru dostupnosti, rezerviranje termina ili izvođenje bilo koje radnje koju vaš pozadinski sustav podržava.
Kako funkcionira
- Definirate alate sa shemom (koje argumente alat prihvaća)
- Navodite konfiguraciju
endpoint(gdje ThunderPhone poziva vaš API) — ili je izostavite kako biste pozive alata primali na webhooku svoje organizacije - Tijekom poziva AI odlučuje kada upotrijebiti alat na temelju razgovora
- ThunderPhone poziva vašu krajnju točku s argumentima alata
- Odgovor vašeg API-ja vraća se AI-ju radi nastavka razgovora
| Mogućnost | Gdje se izvršava | Postavljanje |
|---|---|---|
| Ugrađeni alati | ThunderPhone | Upute u promptu; neki alati zahtijevaju i postavku agenta |
| Povezivanja aplikacija | ThunderPhone i povezani pružatelj usluge | Povežite račun i priložite odobrene radnje |
| API povezivanja i funkcijski alati | Vaš HTTP API | Definirajte krajnju točku i shemu ili primajte pozive funkcija putem webhooka |
| MCP poslužitelji | Udaljeni MCP poslužitelj | Dodajte poslužitelj, otkrijte njegove alate i priložite ga agentu |
Shema alata
Svaki alat slijedi ovu strukturu:
{
"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
}Konfiguracija alata
| Polje | Vrsta | Obavezno | Opis |
|---|---|---|---|
timeout | broj | Ne | Maksimalno vrijeme izvršavanja u sekundama (zadano: 20, najviše: 180 ili 600 uz wait_mode: "hold") |
wait_mode | niz znakova | Ne | Što pozivatelj čuje dok se alat izvršava: updates (zadano), kratka govorna ažuriranja; ili hold, glazbu na čekanju. Pogledajte Duga čekanja: način rada na čekanju i kasniji odgovor |
call_start | objekt | Ne | Također automatski pokrenite alat na početku svakog telefonskog poziva, prije pozdrava. Pogledajte Pokrenite alat na početku poziva |
Definicija funkcije
| Polje | Vrsta | Obavezno | Opis |
|---|---|---|---|
name | niz znakova | Da | Identifikator alata, jedinstven među alatima jednog poziva. Različiti agenti mogu imati vlastiti alat s istim nazivom |
description | niz znakova | Da | Objašnjava AI-ju kada koristiti ovaj alat |
parameters | objekt | Da | JSON shema za argumente alata |
Konfiguracija krajnje točke
| Polje | Vrsta | Obavezno | Opis |
|---|---|---|---|
url | niz znakova | Da | URL krajnje točke vašeg API-ja |
method | niz znakova | Ne | HTTP metoda (zadano: POST) |
headers | objekt | Ne | Prilagođena zaglavlja koja treba uključiti |
Dva načina pozivanja
Zahtjev koji vaš poslužitelj primi ovisi o tome ima li alat
endpoint:
Alat s endpoint | Alat bez endpoint | |
|---|---|---|
| Odredište zahtjeva | Izravno na endpoint.url | Zastarjeli URL webhooka vaše organizacije |
| Tijelo | Odabrani format zahtjeva (prema zadanim postavkama samo argumenti) | Omotnica telephony.tool / web.tool |
| Zaglavlja | Vaša endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, kao i brojevi poziva pri telefonskim pozivima | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| Ključ za potpisivanje | Tajna webhooka organizacije | Tajna webhooka organizacije |
Oba su puta blokirajuća — AI usred rečenice čeka rezultat. Zadano vrijeme isteka je 20 s; postavite timeout na najvišoj razini alata kako biste omogućili dulje izvršavanje, do najvećih 180 s koje platforma dopušta. Održavajte rukovatelje brzim. Za čekanje osobe ili sporog zadatka koristite način čekanja. Kombinacija je u redu: u pozivu čija organizacija ima URL webhooka alati s endpoint pozivaju se izravno, a ostali se vraćaju na webhook.
Izravni pozivi krajnjih točaka
Kada AI pozove alat koji ima endpoint, ThunderPhone šalje
zahtjev na Vaš URL:
Zaglavlja zahtjeva
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-keyPrilagođena zaglavlja iz vašeg endpoint.headers uvijek se uključuju
doslovno, uz ova zaglavlja u imenskom prostoru ThunderPhone:
X-ThunderPhone-Signature-V2— HMAC-SHA256 s vremenskom oznakom nad metodom, putanjom, upitom i tijelom, s ključem koji je vaša tajna webhooka organizacije. Provjerite ovaj potpis i odbacite zahtjeve starije od 5 minuta; pogledajte Provjera potpisa webhookaX-ThunderPhone-Signature— naslijeđeni HMAC-SHA256 točnih bajtova tijela zahtjeva, s istim ključem, i dalje se šalje za postojeće provjereX-ThunderPhone-Call-ID— Trenutačni ID pozivaX-ThunderPhone-From-NumberiX-ThunderPhone-To-Number— brojevi From i To poziva u formatu E.164. Znače isto što ifrom_numberito_numberutelephony.complete: pri odlaznom pozivu From je broj vašeg agenta, a To je broj pozvane osobe. Broj se izostavlja kada je ID pozivatelja skriven ili nije telefonski brojX-ThunderPhone-Call-Direction—inboundilioutbound, tako da možete utvrditi koji je broj korisnikov
Zaglavlja s brojevima poziva šalju se samo pri telefonskim pozivima. Web,
widget, realtime i Talk testovi u pregledniku nemaju telefonski broj pa ih
izostavljaju. Testni pozivi iz uređivača agenta i AI simulacije sadrže broj
simuliranog pozivatelja. Potpisi ne obuhvaćaju zaglavlja: V2 potpisuje
vremensku oznaku, metodu, putanju, upit i tijelo. Ako trebate potpisane
brojeve, umjesto toga ih pročitajte iz tijela: format zahtjeva retell
sadrži sva tri, a vapi sadrži broj korisnika.
Content-Type: application/json postavlja se osim ako ga Vaš endpoint.headers
ne nadjača — prilagođeni Content-Type ima prednost.
Format zahtjeva
Svaka API veza ima postavku request_format. Odaberite vapi ili
retell kada uvezeni alat treba nastaviti pozivati krajnju točku izrađenu za
tu platformu. Nove i postojeće veze zadano koriste standard.
Za POST / PUT / PATCH, ThunderPhone kanonski serijalizira odabranu
omotnicu (sortirani ključevi, sažeti razdjelnici). Oba potpisa obuhvaćaju
točno te bajtove.
Standard
standard šalje samo argumente alata, bez omotača. Ovo je zadana opcija i čuva izvorno tijelo zahtjeva ThunderPhonea bajt po bajt:
{"date":"2025-01-02","service":"consultation"}Vapi
vapi šalje Vapi-jevu poslužiteljsku poruku tool-calls
u obliku koji Vapi dokumentira. call.id je ID ThunderPhone poziva.
U telefonskim pozivima call.customer.number je broj druge strane, kao u
Vapi-jevu objektu poziva: pozivatelja za dolazni poziv, odnosno osobe koja se poziva
za odlazni poziv. Izostavlja se kada je taj broj skriven ili nije telefonski
broj. id poziva alata jedinstven je za pozivanje i ponovno se koristi za
podudaranje s rezultatom krajnje točke. Poziv se pojavljuje i u toolCallList i u
toolWithToolCallList, pri čemu je function.arguments JSON objekt:
{
"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" }
}
}
}
]
}
}Polja samo za Vapi, kao što su assistant, artifact i cijeli objekt call,
ne šalju se.
Vratite Vapi-jevu omotnicu odgovora s odgovarajućim ID-jem poziva alata:
{
"results": [
{
"toolCallId": "call_00112233445566778899aabbccddeeff",
"result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
}
]
}ThunderPhone AI-ju daje raspakiranu vrijednost niza result. Prihvaća i
JSON vrijednost radi kompatibilnosti s krajnjim točkama koje je već vraćaju.
error umjesto result vraća se AI-ju kao pogreška alata. Ako krajnja točka
vrati neispravnu ili nepodudarajuću Vapi omotnicu, ThunderPhone bilježi
upozorenje i vraća se na standardnu obradu odgovora umjesto da prekine poziv.
Retell
retell šalje zahtjev dokumentiran za prilagođenu funkciju
Retell:
{
"name": "search_appointments",
"call": {
"call_id": "987654321",
"from_number": "+14155550199",
"to_number": "+14155550100",
"direction": "inbound"
},
"args": { "date": "2025-01-02", "service": "consultation" }
}U telefonskim pozivima objekt call sadrži call_id, from_number,
to_number i direction (inbound ili outbound), nazive polja koje
upotrebljava Retellov objekt telefonskog poziva. Oni odgovaraju zaglavljima
broja poziva, a za razliku od zaglavlja obuhvaćeni su obama potpisima. Broj
koji je skriven ili nije telefonski broj izostavlja se. U testovima Talk na
webu, u widgetu, u stvarnom vremenu i pregledniku sadrži samo call_id.
ThunderPhone ne uključuje polja specifična za Retell koja pri slanju ne može
pouzdano pružiti, kao što su agent_id, transcript, transcript_object,
metadata ili dinamičke varijable. Retell prihvaća bilo koje tijelo odgovora;
ThunderPhone ga prosljeđuje uz standardnu obradu odgovora.
Za GET / DELETE, argumenti se šalju kao parametri upita
i tijelo je prazno neovisno o request_format. Potpis V2 obuhvaća niz upita
onako kako je poslan; naslijeđeni potpis izračunava se nad praznim nizom
bajtova. Pogledajte
Provjera potpisa webhooka.
Odgovor
Vratite JSON odgovor s rezultatom alata:
{
"available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
"timezone": "America/Los_Angeles"
}Odgovor se formatira i dostavlja AI-ju kako bi nastavio
razgovor. Odgovori koji nisu JSON omataju se kao {"data": "<text>"};
vremenska ograničenja i neuspjele veze prijavljuju se AI-ju kao pogreške, pa se
agent može ispričati i nastaviti umjesto da zastane.
Slanje u načinu webhooka
Alati bez endpoint šalju se na URL naslijeđenog webhooka Vaše organizacije
kao potpisani zahtjev telephony.tool (telefonski pozivi) ili web.tool
(web-pozivi). Za razliku od obavijesti o reviziji
koje se dostavljaju na krajnje točke webhooka nakon izvršavanja, ovaj zahtjev jest
izvršavanje — Vaš HTTP odgovor rezultat je alata.
{
"type": "telephony.tool",
"data": {
"call_id": 987654321,
"tool_name": "search_appointments",
"arguments": { "date": "2026-04-21" },
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}web.tool sadrži origin_domain umjesto from_number /
to_number. Odgovorite rezultatom alata u JSON formatu — uz isti ugovor odgovora
kao i za izravne pozive krajnje točke. Zahtjev je potpisan tajnom webhooka organizacije,
s oba zaglavlja potpisa, kao i svaki drugi webhook.
Duga čekanja: način čekanja i kasniji odgovor
Neki alati čekaju osobu: voditelja koji odobrava popust, vlasnika
koji odgovara na pitanje u Slacku. Za te alate postavite wait_mode na "hold".
wait_mode: "updates" (zadano) | wait_mode: "hold" | |
|---|---|---|
| Što pozivatelj čuje | Početnu poruku alata, zatim kratku poruku „još radim” nakon otprilike 12 s i drugu otprilike svakih 15 s | Početnu poruku alata, zatim glazbu na čekanju dok rezultat ne stigne |
Maksimalni timeout | 180 s | 600 s |
| Odgovori na čekanju | Prosljeđuju se agentu kao rezultat | Alat ostaje otvoren dok ne dostavite rezultat |
U načinu čekanja agent izgovori jednu rečenicu pri pokretanju alata (vlastitim riječima ili početnu poruku alata postavljenu na agentu), a zatim pozivatelj čuje glazbu na čekanju. Glazba postupno utihne prije nego što agent izgovori rezultat. Alat koji odgovori unutar jedne ili dvije sekunde uopće ne pokreće glazbu. Kada agent razgovara s telefonskim izbornikom ili govornom poštom, umjesto toga koristi glasovne obavijesti jer bi se glazba mogla čuti kao odgovor. To uključuje poziv za koji se tijekom čekanja utvrdi da je izbornik ili govorna pošta: glazba se zaustavlja, a glasovne obavijesti preuzimaju. Isto vrijedi i za poziv na kojem se glazba ne može reproducirati.
Ako pozivatelj govori tijekom čekanja, glazba nastavlja svirati, a agent još ne odgovara. Čuje što je pozivatelj rekao i odgovara na to zajedno s rezultatom. Prekid poziva završava poziv i otvoreni alat.
Odgovorite kasnije
Vlastiti odgovor vaše krajnje točke i dalje mora stići unutar 180 s. Kako biste pozivatelja zadržali dulje, odmah odgovorite rezultatom na čekanju:
{ "status": "pending", "request_id": "ask-4471" }request_id je bilo koji niz do 200 znakova koji na vašoj strani identificira ovaj
zahtjev. Pozivatelj ostaje na čekanju dok mu ne dostavite
rezultat putem
POST /v1/calls/{call_id}/tool-results.
call_id je zaglavlje X-ThunderPhone-Call-ID zahtjeva alata.
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 čita result kao odgovor alata, jednako kao da ga je vratila vaša
krajnja točka. Ako rezultat ne stigne prije isteka timeout vrijednosti
alata, računajući od trenutka kada je alat pozvan, agentu se javlja da odgovor
nije stigao te pozivatelju nudi sljedeće korake, primjerice ostavljanje
poruke.
Rezultat možete poslati čim želite, čak i prije nego što vaš odgovor na čekanju
stigne do ThunderPhonea. Kod 202 znači da ga je poziv prihvatio:
preuzeo ga je otvoreni zahtjev ili je vlastiti zahtjev alata još u tijeku
pa će ga preuzeti njegov odgovor na čekanju. Rezultat koji nijedan zahtjev
nikada ne preuzme (vaša krajnja točka zatim odgovori nečim drugim osim odgovora na čekanju za taj
request_id) odbacuje se.
Ako veza ima transformaciju odgovora (kôd koji prepisuje odgovor vaše
krajnje točke prije nego što ga agent vidi), transformacija se pokreće nad vlastitim odgovorom vaše krajnje točke prije nego što ThunderPhone provjeri
postoji li odgovor na čekanju, stoga u odgovoru na čekanju mora zadržati status i request_id.
Ne pokreće se nad rezultatom koji kasnije pošaljete: agent
taj rezultat dobiva onako kako ga pošaljete.
Agent s punim dupleksom nema glazbu na čekanju ni poruke o ažuriranju, pa se na njegovim pozivima
alat na čekanju ponaša kao alat updates: odgovor na čekanju stiže do
agenta kao rezultat alata.
Odgovor na čekanju alata u načinu updates ne ostaje otvoren:
agent ga prima kao rezultat alata.
Provjera potpisa
Izravni pozivi alata potpisuju se na isti način kao webhookovi, s pomoću tajne webhooka vaše organizacije:
X-ThunderPhone-Signature-V2potpisuje vremensku oznaku, metodu, putanju i upit onako kako su poslani te točne bajtove tijela. Odbijte zahtjeve čija je vremenska oznaka udaljena više od 5 minuta od vremena na vašem satu.X-ThunderPhone-Signature(naslijeđeni) potpisuje samo bajtove tijela, odnosno prazan niz bajtova zaGET/DELETE. I dalje se šalje, neizmijenjen.
Pomoćne funkcije SDK-a provjeravaju zaglavlje V2, uključujući vremenski okvir od 5 minuta:
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 });
});Cjeloviti primjeri — potpisani niz, razrađeni primjer, kôd bez SDK-a,
slučaj GET / DELETE i napomena za slučaj bez tajne — nalaze se u odjeljku Provjera potpisa webhookova.
Primjer: potpuni tijek rezervacije
Evo skupa alata za potpuni sustav rezervacije termina:
{
"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" }
}
}
]
}Pokretanje alata na početku poziva
Alat se može automatski pokrenuti i na početku svakog telefonskog poziva, prije nego što agent izgovori prvu riječ, kako bi pozdrav mogao koristiti rezultat. Uobičajen je slučaj CRM pretraživanje prema broju pozivatelja: "Dobro nam se vratili, Arthi! Želite li svoju uobičajenu narudžbu?"
Na nadzornoj ploči otvorite API vezu i postavite Kada se pokreće na
Na početku svakog telefonskog poziva, a zatim unesite vrijednost koju
dobiva svaki parametar. Putem API-ja postavite trigger integracije na
call_start i njezin call_start_arguments
(API veze) ili dodajte blok call_start
ugrađenom alatu:
{
"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}}"
}
}
}Argumenti trebaju vrijednost za svaki obavezni parametar jer nitko ne unosi ništa na početku poziva. Vrijednosti su nizovi znakova, brojevi ili Booleove vrijednosti. Pohranjuju se i vraćaju kao običan tekst te ih agent vidi, stoga tajne, poput API ključeva, čuvajte u zaglavljima veze, a ne ovdje. Nizovi znakova mogu koristiti ova mjesta za umetanje:
| Mjesto za umetanje | Vrijednost |
|---|---|
{{caller_number}} | Druga osoba u pozivu u formatu E.164, npr. +61402122887: pozivatelj u dolaznom pozivu, pozvana osoba u odlaznom pozivu |
{{caller_number_national}} | Isti broj u nacionalnom formatu njegove države bez razmaka, npr. 0402122887 |
{{agent_number}} | Vlastiti broj agenta |
Kako funkcionira:
- Zahtjev je isti kao onaj koji šalju pozivi alata samog agenta (ista krajnja točka, zaglavlja, format zahtjeva i potpis).
- Alat se pokreće kada započne poziv i radi dok se reproducira bilo koji ton uspostavljanja veze, uvodna poruka ili obavijest o snimanju. Pozdrav čeka rezultat najviše približno 3 sekunde od tog trenutka. Sporiji rezultat daje se agentu čim stigne, za ostatak poziva. U odlaznom pozivu pokreće se kada se poziv uputi, pa se izvršava pri svakom pokušaju, uključujući one na koje nitko ne odgovori.
- Kod agenta kod kojeg pozivatelj prvi govori nema pozdrava koji treba čekati; agent dobiva rezultat čim stigne.
- Rezultat se daje agentu kao kontekst za cijeli poziv. U upitu navedite agentu kako ga koristiti; inače se ne čita naglas.
- Ako alat ne uspije ili istekne vrijeme, agent pozdravlja pozivatelja kao što bi inače i ne govori ništa o tome.
- Agent i dalje može sam pozvati alat kasnije tijekom poziva.
- Pokreće se u telefonskim pozivima, uključujući testne pozive s nadzorne ploče na vaš telefon, i u AI simulacijama, koje vašoj krajnjoj točki šalju broj simuliranog pozivatelja. Ne pokreće se u testovima Razgovor u pregledniku ni u sesijama web-widgeta, koje nemaju broj pozivatelja, u pozivima sa skrivenim ID-om pozivatelja ni kod agenata s koracima.
- Agent pokreće najviše tri alata na početku poziva, sve istodobno.
Spomenite rezultat u upitu kako bi agent znao kako ga koristiti, na primjer: "Ako je pretraživanje na početku poziva pronašlo pozivatelja, pozdravite ga imenom."
Najbolje prakse
Napišite jasne opise
Polje description pomaže AI-ju razumjeti kada upotrijebiti alat. Jasno navedite što alat radi i kada ga je prikladno upotrijebiti.
Pravilno obradite pogreške
Vratite poruke o pogreškama koje AI može razumjeti: {"error": "No slots available for that date"} umjesto generičkih pogrešaka 500.
Neka odgovori budu sažeti
Vratite samo ono što AI-ju treba za nastavak razgovora. Rezultat alata ostaje u razgovoru i ponovno se čita u svakom sljedećem koraku, pa velik rezultat povećava trošak i kašnjenje tijekom ostatka poziva. Rezultati dulji od 100.000 znakova skraćuju se na pregled za koji AI zna da je nepotpun, a tijekom vrlo dugog poziva stariji se rezultati mogu odbaciti (AI može ponovno pozvati alat). Dodajte parametar kako bi AI mogao dohvatiti jednu stavku ili kategoriju odjednom, a veliki referentni sadržaj, poput jelovnika ili kataloga, smjestite u bazu znanja. Pošaljite testni zahtjev na nadzornoj ploči prikazuje veličinu svakog rezultata i upozorava kada je velik.
Razumno koristite obavezna polja
Označite polja kao required samo kada je to zaista potrebno. AI će od korisnika zatražiti obavezne informacije prije pozivanja alata.
Povezano
Zadajte radnje poziva kojima upravlja platforma bez definiranja krajnje točke.
Alati kojima upravlja platforma za HubSpot, Salesforce, Google Calendar, Google Sheets i Cal.com — krajnja točka nije potrebna.
Povežite MCP poslužitelj i omogućite agentu da poziva njegove alate.
Ponovno iskoristive REST integracije koje možete povezati s agentima.
Jedan pomoćnik za provjeru webhookova i poziva alata.