Open in
Funkcijska orodja
Svojim agentom UI zagotovite funkcijska orodja, ki med pogovorom kličejo zunanje API-je — pridobivajo podatke o strankah, rezervirajo termine in posodabljajo zapise — s tipiziranimi parametri.
Funkcijska orodja vašim glasovnim agentom omogočajo klicanje zunanjih API-jev med telefonskimi klici. Uporabite jih za iskanje podatkov o strankah, preverjanje razpoložljivosti, rezervacijo terminov ali izvajanje katerega koli dejanja, ki ga podpira vaš zaledni sistem.
Kako deluje
- Orodja določite s shemo (katere argumente orodje sprejema)
- Zagotovite konfiguracijo
endpoint(kam ThunderPhone kliče vaš API) — ali jo izpustite, da prejemate klice orodij na spletnem kavlju svoje organizacije - Med klicem se AI glede na pogovor odloči, kdaj uporabiti orodje
- ThunderPhone pokliče vašo končno točko z argumenti orodja
- Odgovor vašega API-ja se posreduje nazaj AI-ju za nadaljevanje pogovora
| Zmogljivost | Kje se izvaja | Nastavitev |
|---|---|---|
| Vgrajena orodja | ThunderPhone | Navodila v pozivu; nekatera orodja potrebujejo tudi nastavitev agenta |
| Povezave aplikacij | ThunderPhone in povezani ponudnik | Povežite račun in dodajte odobrena dejanja |
| Povezave API in funkcijska orodja | Vaš HTTP API | Določite končno točko in shemo ali prejemajte funkcijske klice prek spletnega kavlja |
| Strežniki MCP | Oddaljeni strežnik MCP | Dodajte strežnik, odkrijte njegova orodja in ga dodajte agentu |
Shema orodja
Vsako orodje sledi tej strukturi:
{
"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 orodja
| Polje | Vrsta | Obvezno | Opis |
|---|---|---|---|
timeout | število | Ne | Najdaljši čas izvajanja v sekundah (privzeto: 20, največ: 180 oziroma 600 z wait_mode: "hold") |
wait_mode | niz | Ne | Kaj klicatelj sliši med izvajanjem orodja: updates (privzeto), kratka glasovna obvestila; ali hold, glasba med čakanjem. Glejte Dolga čakanja: način zadržanja in poznejši odgovor |
call_start | objekt | Ne | Orodje samodejno zaženite tudi ob začetku vsakega telefonskega klica, pred pozdravom. Glejte Zagon orodja ob začetku klica |
Definicija funkcije
| Polje | Vrsta | Obvezno | Opis |
|---|---|---|---|
name | niz | Da | Identifikator orodja, enoličen med orodji enega klica. Različni agenti imajo lahko vsak svoje orodje z istim imenom |
description | niz | Da | Pojasnjuje umetni inteligenci, kdaj naj uporabi to orodje |
parameters | objekt | Da | Shema JSON za argumente orodja |
Konfiguracija končne točke
| Polje | Vrsta | Obvezno | Opis |
|---|---|---|---|
url | string | Da | URL končne točke vašega API-ja |
method | string | Ne | Metoda HTTP (privzeto: POST) |
headers | object | Ne | Glave po meri, ki jih želite vključiti |
Dve poti klicanja
Katero zahtevo prejme vaš strežnik, je odvisno od tega, ali ima orodje
endpoint:
Orodje z endpoint | Orodje brez endpoint | |
|---|---|---|
| Kam se pošlje zahteva | Neposredno na endpoint.url | Na starejši URL spletnega kavlja vaše organizacije |
| Telo | Izbrana oblika zahteve (privzeto goli argumenti) | Ovojnica telephony.tool / web.tool |
| Glave | Vaše endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature ter številke klica pri telefonskih klicih | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| Ključ za podpisovanje | Skrivnost spletnega kavlja organizacije | Skrivnost spletnega kavlja organizacije |
Obe poti sta blokirajoči — AI sredi stavka čaka na rezultat. Privzeta časovna omejitev je 20 s; nastavite timeout orodja na najvišji ravni, da omogočite daljše izvajanje, do največ 180 s na platformi. Obravnalnike ohranite hitre. Za čakanje na osebo ali počasno opravilo uporabite način zadržanja. Kombinacija je možna: pri klicu, katerega organizacija ima URL spletne kljuke, se orodja z endpoint pokličejo neposredno, preostala pa uporabijo spletno kljuko.
Neposredni klici končnih točk
Ko AI pokliče orodje, ki ima endpoint, ThunderPhone pošlje
zahtevo na vaš URL:
Glave zahtev
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-keyGlave po meri iz vašega endpoint.headers so vedno vključene dobesedno,
skupaj s temi glavami v imenskem prostoru ThunderPhone:
X-ThunderPhone-Signature-V2— časovno označen HMAC-SHA256 za metodo, pot, poizvedbo in telo, podpisan z vašo skrivnostjo organizacije za spletne kljuke. Preverite ga in zavrnite zahteve, starejše od 5 minut; glejte Preverjanje podpisov spletnih kljukX-ThunderPhone-Signature— podedovani HMAC-SHA256 natančnih bajtov telesa zahteve z istim ključem, ki se še vedno pošilja za obstoječe preverjevalnikeX-ThunderPhone-Call-ID— ID trenutnega klicaX-ThunderPhone-From-NumberinX-ThunderPhone-To-Number— številki From in To klica v obliki E.164. Pomenita enako kotfrom_numberinto_numbervtelephony.complete: pri odhodnem klicu je From številka vašega agenta, To pa številka klicane osebe. Številka ni vključena, kadar je identifikacija klicatelja skrita ali ne gre za telefonsko številkoX-ThunderPhone-Call-Direction—inboundalioutbound, da lahko ugotovite, katera številka pripada stranki
Glave s številkami klicev se pošiljajo samo pri telefonskih klicih. Spletni, gradniški,
sprotni in brskalniški preizkusi Talk nimajo telefonske številke in jih izpustijo.
Preizkusni klici iz urejevalnika agenta in simulacije AI vsebujejo številko
simuliranega klicatelja. Podpisi ne
zajemajo glav: V2 podpiše časovni žig, metodo, pot, poizvedbo in telo. Če
potrebujete podpisane številke, jih namesto tega preberite iz telesa:
oblika zahteve retell vsebuje vse tri, vapi pa vsebuje številko
stranke.
Content-Type: application/json je nastavljen, razen če ga vaš endpoint.headers
prepiše — Content-Type po meri ima prednost.
Oblika zahteve
Vsaka povezava API ima nastavitev request_format. Izberite vapi ali
retell, kadar naj uvoženo orodje še naprej kliče končno točko, zgrajeno za
to platformo. Nove in obstoječe povezave privzeto uporabljajo standard.
Pri POST / PUT / PATCH ThunderPhone izbrano ovojnico serijsko obdela
kanonično (razvrščeni ključi, strnjena ločila). Oba podpisa zajemata natanko te bajte.
Standard
standard pošlje samo argumente orodja, brez ovojnice. To je privzeta možnost in ohrani ThunderPhoneovo izvirno telo zahteve bajt za bajtom:
{"date":"2025-01-02","service":"consultation"}Vapi
vapi pošlje Vapi-jevo strežniško sporočilo tool-calls
v obliki, ki jo dokumentira Vapi. call.id je ID klica ThunderPhone.
Pri telefonskih klicih je call.customer.number številka druge osebe, kot v
Vapi-jevem objektu klica: klicatelja pri dohodnem klicu in osebe, ki jo kličete
pri odhodnem klicu. Izpuščena je, kadar je ta številka skrita ali ni telefonska
številka. id klica orodja je enoličen za priklic in se ponovno uporabi za
ujemanje rezultata končne točke. Klic je prikazan v toolCallList in
toolWithToolCallList, pri čemer je function.arguments 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" }
}
}
}
]
}
}Polja, ki veljajo samo za Vapi, kot so assistant, artifact in celoten objekt
call, niso poslana.
Vrnite Vapi-jevo ovojnico odgovora z ujemajočim se ID-jem klica orodja:
{
"results": [
{
"toolCallId": "call_00112233445566778899aabbccddeeff",
"result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
}
]
}ThunderPhone agentu AI posreduje neoviti niz result. Zaradi združljivosti
sprejme tudi vrednost JSON s končnih točk, ki jo že vračajo. error namesto
result je agentu AI vrnjen kot napaka orodja. Če končna točka vrne nepravilno
oblikovano ali neujemajočo se ovojnico Vapi, ThunderPhone zabeleži opozorilo in
namesto prekinitve klica uporabi standardno razčlenjevanje odgovorov.
Retell
retell pošlje zahtevo, dokumentirano za funkcijo po meri Retell:
{
"name": "search_appointments",
"call": {
"call_id": "987654321",
"from_number": "+14155550199",
"to_number": "+14155550100",
"direction": "inbound"
},
"args": { "date": "2025-01-02", "service": "consultation" }
}Pri telefonskih klicih objekt call vsebuje call_id, from_number,
to_number in direction (inbound ali outbound), imena polj, ki jih
uporablja Retellov objekt telefonskega klica. Ujemajo se z glavami s številko
klica in so v nasprotju z glavami zajeta v obeh podpisih. Številka, ki je
skrita ali ni telefonska številka, je izpuščena. Pri spletnih preizkusih,
preizkusih gradnika, preizkusih v realnem času in preizkusih Talk v brskalniku
vsebuje samo call_id. ThunderPhone ne vključuje polj, specifičnih za Retell,
ki jih ob pošiljanju ne more zanesljivo zagotoviti, kot so agent_id,
transcript, transcript_object, metadata ali dinamične spremenljivke.
Retell sprejme poljubno telo odgovora; ThunderPhone ga posreduje s standardno
obravnavo odgovorov.
Pri GET / DELETE so argumenti poslani kot parametri poizvedbe,
telo pa je prazno ne glede na request_format. Podpis V2 zajema niz poizvedbe,
kot je poslan; starejši podpis se izračuna na praznem nizu bajtov. Glejte
Preverjanje podpisov webhookov.
Odgovor
Vrnite odgovor JSON z rezultatom orodja:
{
"available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
"timezone": "America/Los_Angeles"
}Odgovor je oblikovan in posredovan AI, da nadaljuje
pogovor. Odgovori, ki niso JSON, so oviti kot {"data": "<text>"};
prekinitve zaradi časovne omejitve in povezave so AI sporočene kot napake, zato
se lahko agent opraviči in nadaljuje, namesto da obstane.
Posredovanje v načinu webhook
Orodja brez endpoint so posredovana na URL starejšega webhooka vaše
organizacije kot podpisana zahteva telephony.tool (telefonski klici) ali web.tool
(spletni klici). Za razliko od obvestil za revizijo,
dostavljenih na končne točke webhookov po izvedbi, ta zahteva je
izvedba — vaš odgovor HTTP je rezultat orodja.
{
"type": "telephony.tool",
"data": {
"call_id": 987654321,
"tool_name": "search_appointments",
"arguments": { "date": "2026-04-21" },
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}web.tool namesto from_number / to_number vsebuje origin_domain. Odgovorite z rezultatom orodja v obliki JSON — z enako pogodbo odgovora kot pri neposrednih klicih končne točke. Zahteva je podpisana s skrivnostjo webhooka organizacije in vsebuje obe glavi podpisa, tako kot vsak drug webhook.
Dolgo čakanje: način čakanja in poznejši odgovor
Nekatera orodja čakajo na osebo: vodjo, ki odobri popust, ali lastnika,
ki odgovori na vprašanje v Slacku. Za taka orodja nastavite wait_mode
na "hold".
wait_mode: "updates" (privzeto) | wait_mode: "hold" | |
|---|---|---|
| Kaj sliši klicatelj | Vrstico ob zagonu orodja, nato kratko vrstico »še vedno delam« po približno 12 s in drugo približno vsakih 15 s | Vrstico ob zagonu orodja, nato glasbo za čakanje, dokler ne prispe rezultat |
Največja vrednost timeout | 180 s | 600 s |
| Čakajoči odgovori | Posredovani agentu kot rezultat | Orodje ostane odprto, dokler ne dostavite rezultata |
V načinu čakanja agent ob zagonu orodja izgovori eno vrstico (s svojimi besedami ali vrstico ob zagonu orodja, nastavljeno za agenta), nato klicatelj sliši glasbo za čakanje. Glasba postopoma utihne, preden agent izgovori rezultat. Orodje, ki odgovori v sekundi ali dveh, sploh ne predvaja glasbe. Ko se agent pogovarja s telefonskim menijem ali predalom glasovne pošte, namesto tega uporablja govorne posodobitve, saj bi glasbo lahko razumeli kot odgovor. To velja tudi za klic, za katerega se med čakanjem ugotovi, da gre za meni ali predal glasovne pošte: glasba se ustavi in prevzamejo jo govorne posodobitve. Enako velja za klic, pri katerem glasbe ni mogoče predvajati.
Če klicatelj med čakanjem govori, se glasba še naprej predvaja in agent še ne odgovori. Agent sliši, kaj je klicatelj povedal, in odgovori na to skupaj z rezultatom. Prekinitev klica konča klic in odprto orodje.
Odgovorite pozneje
Lastni odgovor vaše končne točke mora še vedno prispeti v 180 s. Če želite klicatelja zadržati dlje, takoj odgovorite s čakajočim rezultatom:
{ "status": "pending", "request_id": "ask-4471" }request_id je poljuben niz do 200 znakov, ki na vaši strani prepozna
to zahtevo. Klicatelj ostane na čakanju, dokler ne dostavite rezultata
zanj z
POST /v1/calls/{call_id}/tool-results.
call_id je vrednost glave X-ThunderPhone-Call-ID zahteve orodja.
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 prebere result kot odgovor orodja, enako kot če bi ga vrnila
vaša končna točka. Če rezultat ne prispe pred timeout orodja, šteto od
trenutka, ko je bilo orodje poklicano, je agent obveščen, da odgovor ni
prispel, in klicatelju ponudi naslednje korake, na primer sprejem
sporočila.
Rezultat lahko pošljete takoj, tudi preden vaš čakajoči odgovor doseže
ThunderPhone. Koda 202 pomeni, da ga je klic sprejel: prevzela ga je
odprta zahteva ali pa je lastna zahteva orodja še vedno v teku in ga bo
prevzel njen čakajoči odgovor. Rezultat, ki ga ne prevzame nobena
zahteva (vaša končna točka je nato za ta request_id odgovorila z
nečim drugim kot s čakajočim odgovorom), se zavrže.
Če ima povezava preoblikovanje odgovora (kodo, ki prepiše odgovor vaše
končne točke, preden ga vidi agent), se preoblikovanje izvede na lastnem
odgovoru vaše končne točke, preden ThunderPhone preveri čakajoči
odgovor, zato mora v čakajočem odgovoru ohraniti status in
request_id. Ne izvede se na rezultatu, ki ga pošljete pozneje: agent
prejme ta rezultat, kot ga pošljete.
Agent s polnim dupleksom nima glasbe za čakanje ali vrstic s
posodobitvami, zato se na njegovih klicih orodje za čakanje obnaša kot
orodje updates: čakajoči odgovor doseže agenta kot rezultat orodja.
Čakajoči odgovor orodja v načinu updates ne ostane odprt: agent ga
prejme kot rezultat orodja.
Preverjanje podpisa
Neposredni klici orodij so podpisani enako kot spletne kljuke, pri čemer se uporablja skrivnost spletne kljuke vaše organizacije:
X-ThunderPhone-Signature-V2podpiše časovni žig, metodo, pot in poizvedbo, kot so bili poslani, ter natančne bajte telesa. Zavrnite zahteve, katerih časovni žig odstopa od vaše ure za več kot 5 minut.X-ThunderPhone-Signature(podedovana različica) podpiše samo bajte telesa, priGET/DELETEpa prazen niz bajtov. Še vedno se pošilja nespremenjena.
Pomožne funkcije SDK preverijo glavo V2, vključno s 5-minutnim časovnim oknom:
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 });
});Celotni postopki — podpisani niz, izdelan primer, koda brez SDK, primer GET / DELETE in opozorilo glede odsotnosti skrivnosti — so v Preverjanje podpisov spletnih kljuk.
Primer: celoten potek rezervacije
Tukaj je nabor orodij za celoten sistem rezervacije terminov:
{
"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" }
}
}
]
}Zaženite orodje ob začetku klica
Orodje se lahko samodejno zažene tudi ob začetku vsakega telefonskega klica, preden agent izreče prvo besedo, da lahko pozdrav uporabi rezultat. Običajen primer je iskanje v CRM-ju po številki klicatelja: »Dobrodošli nazaj, Arthi! Ali želite svoje običajno naročilo?«
Na nadzorni plošči odprite povezavo API in nastavite Kdaj se zažene na
Ob začetku vsakega telefonskega klica, nato pa vnesite vrednost, ki jo
prejme vsak parameter. Prek API-ja nastavite trigger integracije na
call_start in njene call_start_arguments
(Povezave API) ali dodajte blok call_start
v vgrajeno orodje:
{
"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 potrebujejo vrednost za vsak zahtevani parameter, saj ob začetku klica nihče ničesar ne izpolni. Vrednosti so nizi, števila ali logične vrednosti. Shranijo in vrnejo se kot navadno besedilo, agent pa jih vidi, zato skrivnosti, kot so ključi API, hranite v glavah povezave, ne tukaj. Nizi lahko uporabljajo te označbe mesta:
| Označba mesta | Vrednost |
|---|---|
{{caller_number}} | Druga oseba v klicu v obliki E.164, na primer +61402122887: klicatelj pri dohodnem klicu, klicana oseba pri odhodnem klicu |
{{caller_number_national}} | Ista številka v nacionalni obliki svoje države brez presledkov, na primer 0402122887 |
{{agent_number}} | Lastna številka agenta |
Delovanje:
- Zahteva je enaka zahtevi, ki jo pošljejo klici agentovega orodja (ista končna točka, glave, oblika zahteve in podpis).
- Orodje se zažene ob začetku klica in deluje, medtem ko se predvaja ton za vzpostavitev povezave, uvod ali obvestilo o snemanju. Pozdrav nanj od takrat čaka največ približno 3 sekunde. Počasnejši rezultat se agentu posreduje takoj, ko prispe, za preostanek klica. Pri odhodnem klicu se zažene, ko je klic vzpostavljen, zato se izvede pri vsakem poskusu, tudi pri tistih, na katere se nihče ne oglasi.
- Pri agentu, kjer klicatelj govori prvi, ni pozdrava, ki bi moral čakati; agent prejme rezultat takoj, ko prispe.
- Rezultat se agentu posreduje kot kontekst za celoten klic. V pozivu agentu povejte, kako naj ga uporabi; sicer se ne prebere na glas.
- Če orodje ne uspe ali poteče časovna omejitev, agent pozdravi klicatelja kot običajno in o tem ne pove ničesar.
- Agent lahko orodje pozneje med klicem še vedno pokliče sam.
- Deluje pri telefonskih klicih, vključno s preskusnimi klici z nadzorne plošče na vaš telefon, in pri simulacijah AI, ki vaši končni točki pošljejo številko simuliranega klicatelja. Ne deluje pri preskusih Pogovor v brskalniku ali sejah spletnega gradnika, ki nimajo številke klicatelja, pri klicih s skrito identifikacijo klicatelja ali pri agentih s koraki.
- Agent hkrati zažene največ tri orodja ob začetku klica.
V pozivu navedite rezultat, da agent ve, kako ga uporabiti, na primer: »Če je iskanje ob začetku klica našlo klicatelja, ga pozdravite z imenom.«
Najboljše prakse
Napišite jasne opise
Polje description pomaga UI razumeti, kdaj uporabiti orodje. Natančno opišite, kaj počne in kdaj ga je primerno uporabiti.
Ustrezno obravnavajte napake
Vrnite sporočila o napakah, ki jih UI razume: {"error": "No slots available for that date"} namesto splošnih napak 500.
Odgovori naj bodo jedrnati
Vrnite samo tisto, kar AI potrebuje za nadaljevanje pogovora. Rezultat orodja ostane v pogovoru in se znova prebere pri vsakem naslednjem koraku, zato velik rezultat poveča stroške in zakasnitev preostanka klica. Rezultati, daljši od 100.000 znakov, se skrajšajo na predogled, za katerega AI ve, da je nepopoln, pri zelo dolgem klicu pa se lahko starejši rezultati odstranijo (AI lahko orodje znova pokliče). Dodajte parameter, da lahko AI hkrati poišče en element ali kategorijo, večjo referenčno vsebino, kot so meniji ali katalogi, pa shranite v bazo znanja. Pošljite preskusno zahtevo na nadzorni plošči prikaže velikost vsakega rezultata in opozori, kadar je velik.
Polja, ki so obvezna, uporabljajte premišljeno
Polja označite kot required le, kadar je to res potrebno. UI bo pred klicem orodja uporabnika vprašala za zahtevane informacije.
Sorodno
Pozovite dejanja klicev, ki jih upravlja platforma, brez določanja končne točke.
Orodja, ki jih upravlja platforma, za HubSpot, Salesforce, Google Calendar, Google Sheets in Cal.com — končna točka ni potrebna.
Povežite strežnik MCP in agentu omogočite klicanje njegovih orodij.
Integracije REST za večkratno uporabo, ki jih lahko povežete z agenti.
En pomočnik za preverjanje webhookov in klicev orodij.