ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Function Tools

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

  1. Apibrėžiate įrankius naudodami schemą (kokius argumentus priima įrankis)
  2. Pateikiate endpoint konfigūraciją (kur ThunderPhone iškviečia jūsų API) arba jos nenurodote, kad įrankio iškvietimus gautumėte organizacijos žiniatinklio kablio adresu
  3. Skambučio metu DI nusprendžia, kada naudoti įrankį, pagal pokalbį
  4. ThunderPhone iškviečia jūsų galinį tašką su įrankio argumentais
  5. Jūsų API atsakymas perduodamas atgal DI, kad pokalbis tęstųsi
GalimybėKur vykdomaNustatymas
Integruoti įrankiaiThunderPhoneRaginimo instrukcijos; kai kuriems įrankiams taip pat reikia agento nustatymo
Programų jungtysThunderPhone ir prijungtas paslaugų teikėjasPrijunkite paskyrą ir pridėkite patvirtintus veiksmus
API jungtys ir funkcijų įrankiaiJūsų HTTP APIApibrėžkite galinį tašką ir schemą arba gaukite funkcijų iškvietimus per žiniatinklio kablį
MCP serveriaiNuotolinis MCP serverisPridė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

LaukasTipasPrivalomasAprašymas
timeoutskaičiusNeMaksimali vykdymo trukmė sekundėmis (numatytoji reikšmė: 20, maksimali: 180 arba 600, kai wait_mode: "hold")
wait_modeeilutėNeKą 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_startobjektasNeTaip pat automatiškai paleisti įrankį kiekvieno telefono skambučio pradžioje, prieš pasisveikinimą. Žr. Paleiskite įrankį skambučio pradžioje

Funkcijos apibrėžimas

LaukasTipasPrivalomasAprašas
nameeilutėTaipĮrankio identifikatorius, unikalus tarp vieno skambučio įrankių. Skirtingi agentai gali turėti savo įrankį tuo pačiu pavadinimu
descriptioneilutėTaipPaaiškina DI, kada naudoti šį įrankį
parametersobjektasTaipĮrankio argumentų JSON schema

Galinio taško konfigūracija

LaukasTipasBūtinasAprašymas
urleilutėTaipJūsų API galinio taško URL
methodeilutėNeHTTP metodas (numatytoji reikšmė: POST)
headersobjektasNeĮ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žklausaTiesiogiai į endpoint.urlJūsų organizacijos senasis žiniatinklio kablio URL
TurinysPasirinktas užklausos formatas (pagal numatytuosius nustatymus – vien argumentai)telephony.tool / web.tool apvalkalas
AntraštėsJūsų endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, taip pat skambučio numeriai telefono skambučių metuContent-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature
Pasirašymo raktasOrganizacijos žiniatinklio kablio paslaptisOrganizacijos ž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-key

Pasirinktinė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šus
  • X-ThunderPhone-Signature — senasis tikslių užklausos turinio baitų HMAC-SHA256, pasirašytas tuo pačiu raktu, vis dar siunčiamas esamiems tikrintuvams
  • X-ThunderPhone-Call-ID — dabartinio skambučio ID
  • X-ThunderPhone-From-Number ir X-ThunderPhone-To-Number — skambučio numeriai Nuo ir Kam E.164 formatu. Jie reiškia tą patį kaip from_number ir to_number telephony.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 numeris
  • X-ThunderPhone-Call-Direction — inbound arba outbound, 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 s600 s
Laukiantys atsakymaiPerduodami 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-V2 pasiraš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, o GET / DELETE atveju – tuščią baitų eilutę. Ji vis dar siunčiama nepakitusi.

SDK pagalbinės funkcijos tikrina V2 antraštę, įskaitant 5 minučių intervalą:

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 });
});

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 žymaReikš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ę