Open in
Zana za Function
Wape ejenti zako za AI zana za function zinazopiga API za nje katikati ya mazungumzo — kupata data za wateja, kuweka miadi, kusasisha rekodi — zikiwa na vigezo vilivyoainishwa kwa aina.
Zana za vitendaji huruhusu ejenti zako za AI kuita API za nje wakati wa simu. Zitumie kutafuta data ya mteja, kuangalia upatikanaji, kuweka miadi, au kutekeleza hatua yoyote inayotumika kwenye backend yako.
Jinsi Inavyofanya Kazi
- Unafafanua zana kwa schema (hoja ambazo zana inakubali)
- Unatoa usanidi wa
endpoint(mahali ThunderPhone inapoita API yako) — au uiachie ili upokee miito ya zana kwenye webhook ya org yako - Wakati wa simu, AI huamua wakati wa kutumia zana kulingana na mazungumzo
- ThunderPhone huita endpoint yako kwa hoja za zana
- Jibu la API yako hurudishwa kwa AI ili kuendeleza mazungumzo
| Uwezo | Mahali inapotekelezwa | Usanidi |
|---|---|---|
| Zana zilizojengewa ndani | ThunderPhone | Maagizo ya prompt; baadhi ya zana pia zinahitaji mpangilio wa ejenti |
| Miunganisho ya app | ThunderPhone na mtoa huduma aliyeunganishwa | Unganisha akaunti na uambatishe hatua zilizoidhinishwa |
| Miunganisho ya API na zana za vitendaji | API yako ya HTTP | Fafanua endpoint na schema, au pokea miito ya vitendaji kupitia webhook |
| Seva za MCP | Seva ya MCP ya mbali | Ongeza seva, gundua zana zake, na uiambatishe kwa ejenti |
Schema ya Zana
Kila zana hufuata muundo huu:
{
"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
}Usanidi wa Zana
| Sehemu | Aina | Inahitajika | Maelezo |
|---|---|---|---|
timeout | nambari | Hapana | Muda wa juu zaidi wa utekelezaji kwa sekunde (chaguo-msingi: 20, upeo: 180, au 600 ukiwa na wait_mode: "hold") |
wait_mode | mfuatano | Hapana | Anachosikia mpigaji simu wakati zana inaendeshwa: updates (chaguo-msingi), masasisho mafupi yanayosemwa; au hold, muziki wa kusubiri. Tazama Kusubiri kwa muda mrefu: hali ya kusubiri na kujibu baadaye |
call_start | kitu | Hapana | Pia endesha zana kiotomatiki mwanzoni mwa kila simu, kabla ya salamu. Tazama Endesha zana mwanzoni mwa simu |
Ufafanuzi wa Kitendaji
| Sehemu | Aina | Inahitajika | Maelezo |
|---|---|---|---|
name | string | Ndiyo | Kitambulisho cha zana, cha kipekee miongoni mwa zana za simu moja. Ejenti tofauti zinaweza kila moja kuwa na zana yao yenye jina lilelile |
description | string | Ndiyo | Hueleza AI wakati wa kutumia zana hii |
parameters | object | Ndiyo | JSON Schema ya hoja za zana |
Usanidi wa Endpoint
| Sehemu | Aina | Inahitajika | Maelezo |
|---|---|---|---|
url | mfuatano | Ndiyo | URL ya endpoint ya API yako |
method | mfuatano | Hapana | Mbinu ya HTTP (chaguo-msingi: POST) |
headers | kitu | Hapana | Header maalum za kujumuisha |
Njia mbili za kuita
Ombi ambalo seva yako inapokea hutegemea ikiwa zana ina
endpoint:
Zana yenye endpoint | Zana isiyo na endpoint | |
|---|---|---|
| Ombi linaenda wapi | Moja kwa moja kwa endpoint.url | URL ya webhook ya zamani ya shirika lako |
| Mwili | Muundo wa ombi uliochaguliwa (hoja pekee kwa chaguo-msingi) | Bahasha ya telephony.tool / web.tool |
| Vichwa | endpoint.headers zako + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, pamoja na nambari za simu za mwito kwenye miito ya simu | Content-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature |
| Ufunguo wa kutia saini | Siri ya webhook ya shirika | Siri ya webhook ya shirika |
Njia zote mbili ni za kuzuia — AI inasubiri matokeo katikati ya sentensi. Muda chaguomsingi wa kuisha ni sekunde 20; weka timeout ya kiwango cha juu cha zana ili kuruhusu utekelezaji mrefu zaidi, hadi kiwango cha juu cha jukwaa cha sekunde 180. Weka handler ziwe za haraka. Kwa kusubiri mtu au kazi polepole, tumia hali ya kusubiri. Mchanganyiko unaruhusiwa: kwenye simu ambayo org yake ina URL ya webhook, zana zenye endpoint huitwa moja kwa moja na zilizosalia hurudi kwenye webhook.
Miito ya moja kwa moja ya endpoint
Wakati AI inapoita zana yenye endpoint, ThunderPhone hutuma
ombi kwenye URL yako:
Vichwa vya Ombi
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-keyVichwa maalum kutoka kwenye endpoint.headers yako hujumuishwa kila wakati
kama zilivyo, pamoja na vichwa hivi vyenye nafasi ya majina ya ThunderPhone:
X-ThunderPhone-Signature-V2— HMAC-SHA256 yenye muhuri wa muda ya mbinu, njia, query na mwili, inayotumia siri ya webhook ya shirika lako kama ufunguo. Thibitisha hii na ukatae maombi yaliyozidi dakika 5; tazama Thibitisha saini za webhookX-ThunderPhone-Signature— HMAC-SHA256 ya zamani ya baiti kamili za mwili wa ombi, yenye ufunguo uleule, ambayo bado hutumwa kwa mifumo ya uthibitishaji iliyopoX-ThunderPhone-Call-ID— Kitambulisho cha simu ya sasaX-ThunderPhone-From-NumbernaX-ThunderPhone-To-Number— namba za From na To za simu katika E.164. Zinamaanisha sawa nafrom_numbernato_numberkatikatelephony.complete: kwenye simu ya outbound, From ni namba ya ejenti wako na To ni mtu anayepigiwa. Namba huachwa nje wakati kitambulisho cha mpigaji kimefichwa au si namba ya simuX-ThunderPhone-Call-Direction—inboundauoutbound, ili uweze kutambua namba ipi ni ya mteja
Vichwa vya namba za simu hutumwa kwenye simu za simu pekee. Majaribio ya
wavuti, wijeti, muda halisi na Talk kwenye kivinjari hayana namba ya simu na
huviacha nje. Simu za majaribio kutoka kwenye kihariri cha ejenti na
uigaaji wa AI hubeba namba ya mpigaji aliyeigwa. Saini hazifunikii
vichwa: V2 hutia saini muhuri wa muda, mbinu, njia, query na mwili. Ikiwa
unahitaji namba kutiwa saini, zisome kutoka kwenye mwili badala yake:
muundo wa ombi wa retell hubeba zote tatu, na vapi hubeba namba ya
mteja.
Content-Type: application/json huwekwa isipokuwa endpoint.headers yako
iibadilishe — Content-Type maalum hupewa kipaumbele.
Muundo wa ombi
Kila muunganisho wa API una mpangilio wa request_format. Chagua vapi au
retell wakati zana iliyoagizwa inapaswa kuendelea kuita endpoint iliyoundwa kwa
jukwaa hilo. Miunganisho mipya na iliyopo hutumia standard kwa chaguo-msingi.
Kwa POST / PUT / PATCH, ThunderPhone husanifisha bahasha iliyochaguliwa
kwa utaratibu mmoja (funguo zilizopangwa, vitenganishi vilivyobana). Sahihi zote
mbili zinahusu baiti hizi kamili.
Kawaida
standard hutuma tu hoja za zana, bila kifuniko. Hii ndiyo chaguomsingi na huhifadhi mwili wa ombi asili wa ThunderPhone baiti kwa baiti:
{"date":"2025-01-02","service":"consultation"}Vapi
vapi hutuma ujumbe wa seva wa tool-calls wa Vapi
kwa muundo unaoelezwa na Vapi. call.id ni kitambulisho cha simu cha ThunderPhone.
Katika simu, call.customer.number ni nambari ya upande mwingine, kama ilivyo katika
kitu cha simu cha Vapi: mpigaji katika simu inayoingia, au mtu anayepigiwa
katika simu inayotoka. Huachwa nje nambari hiyo inapofichwa au isiwe
nambari ya simu. id ya tool-call ni ya kipekee kwa uitishaji huo na
hutumika tena kulinganisha na matokeo ya kituo cha mwisho. Simu huonekana katika toolCallList na
toolWithToolCallList, huku function.arguments ikiwa kitu cha 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" }
}
}
}
]
}
}Sehemu za Vapi pekee kama vile assistant, artifact na kitu kamili cha call
hazitumwi.
Rudisha bahasha ya majibu ya Vapi yenye kitambulisho cha mwito wa zana kinacholingana:
{
"results": [
{
"toolCallId": "call_00112233445566778899aabbccddeeff",
"result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
}
]
}ThunderPhone huipa AI mfuatano wa result usiofungwa. Pia hukubali thamani ya
JSON kwa uoanifu na endpoint ambazo tayari hurejesha thamani hiyo. error
badala ya result hurudishwa kwa AI kama hitilafu ya zana. Ikiwa endpoint
itarejesha bahasha ya Vapi yenye muundo mbovu au isiyolingana, ThunderPhone
huandika onyo na kurejea uchanganuzi wake wa kawaida wa majibu badala ya
kushindwa kwa simu.
Retell
retell hutuma ombi lililoelezwa kwa function maalum ya Retell:
{
"name": "search_appointments",
"call": {
"call_id": "987654321",
"from_number": "+14155550199",
"to_number": "+14155550100",
"direction": "inbound"
},
"args": { "date": "2025-01-02", "service": "consultation" }
}Kwenye simu, kitu cha call hubeba call_id, from_number,
to_number na direction (inbound au outbound), majina ya sehemu
yanayotumiwa na kitu cha simu cha Retell. Yanalingana na vichwa vya
namba za simu, na tofauti na vichwa hivyo yanafunikwa na sahihi zote
mbili. Namba iliyofichwa au isiyo namba ya simu huachwa. Kwenye wavuti,
wijeti, muda halisi na majaribio ya Talk kwenye kivinjari, kina
call_id pekee. ThunderPhone haijumuishi sehemu mahususi za Retell
ambazo haiwezi kutoa kwa uaminifu wakati wa kutuma, kama vile
agent_id, transcript, transcript_object, metadata, au
vigeu vinavyobadilika. Retell hukubali mwili wowote wa jibu;
ThunderPhone huupitisha kwa kutumia ushughulikiaji wa kawaida wa majibu.
Kwa GET / DELETE, hoja hutumwa kama vigezo vya hoja
na mwili huwa tupu bila kujali request_format. Sahihi ya V2
inahusu mfuatano wa hoja kama ulivyotumwa; sahihi ya zamani huhesabiwa kwa
mfuatano tupu wa baiti. Tazama
Thibitisha sahihi za webhook.
Jibu
Rudisha jibu la JSON lenye matokeo ya zana:
{
"available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
"timezone": "America/Los_Angeles"
}Jibu hupangwa na kupewa AI ili kuendeleza
mazungumzo. Majibu yasiyo ya JSON hufunikwa kama {"data": "<text>"};
muda kuisha na hitilafu za muunganisho huripotiwa kwa AI kama hitilafu, hivyo
ejenti inaweza kuomba msamaha na kuendelea badala ya kusita.
Uelekezaji wa hali ya webhook
Zana zisizo na endpoint huelekezwa kwenye URL ya webhook ya zamani ya
shirika lako kama ombi lililotiwa sahihi la telephony.tool (simu) au web.tool
(miito ya wavuti). Tofauti na arifa za ukaguzi
zinazowasilishwa kwenye endpoint za webhook baada ya utekelezaji, ombi hili ndilo
utekelezaji — jibu lako la HTTP ndilo matokeo ya zana.
{
"type": "telephony.tool",
"data": {
"call_id": 987654321,
"tool_name": "search_appointments",
"arguments": { "date": "2026-04-21" },
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}web.tool hubeba origin_domain badala ya from_number /
to_number. Jibu kwa matokeo ya zana kama JSON — mkataba sawa wa
majibu kama miito ya moja kwa moja ya endpoint. Ombi limetiwa sahihi kwa
secret ya webhook ya shirika, likiwa na headers zote mbili za saini, kama webhook nyingine yoyote.
Kusubiri kwa muda mrefu: hali ya kushikilia na kujibu baadaye
Baadhi ya zana husubiri mtu: meneja aidhinishe punguzo, mmiliki
ajibu swali kwenye Slack. Weka wait_mode kuwa "hold" kwenye zana
hizo.
wait_mode: "updates" (chaguo-msingi) | wait_mode: "hold" | |
|---|---|---|
| Anachomsikia mpigaji | Sentensi ya kuanza kwa zana, kisha sentensi fupi ya "bado inaendelea" baada ya takriban sekunde 12 na nyingine kila sekunde 15 hivi | Sentensi ya kuanza kwa zana, kisha muziki wa kusubiri hadi matokeo yafike |
Upeo wa timeout | sekunde 180 | sekunde 600 |
| Majibu yanayosubiri | Hupitishwa kwa ejenti kama matokeo | Zana hubaki wazi hadi uwasilishe matokeo |
Katika hali ya kushikilia, ejenti husema sentensi moja zana inapoanza (maneno yake yenyewe, au sentensi ya kuanza kwa zana iliyowekwa kwenye ejenti), kisha mpigaji husikia muziki wa kusubiri. Muziki hupunguzwa taratibu kabla ejenti haijasema matokeo. Zana inayojibu ndani ya sekunde moja au mbili haisikiki muziki wowote. Ejenti inapozungumza na menyu ya simu au kisanduku cha ujumbe wa sauti, hutumia masasisho ya sauti badala yake, kwa kuwa muziki unaweza kusikika kama jibu. Hii inajumuisha simu inayotambuliwa kuwa menyu au kisanduku cha ujumbe wa sauti wakati wa kushikilia: muziki husimama na masasisho ya sauti huanza. Hali hiyo pia hutumika kwenye simu ambayo muziki hauwezi kucheza.
Mpigaji akiongea wakati wa kushikilia, muziki huendelea kucheza na ejenti haijibu bado. Husikia alichosema mpigaji na hukijibu pamoja na matokeo. Kukata simu humaliza simu na zana iliyo wazi.
Jibu baadaye
Jibu la endpoint yako bado lazima lifike ndani ya sekunde 180. Ili kumweka mpigaji kwenye kusubiri kwa muda mrefu zaidi, jibu mara moja kwa matokeo yanayosubiri:
{ "status": "pending", "request_id": "ask-4471" }request_id ni mfuatano wowote wa herufi wenye hadi vibambo 200 unaotambulisha
ombi hili upande wako. Mpigaji hubaki kwenye kusubiri hadi uwasilishe
matokeo yake kwa
POST /v1/calls/{call_id}/tool-results.
call_id ni kichwa cha X-ThunderPhone-Call-ID cha ombi la zana.
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." }
}'Ejenti huchukulia result kama jibu la zana, sawa na kama endpoint yako
ingelirudisha jibu hilo. Ikiwa hakuna matokeo yanayofika kabla ya
timeout ya zana, inayohesabiwa kuanzia zana ilipoitwa, ejenti huarifiwa
kuwa hakuna jibu lililorejea na humpa mpigaji hatua zinazofuata, kama vile
kuacha ujumbe.
Unaweza kutuma matokeo wakati wowote, hata kabla jibu lako linalosubiri
halijafika ThunderPhone. 202 inamaanisha simu imeyakubali: ombi lililo
wazi limeyapokea, au ombi la zana yenyewe bado linaendelea na jibu lake
linalosubiri litayachukua. Matokeo ambayo hakuna ombi linalowahi kuyachukua
(endpoint yako kisha ikajibu kitu tofauti na pending kwa request_id hiyo)
hutupwa.
Ikiwa muunganisho una transform ya jibu (msimbo unaoandika upya jibu la
endpoint yako kabla ejenti haijaliona), transform huendeshwa kwenye jibu la
endpoint yako mwenyewe, kabla ThunderPhone haijakagua jibu linalosubiri,
kwa hiyo lazima ihifadhi status na request_id kwenye jibu linalosubiri.
Haiendeshwi kwenye matokeo unayotuma baadaye: ejenti hupokea matokeo hayo
kama unavyoyatuma.
Ejenti wa full-duplex hana muziki wa kusubiri wala sentensi za masasisho,
kwa hiyo kwenye simu zake zana ya kushikilia hufanya kazi kama zana ya
updates: jibu linalosubiri humfikia ejenti kama matokeo ya zana.
Jibu linalosubiri kutoka kwa zana katika hali ya updates haliwekwi wazi:
ejenti hulipokea kama matokeo ya zana.
Uthibitishaji wa Sahihi
Simu za moja kwa moja za zana husainiwa kwa njia sawa na webhooks, kwa kutumia siri ya webhook ya org yako:
X-ThunderPhone-Signature-V2husaini timestamp, method, path na query kama zilivyotumwa, pamoja na baiti kamili za body. Kataa maombi ambayo timestamp yake inatofautiana na saa yako kwa zaidi ya dakika 5.X-ThunderPhone-Signature(ya zamani) husaini baiti za body pekee, na mfuatano tupu wa baiti kwaGET/DELETE. Bado hutumwa bila kubadilishwa.
Visaidizi vya SDK hukagua header ya V2, ikijumuisha muda wa dakika 5:
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 });
});Maelekezo kamili — mfuatano uliosainiwa, mfano uliofafanuliwa, code bila SDK, hali ya GET / DELETE na tahadhari ya kutokuwa na siri — yanapatikana katika Thibitisha saini za webhook.
Mfano: Mtiririko Kamili wa Kuhifadhi Miadi
Hii ni seti ya zana za mfumo kamili wa kuhifadhi miadi:
{
"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" }
}
}
]
}Endesha zana mwanzoni mwa simu
Zana inaweza pia kuendeshwa kiotomatiki mwanzoni mwa kila simu, kabla ejenti haijasema neno lake la kwanza, ili salamu itumie matokeo. Hali ya kawaida ni utafutaji wa CRM kwa nambari ya mpigaji: "Karibu tena, Arthi! Je, ungependa oda yako ya kawaida?"
Kwenye dashibodi, fungua muunganisho wa API na uweke Wakati inapoendeshwa kuwa
Mwanzoni mwa kila simu, kisha jaza thamani ambayo kila
kigezo kinapata. Kupitia API, weka trigger ya muunganisho kuwa
call_start na call_start_arguments zake
(Miunganisho ya API), au ongeza kizuizi cha call_start
kwenye zana iliyopachikwa moja kwa moja:
{
"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}}"
}
}
}Hoja zinahitaji thamani kwa kila kigezo kinachohitajika, kwa kuwa hakuna anayejaza chochote mwanzoni mwa simu. Thamani ni mifuatano ya maandishi, nambari au thamani za kweli/sikweli. Huhifadhiwa na kurejeshwa kama maandishi ya kawaida na ejenti inaziona, hivyo weka siri kama funguo za API kwenye vichwa vya muunganisho, si hapa. Mifuatano ya maandishi inaweza kutumia vishikilia nafasi hivi:
| Kishikilia nafasi | Thamani |
|---|---|
{{caller_number}} | Mhusika mwingine kwenye simu katika muundo wa E.164, kwa mfano +61402122887: mpigaji kwenye simu inayoingia, mtu anayepigiwa kwenye simu inayotoka |
{{caller_number_national}} | Nambari hiyo hiyo katika muundo wa kitaifa wa nchi yake bila nafasi, kwa mfano 0402122887 |
{{agent_number}} | Nambari ya ejenti yenyewe |
Jinsi inavyofanya kazi:
- Ombi ni lilelile linalotumwa na miito ya zana ya ejenti yenyewe (endpoint, vichwa, muundo wa ombi na sahihi ni sawa).
- Zana huanza simu inapoanza, na huendeshwa huku toni yoyote ya kuunganishwa, utangulizi au taarifa ya kurekodi ikichezwa. Salamu huisubiri kwa hadi takribani sekunde 3 kuanzia wakati huo. Matokeo yanayochelewa yanatolewa kwa ejenti yanapowasili, kwa muda uliosalia wa simu. Kwenye simu inayotoka, huanza simu inapowekwa, hivyo huendeshwa kwenye kila jaribio, ikijumuisha yale ambayo hakuna anayejibu.
- Kwenye ejenti ambapo mpigaji huzungumza kwanza, hakuna salamu ya kusubiri; ejenti hupata matokeo mara tu yanapowasili.
- Matokeo hutolewa kwa ejenti kama muktadha wa simu nzima. Iambie ejenti kwenye prompt yako jinsi ya kuyatumia; vinginevyo hayasomwi kwa sauti.
- Zana ikishindwa au muda wake ukiisha, ejenti humsalimu mpigaji kama inavyofanya kawaida na haisemi chochote kuihusu.
- Ejenti bado inaweza kuita zana yenyewe baadaye kwenye simu.
- Huendeshwa kwenye simu, ikijumuisha simu za majaribio kutoka dashibodi kwenda kwenye simu yako, na kwenye uigaji wa AI, unaotuma nambari ya mpigaji aliyeigwa kwenye endpoint yako. Haiendeshwi kwenye majaribio ya Talk ya kivinjari au vipindi vya wijeti ya wavuti, ambavyo havina nambari ya mpigaji, kwenye simu ambazo kitambulisho cha mpigaji kimefichwa, au kwenye ejenti zilizo na hatua.
- Ejenti huendesha zana zisizozidi tatu za mwanzo wa simu, zote kwa wakati mmoja.
Taja matokeo kwenye prompt yako ili ejenti ijue jinsi ya kuyatumia, kwa mfano: "Ikiwa utafutaji wa mwanzo wa simu ulimpata mpigaji, msalimu kwa jina lake la kwanza."
Mbinu Bora
Andika maelezo yaliyo wazi
Sehemu ya description husaidia AI kuelewa lini itumie zana. Eleza kwa mahususi inachofanya na lini inafaa kutumika.
Shughulikia hitilafu kwa ustadi
Rudisha ujumbe wa hitilafu ambao AI inaweza kuelewa: {"error": "No slots available for that date"} badala ya hitilafu za jumla za 500.
Weka majibu mafupi
Rudisha tu kile ambacho AI inahitaji ili kuendeleza mazungumzo. Matokeo ya zana hubaki katika mazungumzo na husomwa tena katika kila zamu inayofuata, hivyo matokeo makubwa huongeza gharama na ucheleweshaji kwa sehemu iliyosalia ya simu. Matokeo yenye zaidi ya herufi 100,000 hupunguzwa hadi mwoneko wa awali ambao AI inajua haujakamilika, na katika simu ndefu sana matokeo ya zamani yanaweza kuondolewa (AI inaweza kuitisha zana tena). Ongeza kigezo ili AI iweze kutafuta kipengee au kategoria moja kwa wakati mmoja, na weka maudhui makubwa ya marejeleo kama vile menyu au katalogi katika msingi wa maarifa. Tuma Ombi la Jaribio kwenye dashibodi huonyesha ukubwa wa kila matokeo na huonya yanapokuwa makubwa.
Tumia sehemu zinazohitajika kwa busara
Weka alama kwenye sehemu kama required tu inapohitajika kweli. AI itamwomba mtumiaji taarifa zinazohitajika kabla ya kuita zana.
Yanayohusiana
Elekeza vitendo vya simu vinavyosimamiwa na jukwaa bila kufafanua endpoint.
Zana zinazosimamiwa na jukwaa za HubSpot, Salesforce, Google Calendar, Google Sheets, na Cal.com — hakuna endpoint inayohitajika.
Unganisha seva ya MCP na uruhusu ejenti kuitumia zana zake.
Miunganisho ya REST inayoweza kutumika tena unayoweza kuunganisha kwa ejenti.
Kisaidizi kimoja cha uthibitishaji kwa webhook na miito ya zana.