Open in
Funkcijų įrankiai
Suteikite savo DI agentams funkcijų įrankius, kurie pokalbio metu iškviečia išorines API, gauna klientų duomenis, rezervuoja susitikimus ir atnaujina įrašus naudodami tipizuotus parametrus.
Funkcijų įrankiai leidžia jūsų balso agentams skambučių metu iškviesti išorines API. Naudokite juos klientų duomenims rasti, prieinamumui patikrinti, susitikimams rezervuoti arba bet kuriam veiksmui, kurį palaiko jūsų vidinė sistema, atlikti.
Kaip tai veikia
- Apibrėžiate įrankius naudodami schemą (kokius argumentus priima įrankis)
- Pateikiate
endpointkonfigūraciją (kur ThunderPhone iškviečia jūsų API) arba jos nenurodote, kad įrankio iškvietimus gautumėte organizacijos žiniatinklio kablio adresu - Skambučio metu DI nusprendžia, kada naudoti įrankį, pagal pokalbį
- ThunderPhone iškviečia jūsų galinį tašką su įrankio argumentais
- Jūsų API atsakymas perduodamas atgal DI, kad pokalbis tęstųsi
| Galimybė | Kur vykdoma | Nustatymas |
|---|---|---|
| Integruoti įrankiai | ThunderPhone | Raginimo instrukcijos; kai kuriems įrankiams taip pat reikia agento nustatymo |
| Programų jungtys | ThunderPhone ir prijungtas paslaugų teikėjas | Prijunkite paskyrą ir pridėkite patvirtintus veiksmus |
| API jungtys ir funkcijų įrankiai | Jūsų HTTP API | Apibrėžkite galinį tašką ir schemą arba gaukite funkcijų iškvietimus per žiniatinklio kablį |
| MCP serveriai | Nuotolinis MCP serveris | Pridėkite serverį, aptikite jo įrankius ir prijunkite jį prie agento |
Įrankio schema
Kiekvienas įrankis turi tokią struktūrą:
{
"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
}Įrankio konfigūracija
| Laukas | Tipas | Privalomas | Aprašymas |
|---|---|---|---|
timeout | skaičius | Ne | Maksimali vykdymo trukmė sekundėmis (numatytoji reikšmė: 20, maksimali: 180 arba 600, kai wait_mode: "hold") |
wait_mode | eilutė | Ne | Ką skambinantysis girdi, kol veikia įrankis: updates (numatytoji reikšmė) – trumpi sakytiniai pranešimai; arba hold – laukimo muzika. Žr. Ilgas laukimas: laukimo režimas ir atsakymas vėliau |
call_start | objektas | Ne | Taip pat automatiškai paleisti įrankį kiekvieno telefono skambučio pradžioje, prieš pasisveikinimą. Žr. Paleiskite įrankį skambučio pradžioje |
Funkcijos apibrėžimas
| Laukas | Tipas | Privalomas | Aprašas |
|---|---|---|---|
name | eilutė | Taip | Įrankio identifikatorius, unikalus tarp vieno skambučio įrankių. Skirtingi agentai gali turėti savo įrankį tuo pačiu pavadinimu |
description | eilutė | Taip | Paaiškina DI, kada naudoti šį įrankį |
parameters | objektas | Taip | Įrankio argumentų JSON schema |
Galinio taško konfigūracija
| Laukas | Tipas | Būtinas | Aprašymas |
|---|---|---|---|
url | eilutė | Taip | Jūsų API galinio taško URL |
method | eilutė | Ne | HTTP metodas (numatytoji reikšmė: POST) |
headers | objektas | Ne | Įtraukiamos pasirinktinės antraštės |
Du iškvietimo keliai
Kokią užklausą gauna jūsų serveris, priklauso nuo to, ar įrankis turi
endpoint:
Įrankis su endpoint | Įrankis be endpoint | |
|---|---|---|
| Kur siunčiama užklausa | Tiesiogiai į endpoint.url | Jūsų organizacijos senasis žiniatinklio kablio URL |
| Turinys | Pasirinktas užklausos formatas (pagal numatytuosius nustatymus – vien argumentai) | telephony.tool / web.tool apvalkalas |
| Antraštės | Jūsų endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, taip pat skambučio numeriai telefono skambučių metu | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| Pasirašymo raktas | Organizacijos žiniatinklio kablio paslaptis | Organizacijos žiniatinklio kablio paslaptis |
Abu keliai yra blokuojantys — DI laukia rezultato sakinio viduryje. Numatytasis laukimo laikas yra 20 s; nustatykite įrankio aukščiausiojo lygmens timeout, kad leistumėte ilgesnį vykdymą, iki platformos 180 s maksimumo. Užtikrinkite, kad apdorojimo tvarkyklės veiktų sparčiai. Jei reikia laukti žmogaus arba lėtos užduoties, naudokite sulaikymo režimą. Galima naudoti ir derinį: skambučio, kurio organizacijoje nustatytas žiniatinklio kablio URL, metu įrankiai su endpoint iškviečiami tiesiogiai, o likusieji grįžta prie žiniatinklio kablio.
Tiesioginiai galinio taško iškvietimai
Kai AI iškviečia įrankį, turintį endpoint, ThunderPhone siunčia
užklausą į jūsų URL:
Užklausos antraštės
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-keyPasirinktinės antraštės iš jūsų endpoint.headers visada įtraukiamos
nepakeistos, taip pat šios ThunderPhone vardų srities antraštės:
X-ThunderPhone-Signature-V2— laiko žyma pažymėtas HMAC-SHA256, apimantis metodą, kelią, užklausą ir turinį, pasirašytas jūsų organizacijos webhook slaptuoju raktu. Patikrinkite jį ir atmeskite senesnes nei 5 minučių užklausas; žr. Patikrinkite webhook parašusX-ThunderPhone-Signature— senasis tikslių užklausos turinio baitų HMAC-SHA256, pasirašytas tuo pačiu raktu, vis dar siunčiamas esamiems tikrintuvamsX-ThunderPhone-Call-ID— dabartinio skambučio IDX-ThunderPhone-From-NumberirX-ThunderPhone-To-Number— skambučio numeriai Nuo ir Kam E.164 formatu. Jie reiškia tą patį kaipfrom_numberirto_numbertelephony.completeįvykyje: išeinančio skambučio atveju Nuo yra jūsų agento numeris, o Kam — asmens, kuriam skambinama, numeris. Numeris nenurodomas, kai skambintojo ID yra paslėptas arba nėra telefono numerisX-ThunderPhone-Call-Direction—inboundarbaoutbound, kad galėtumėte nustatyti, kuris numeris priklauso klientui
Skambučio numerio antraštės siunčiamos tik telefono skambučiams. Žiniatinklio, valdiklio,
realiuoju laiku vykdomi ir naršyklės Talk testai neturi telefono numerio, todėl jų nesiunčia.
Bandomieji skambučiai iš agento rengyklės ir DI simuliacijos perduoda imituojamo skambintojo numerį. Parašai
neapima antraščių: V2 pasirašo laiko žymą, metodą, kelią, užklausą ir turinį. Jei
norite, kad numeriai būtų pasirašyti, vietoj to nuskaitykite juos iš turinio:
retell užklausos formatas perduoda visus tris, o vapi perduoda
kliento numerį.
Content-Type: application/json nustatoma, nebent jūsų endpoint.headers
ją pakeičia — pasirinktinė Content-Type turi pirmenybę.
Užklausos formatas
Kiekvienas API ryšys turi request_format nustatymą. Pasirinkite vapi arba
retell, kai importuotas įrankis turi toliau kviesti tai platformai sukurtą
galinį tašką. Naujiems ir esamiems ryšiams pagal numatytuosius nustatymus naudojamas standard.
Naudodama POST / PUT / PATCH, ThunderPhone pasirinktos
struktūros duomenis serializuoja kanoniniu būdu (surūšiuoti raktai, kompaktiški skirtukai). Abu parašai
apima būtent šiuos baitus.
Standartinis
standard siunčia tik įrankio argumentus be apvalkalo. Tai numatytasis
formatas, išsaugantis pradinį ThunderPhone užklausos turinį baitas į baitą:
{"date":"2025-01-02","service":"consultation"}Vapi
vapi siunčia Vapi tool-calls serverio pranešimą
tokios struktūros, kokią dokumentuoja Vapi. call.id yra ThunderPhone skambučio ID.
Telefoninių skambučių atveju call.customer.number yra kitos šalies numeris, kaip ir
Vapi skambučio objekte: įeinančio skambučio skambinančiojo numeris, o išeinančio –
asmens, kuriam skambinama, numeris. Jis nepateikiamas, kai šis numeris yra paslėptas
arba nėra telefono numeris. Įrankio iškvietimo id yra unikalus šiam iškvietimui ir
pakartotinai naudojamas siekiant susieti galinio taško rezultatą. Skambutis pateikiamas
tiek toolCallList, tiek toolWithToolCallList, o function.arguments yra JSON objektas:
{
"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" }
}
}
}
]
}
}Tik Vapi skirti laukai, pvz., assistant, artifact ir visas call objektas,
nesiunčiami.
Grąžinkite Vapi atsako struktūrą su atitinkamu įrankio iškvietimo ID:
{
"results": [
{
"toolCallId": "call_00112233445566778899aabbccddeeff",
"result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
}
]
}ThunderPhone pateikia AI neišskleistą result eilutę. Siekiant suderinamumo su
galiniais taškais, kurie ją jau grąžina, ji taip pat priima JSON reikšmę. Vietoje
result pateikta error grąžinama AI kaip įrankio klaida. Jei galinis taškas grąžina
netaisyklingą arba neatitinkančią Vapi struktūrą, ThunderPhone užregistruoja
įspėjimą ir, užuot nutraukusi skambutį, naudoja standartinį atsako analizavimą.
Retell
retell siunčia užklausą, dokumentuotą Retell pasirinktinėje
funkcijoje:
{
"name": "search_appointments",
"call": {
"call_id": "987654321",
"from_number": "+14155550199",
"to_number": "+14155550100",
"direction": "inbound"
},
"args": { "date": "2025-01-02", "service": "consultation" }
}Telefono skambučiuose objektas call apima call_id, from_number,
to_number ir direction (inbound arba outbound) – laukų pavadinimus,
kuriuos naudoja Retell telefono skambučio objektas. Jie atitinka skambučio
numerio antraštes ir, kitaip nei antraštės, yra apimami abiejų parašų.
Nuslėptas arba telefono numeriu nesantis numeris neįtraukiamas. Žiniatinklio,
valdiklio, realiojo laiko ir naršyklės Talk bandymuose jis turi tik call_id.
ThunderPhone neįtraukia konkrečių Retell laukų, kurių negali sąžiningai
pateikti išsiuntimo metu, pavyzdžiui, agent_id, transcript,
transcript_object, metadata ar dinaminių kintamųjų. Retell priima bet
kokį atsakymo turinį; ThunderPhone jį perduoda naudodamas standartinį atsakymų
apdorojimą.
Naudojant GET / DELETE, argumentai siunčiami kaip užklausos parametrai,
o turinys visada tuščias, nepaisant request_format. V2 parašas
apima išsiųstą užklausos eilutę; senasis parašas apskaičiuojamas pagal
tuščią baitų eilutę. Žr.
Patikrinkite webhook parašus.
Atsakymas
Grąžinkite JSON atsakymą su įrankio rezultatu:
{
"available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
"timezone": "America/Los_Angeles"
}Atsakymas suformatuojamas ir pateikiamas AI, kad šis galėtų tęsti
pokalbį. Ne JSON atsakymai apgaubiami kaip {"data": "<text>"};
laiko limitų viršijimai ir ryšio klaidos AI pateikiamos kaip klaidos,
todėl agentas gali atsiprašyti ir tęsti, užuot užstrigęs.
Išsiuntimas webhook režimu
Įrankiai be endpoint siunčiami į jūsų organizacijos senojo
webhook URL kaip pasirašyta telephony.tool (telefono skambučiai) arba web.tool
(žiniatinklio iškvietimai) užklausa. Kitaip nei audito pranešimai,
kurie pateikiami webhook galiniams taškams po vykdymo, ši užklausa yra
vykdymas — jūsų HTTP atsakymas yra įrankio rezultatas.
{
"type": "telephony.tool",
"data": {
"call_id": 987654321,
"tool_name": "search_appointments",
"arguments": { "date": "2026-04-21" },
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}web.tool naudoja origin_domain vietoj from_number /
to_number. Atsakykite įrankio rezultatu JSON formatu — taikoma ta pati atsakymo
sutartis kaip ir tiesioginiams iškvietimams į galinius taškus. Užklausa pasirašoma organizacijos
žiniatinklio kablio paslaptimi, naudojant abi parašo antraštes, kaip ir kiekvienas kitas žiniatinklio kablys.
Ilgas laukimas: laukimo režimas ir atsakymas vėliau
Kai kurie įrankiai laukia žmogaus: vadovo, patvirtinančio nuolaidą, arba savininko,
atsakančio į klausimą per Slack. Tokiems įrankiams nustatykite wait_mode į "hold".
wait_mode: "updates" (numatytasis) | wait_mode: "hold" | |
|---|---|---|
| Ką girdi skambinantysis | Įrankio paleidimo sakinį, tada maždaug po 12 s trumpą sakinį „vis dar vykdoma“ ir dar vieną maždaug kas 15 s | Įrankio paleidimo sakinį, tada laukimo muziką, kol gaunamas rezultatas |
Didžiausia timeout reikšmė | 180 s | 600 s |
| Laukiantys atsakymai | Perduodami agentui kaip rezultatas | Įrankis lieka atidarytas, kol pateikiate rezultatą |
Laukimo režimu agentas įrankiui pradedant veikti pasako vieną sakinį (savo žodžiais arba agentui nustatytą įrankio paleidimo sakinį), tada skambinantysis girdi laukimo muziką. Muzika nutyla prieš agentui pasakant rezultatą. Įrankiui, kuris atsako per vieną ar dvi sekundes, muzika visai negrojama. Kai agentas kalba su telefono meniu arba balso pašto dėžute, vietoj to jis naudoja garsinius pranešimus, nes muzika gali būti palaikyta atsakymu. Tai taikoma ir skambučiui, kurio metu paaiškėja, kad tai meniu arba pašto dėžutė: muzika sustabdoma ir pradedami naudoti garsiniai pranešimai. Taip pat nutinka skambučio metu, kai muzikos negalima paleisti.
Jei skambinantysis kalba laukimo metu, muzika toliau groja, o agentas dar neatsako. Jis išgirsta, ką skambinantysis pasakė, ir atsako į tai kartu su rezultatu. Padėjus ragelį, skambutis ir atidarytas įrankis baigiami.
Atsakymas vėliau
Jūsų galinio taško atsakymas vis tiek turi būti gautas per 180 s. Kad skambinantysis lauktų ilgiau, iš karto atsakykite laukiančiu rezultatu:
{ "status": "pending", "request_id": "ask-4471" }request_id yra bet kokia iki 200 simbolių eilutė, identifikuojanti šią
užklausą jūsų pusėje. Skambinantysis lieka laukti, kol pateiksite jos
rezultatą naudodami
POST /v1/calls/{call_id}/tool-results.
call_id yra įrankio užklausos antraštės X-ThunderPhone-Call-ID reikšmė.
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." }
}'Agentas perskaito result kaip įrankio atsakymą, taip pat, kaip jei jį
būtų grąžinęs jūsų galinis taškas. Jei rezultatas negaunamas iki įrankio
timeout, skaičiuojant nuo įrankio iškvietimo momento, agentui pranešama,
kad atsakymas nebuvo gautas, ir jis pasiūlo skambinančiajam tolesnius
veiksmus, pavyzdžiui, palikti žinutę.
Rezultatą galite paskelbti kada norite, net prieš jūsų laukiančiam
atsakymui pasiekiant ThunderPhone. 202 reiškia, kad skambutis jį priėmė:
jį priėmė atidaryta užklausa arba paties įrankio užklausa dar vykdoma ir
jos laukiantis atsakymas jį perims. Rezultatas, kurio niekada neperima
jokia užklausa (nes jūsų galinis taškas tada tam request_id atsakė kuo
nors kitu nei laukiantis atsakymas), atmetamas.
Jei ryšys turi atsakymo transformaciją (kodą, kuris perrašo jūsų galinio
taško atsakymą prieš agentui jį matant), transformacija vykdoma jūsų galinio
taško atsakymui prieš ThunderPhone tikrinant, ar yra laukiantis atsakymas,
todėl ji turi išsaugoti status ir request_id laukiančiame atsakyme.
Ji nevykdoma rezultatui, kurį paskelbiate vėliau: agentas gauna tokį
rezultatą, kokį jį išsiunčiate.
Pilno dvipusio ryšio agentas neturi nei laukimo muzikos, nei pranešimų
eilučių, todėl jo skambučiuose laukimo įrankis veikia kaip updates
įrankis: laukiantis atsakymas pasiekia agentą kaip įrankio rezultatas.
Laukiantis atsakymas iš įrankio, veikiančio updates režimu, nelaikomas
atidarytas: agentas jį gauna kaip įrankio rezultatą.
Parašo patvirtinimas
Tiesioginiai įrankių iškvietimai pasirašomi taip pat kaip žiniatinklio kabliukai, naudojant jūsų organizacijos žiniatinklio kabliuko paslaptį:
X-ThunderPhone-Signature-V2pasirašo laiko žymą, metodą, kelią ir užklausos parametrus tokius, kokie buvo išsiųsti, bei tikslius turinio baitus. Atmeskite užklausas, kurių laiko žyma nuo jūsų laikrodžio skiriasi daugiau nei 5 minutes.X-ThunderPhone-Signature(pasenusi versija) pasirašo tik turinio baitus, oGET/DELETEatveju – tuščią baitų eilutę. Ji vis dar siunčiama nepakitusi.
SDK pagalbinės funkcijos tikrina V2 antraštę, įskaitant 5 minučių intervalą:
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 });
});Išsamūs pavyzdžiai – pasirašoma eilutė, praktinis pavyzdys, kodas be SDK, GET / DELETE atvejis ir pastaba apie paslapties nebuvimą – pateikti skiltyje Tikrinkite žiniatinklio kabliukų parašus.
Pavyzdys: visas rezervavimo procesas
Štai įrankių rinkinys visai vizitų rezervavimo sistemai:
{
"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" }
}
}
]
}Paleiskite įrankį skambučio pradžioje
Įrankis taip pat gali būti paleidžiamas automatiškai kiekvieno telefono skambučio pradžioje, dar prieš agentui ištariant pirmą žodį, kad pasisveikinimui būtų galima panaudoti rezultatą. Dažniausias atvejis yra CRM paieška pagal skambinančiojo numerį: „Sveiki sugrįžę, Arthi! Ar norėtumėte užsisakyti įprastą užsakymą?“
Valdymo skydelyje atidarykite API ryšį ir nustatykite Kada jis vykdomas į
Kiekvieno telefono skambučio pradžioje, tada nurodykite kiekvieno
parametro reikšmę. Naudodami API, nustatykite integracijos trigger į
call_start ir jos call_start_arguments
(API ryšiai) arba įterptiniame įrankyje pridėkite call_start
bloką:
{
"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}}"
}
}
}Argumentams reikia reikšmės kiekvienam privalomam parametrui, nes skambučio pradžioje niekas nieko neįveda. Reikšmės gali būti eilutės, skaičiai arba loginės reikšmės. Jos saugomos ir grąžinamos kaip paprastas tekstas, o agentas jas mato, todėl slaptus duomenis, pavyzdžiui, API raktus, laikykite ryšio antraštėse, o ne čia. Eilutėse galima naudoti šias vietos žymas:
| Vietos žyma | Reikšmė |
|---|---|
{{caller_number}} | Kitas skambučio dalyvis E.164 formatu, pvz., +61402122887: įeinančio skambučio skambintojas, išeinančio skambučio asmuo, kuriam skambinama |
{{caller_number_national}} | Tas pats numeris jo šalies nacionaliniu formatu be tarpų, pvz., 0402122887 |
{{agent_number}} | Paties agento numeris |
Veikimas:
- Užklausa yra tokia pati kaip ir ta, kuri siunčiama agentui pačiam iškvietus įrankį (tas pats galinis taškas, antraštės, užklausos formatas ir parašas).
- Įrankis paleidžiamas prasidėjus skambučiui ir veikia, kol skamba prisijungimo tonas, įžanga arba pranešimas apie įrašymą. Nuo to momento pasisveikinimas jo laukia iki maždaug 3 sekundžių. Lėčiau gautas rezultatas perduodamas agentui iškart, kai tik gaunamas, likusiai skambučio daliai. Išeinančio skambučio metu jis paleidžiamas inicijuojant skambutį, todėl vykdomas kiekvieno bandymo metu, įskaitant tuos, į kuriuos niekas neatsiliepia.
- Agento, kuriam pirmasis kalba skambintojas, atveju nėra pasisveikinimo, kurio reikėtų laukti; agentas rezultatą gauna iškart, kai tik jis pateikiamas.
- Rezultatas agentui pateikiamas kaip viso skambučio kontekstas. Nurodykite agentui savo raginime, kaip jį naudoti; kitu atveju jis nėra perskaitomas garsiai.
- Jei įrankio vykdymas nepavyksta arba baigiasi skirtasis laikas, agentas pasisveikina su skambintoju kaip įprastai ir apie tai nieko nesako.
- Agentas vėliau skambučio metu vis tiek gali pats iškviesti įrankį.
- Jis vykdomas telefono skambučių metu, įskaitant valdymo skydelio bandomuosius skambučius į jūsų telefoną, ir DI simuliacijose, kurios į jūsų galinį tašką siunčia imituojamo skambintojo numerį. Jis nevykdomas naršyklės Pokalbio bandymuose ar žiniatinklio valdiklio sesijose, kuriose nėra skambinančiojo numerio, skambučiuose, kurių skambinančiojo ID yra paslėptas, arba agentams su žingsniais.
- Agentas vienu metu vykdo ne daugiau kaip tris skambučio pradžios įrankius.
Paminėkite rezultatą savo raginime, kad agentas žinotų, kaip jį naudoti, pavyzdžiui: „Jei skambučio pradžios paieška rado skambintoją, pasisveikinkite su juo vardu.“
Geriausios praktikos
Rašykite aiškius aprašus
Laukas description padeda DI suprasti, kada naudoti įrankį. Tiksliai nurodykite, ką jis daro ir kada jį tinka naudoti.
Tinkamai tvarkykite klaidas
Pateikite DI suprantamus klaidų pranešimus: {"error": "No slots available for that date"}, o ne bendrines 500 klaidas.
Trumpinkite atsakymus
Grąžinkite tik tai, ko dirbtiniam intelektui reikia pokalbiui tęsti. Įrankio rezultatas lieka pokalbyje ir yra iš naujo perskaitomas kiekviename vėlesniame pokalbio žingsnyje, todėl didelis rezultatas padidina likusios skambučio dalies kainą ir delsą. Didesni nei 100,000 simbolių rezultatai sutrumpinami iki peržiūros, kurią dirbtinis intelektas žino esant neišsamią, o per labai ilgą skambutį senesni rezultatai gali būti pašalinti (dirbtinis intelektas gali vėl iškviesti įrankį). Pridėkite parametrą, kad dirbtinis intelektas galėtų vienu metu rasti vieną elementą ar kategoriją, o didelės apimties informacinį turinį, pvz., meniu ar katalogus, įdėkite į žinių bazę. Skydelyje esantis Siųsti bandomąją užklausą rodo kiekvieno rezultato dydį ir įspėja, kai jis didelis.
Apgalvotai naudokite privalomus laukus
Žymėkite laukus kaip required tik tada, kai tai tikrai būtina. Prieš iškviesdamas įrankį, DI paprašys naudotojo pateikti privalomą informaciją.
Susiję
Nurodykite platformos valdomus skambučių veiksmus neapibrėždami galinio taško.
Platformos valdomi įrankiai, skirti HubSpot, Salesforce, Google Calendar, Google Sheets ir Cal.com — galinio taško nereikia.
Prijunkite MCP serverį ir leiskite agentui iškviesti jo įrankius.
Pakartotinai naudojamos REST integracijos, kurias galite prijungti prie agentų.
Vienas tikrinimo pagalbinis įrankis žiniatinklio kabliukams ir įrankių iškvietimams.