ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Function Tools

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

  1. Unafafanua zana kwa schema (hoja ambazo zana inakubali)
  2. Unatoa usanidi wa endpoint (mahali ThunderPhone inapoita API yako) — au uiachie ili upokee miito ya zana kwenye webhook ya org yako
  3. Wakati wa simu, AI huamua wakati wa kutumia zana kulingana na mazungumzo
  4. ThunderPhone huita endpoint yako kwa hoja za zana
  5. Jibu la API yako hurudishwa kwa AI ili kuendeleza mazungumzo
UwezoMahali inapotekelezwaUsanidi
Zana zilizojengewa ndaniThunderPhoneMaagizo ya prompt; baadhi ya zana pia zinahitaji mpangilio wa ejenti
Miunganisho ya appThunderPhone na mtoa huduma aliyeunganishwaUnganisha akaunti na uambatishe hatua zilizoidhinishwa
Miunganisho ya API na zana za vitendajiAPI yako ya HTTPFafanua endpoint na schema, au pokea miito ya vitendaji kupitia webhook
Seva za MCPSeva ya MCP ya mbaliOngeza 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

SehemuAinaInahitajikaMaelezo
timeoutnambariHapanaMuda wa juu zaidi wa utekelezaji kwa sekunde (chaguo-msingi: 20, upeo: 180, au 600 ukiwa na wait_mode: "hold")
wait_modemfuatanoHapanaAnachosikia 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_startkituHapanaPia endesha zana kiotomatiki mwanzoni mwa kila simu, kabla ya salamu. Tazama Endesha zana mwanzoni mwa simu

Ufafanuzi wa Kitendaji

SehemuAinaInahitajikaMaelezo
namestringNdiyoKitambulisho cha zana, cha kipekee miongoni mwa zana za simu moja. Ejenti tofauti zinaweza kila moja kuwa na zana yao yenye jina lilelile
descriptionstringNdiyoHueleza AI wakati wa kutumia zana hii
parametersobjectNdiyoJSON Schema ya hoja za zana

Usanidi wa Endpoint

SehemuAinaInahitajikaMaelezo
urlmfuatanoNdiyoURL ya endpoint ya API yako
methodmfuatanoHapanaMbinu ya HTTP (chaguo-msingi: POST)
headerskituHapanaHeader maalum za kujumuisha

Njia mbili za kuita

Ombi ambalo seva yako inapokea hutegemea ikiwa zana ina endpoint:

Zana yenye endpointZana isiyo na endpoint
Ombi linaenda wapiMoja kwa moja kwa endpoint.urlURL ya webhook ya zamani ya shirika lako
MwiliMuundo wa ombi uliochaguliwa (hoja pekee kwa chaguo-msingi)Bahasha ya telephony.tool / web.tool
Vichwaendpoint.headers zako + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, pamoja na nambari za simu za mwito kwenye miito ya simuContent-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature
Ufunguo wa kutia sainiSiri ya webhook ya shirikaSiri 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-key

Vichwa 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 webhook
  • X-ThunderPhone-Signature — HMAC-SHA256 ya zamani ya baiti kamili za mwili wa ombi, yenye ufunguo uleule, ambayo bado hutumwa kwa mifumo ya uthibitishaji iliyopo
  • X-ThunderPhone-Call-ID — Kitambulisho cha simu ya sasa
  • X-ThunderPhone-From-Number na X-ThunderPhone-To-Number — namba za From na To za simu katika E.164. Zinamaanisha sawa na from_number na to_number katika telephony.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 simu
  • X-ThunderPhone-Call-Direction — inbound au outbound, 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 mpigajiSentensi ya kuanza kwa zana, kisha sentensi fupi ya "bado inaendelea" baada ya takriban sekunde 12 na nyingine kila sekunde 15 hiviSentensi ya kuanza kwa zana, kisha muziki wa kusubiri hadi matokeo yafike
Upeo wa timeoutsekunde 180sekunde 600
Majibu yanayosubiriHupitishwa kwa ejenti kama matokeoZana 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-V2 husaini 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 kwa GET / DELETE. Bado hutumwa bila kubadilishwa.

Visaidizi vya SDK hukagua header ya V2, ikijumuisha muda wa dakika 5:

Python
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}
Node.js
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 nafasiThamani
{{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