ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Function Tools

Funkcijska orodja

Svojim agentom UI zagotovite funkcijska orodja, ki med pogovorom kličejo zunanje API-je — pridobivajo podatke o strankah, rezervirajo termine in posodabljajo zapise — s tipiziranimi parametri.

Funkcijska orodja vašim glasovnim agentom omogočajo klicanje zunanjih API-jev med telefonskimi klici. Uporabite jih za iskanje podatkov o strankah, preverjanje razpoložljivosti, rezervacijo terminov ali izvajanje katerega koli dejanja, ki ga podpira vaš zaledni sistem.

Kako deluje

  1. Orodja določite s shemo (katere argumente orodje sprejema)
  2. Zagotovite konfiguracijo endpoint (kam ThunderPhone kliče vaš API) — ali jo izpustite, da prejemate klice orodij na spletnem kavlju svoje organizacije
  3. Med klicem se AI glede na pogovor odloči, kdaj uporabiti orodje
  4. ThunderPhone pokliče vašo končno točko z argumenti orodja
  5. Odgovor vašega API-ja se posreduje nazaj AI-ju za nadaljevanje pogovora
ZmogljivostKje se izvajaNastavitev
Vgrajena orodjaThunderPhoneNavodila v pozivu; nekatera orodja potrebujejo tudi nastavitev agenta
Povezave aplikacijThunderPhone in povezani ponudnikPovežite račun in dodajte odobrena dejanja
Povezave API in funkcijska orodjaVaš HTTP APIDoločite končno točko in shemo ali prejemajte funkcijske klice prek spletnega kavlja
Strežniki MCPOddaljeni strežnik MCPDodajte strežnik, odkrijte njegova orodja in ga dodajte agentu

Shema orodja

Vsako orodje sledi tej strukturi:

{
  "type": "function",
  "function": {
    "name": "search_appointments",
    "description": "Find available appointment slots for a given date",
    "parameters": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "Date in YYYY-MM-DD format"
        },
        "service": {
          "type": "string",
          "description": "Type of service (e.g., 'consultation', 'follow-up')"
        }
      },
      "required": ["date"]
    }
  },
  "endpoint": {
    "url": "https://api.example.com/appointments/search",
    "method": "POST",
    "headers": {
      "X-Api-Key": "your-api-key"
    }
  },
  "timeout": 120
}

Konfiguracija orodja

PoljeVrstaObveznoOpis
timeoutšteviloNeNajdaljši čas izvajanja v sekundah (privzeto: 20, največ: 180 oziroma 600 z wait_mode: "hold")
wait_modenizNeKaj klicatelj sliši med izvajanjem orodja: updates (privzeto), kratka glasovna obvestila; ali hold, glasba med čakanjem. Glejte Dolga čakanja: način zadržanja in poznejši odgovor
call_startobjektNeOrodje samodejno zaženite tudi ob začetku vsakega telefonskega klica, pred pozdravom. Glejte Zagon orodja ob začetku klica

Definicija funkcije

PoljeVrstaObveznoOpis
namenizDaIdentifikator orodja, enoličen med orodji enega klica. Različni agenti imajo lahko vsak svoje orodje z istim imenom
descriptionnizDaPojasnjuje umetni inteligenci, kdaj naj uporabi to orodje
parametersobjektDaShema JSON za argumente orodja

Konfiguracija končne točke

PoljeVrstaObveznoOpis
urlstringDaURL končne točke vašega API-ja
methodstringNeMetoda HTTP (privzeto: POST)
headersobjectNeGlave po meri, ki jih želite vključiti

Dve poti klicanja

Katero zahtevo prejme vaš strežnik, je odvisno od tega, ali ima orodje endpoint:

Orodje z endpointOrodje brez endpoint
Kam se pošlje zahtevaNeposredno na endpoint.urlNa starejši URL spletnega kavlja vaše organizacije
TeloIzbrana oblika zahteve (privzeto goli argumenti)Ovojnica telephony.tool / web.tool
GlaveVaše endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature ter številke klica pri telefonskih klicihContent-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature
Ključ za podpisovanjeSkrivnost spletnega kavlja organizacijeSkrivnost spletnega kavlja organizacije

Obe poti sta blokirajoči — AI sredi stavka čaka na rezultat. Privzeta časovna omejitev je 20 s; nastavite timeout orodja na najvišji ravni, da omogočite daljše izvajanje, do največ 180 s na platformi. Obravnalnike ohranite hitre. Za čakanje na osebo ali počasno opravilo uporabite način zadržanja. Kombinacija je možna: pri klicu, katerega organizacija ima URL spletne kljuke, se orodja z endpoint pokličejo neposredno, preostala pa uporabijo spletno kljuko.

Neposredni klici končnih točk

Ko AI pokliče orodje, ki ima endpoint, ThunderPhone pošlje zahtevo na vaš URL:

Glave zahtev

POST /appointments/search HTTP/1.1
Host: api.example.com
Content-Type: application/json
X-ThunderPhone-Signature-V2: t=1767225600,v1=5f2c...
X-ThunderPhone-Signature: abc123...
X-ThunderPhone-Call-ID: 987654321
X-ThunderPhone-From-Number: +14155550199
X-ThunderPhone-To-Number: +14155550100
X-ThunderPhone-Call-Direction: inbound
X-Api-Key: your-api-key

Glave po meri iz vašega endpoint.headers so vedno vključene dobesedno, skupaj s temi glavami v imenskem prostoru ThunderPhone:

  • X-ThunderPhone-Signature-V2 — časovno označen HMAC-SHA256 za metodo, pot, poizvedbo in telo, podpisan z vašo skrivnostjo organizacije za spletne kljuke. Preverite ga in zavrnite zahteve, starejše od 5 minut; glejte Preverjanje podpisov spletnih kljuk
  • X-ThunderPhone-Signature — podedovani HMAC-SHA256 natančnih bajtov telesa zahteve z istim ključem, ki se še vedno pošilja za obstoječe preverjevalnike
  • X-ThunderPhone-Call-ID — ID trenutnega klica
  • X-ThunderPhone-From-Number in X-ThunderPhone-To-Number — številki From in To klica v obliki E.164. Pomenita enako kot from_number in to_number v telephony.complete: pri odhodnem klicu je From številka vašega agenta, To pa številka klicane osebe. Številka ni vključena, kadar je identifikacija klicatelja skrita ali ne gre za telefonsko številko
  • X-ThunderPhone-Call-Direction — inbound ali outbound, da lahko ugotovite, katera številka pripada stranki

Glave s številkami klicev se pošiljajo samo pri telefonskih klicih. Spletni, gradniški, sprotni in brskalniški preizkusi Talk nimajo telefonske številke in jih izpustijo. Preizkusni klici iz urejevalnika agenta in simulacije AI vsebujejo številko simuliranega klicatelja. Podpisi ne zajemajo glav: V2 podpiše časovni žig, metodo, pot, poizvedbo in telo. Če potrebujete podpisane številke, jih namesto tega preberite iz telesa: oblika zahteve retell vsebuje vse tri, vapi pa vsebuje številko stranke.

Content-Type: application/json je nastavljen, razen če ga vaš endpoint.headers prepiše — Content-Type po meri ima prednost.

Oblika zahteve

Vsaka povezava API ima nastavitev request_format. Izberite vapi ali retell, kadar naj uvoženo orodje še naprej kliče končno točko, zgrajeno za to platformo. Nove in obstoječe povezave privzeto uporabljajo standard.

Pri POST / PUT / PATCH ThunderPhone izbrano ovojnico serijsko obdela kanonično (razvrščeni ključi, strnjena ločila). Oba podpisa zajemata natanko te bajte.

Standard

standard pošlje samo argumente orodja, brez ovojnice. To je privzeta možnost in ohrani ThunderPhoneovo izvirno telo zahteve bajt za bajtom:

{"date":"2025-01-02","service":"consultation"}

Vapi

vapi pošlje Vapi-jevo strežniško sporočilo tool-calls v obliki, ki jo dokumentira Vapi. call.id je ID klica ThunderPhone. Pri telefonskih klicih je call.customer.number številka druge osebe, kot v Vapi-jevem objektu klica: klicatelja pri dohodnem klicu in osebe, ki jo kličete pri odhodnem klicu. Izpuščena je, kadar je ta številka skrita ali ni telefonska številka. id klica orodja je enoličen za priklic in se ponovno uporabi za ujemanje rezultata končne točke. Klic je prikazan v toolCallList in toolWithToolCallList, pri čemer je function.arguments objekt JSON:

{
  "message": {
    "type": "tool-calls",
    "timestamp": 1725000000123,
    "call": { "id": "987654321" },
    "toolCallList": [
      {
        "id": "call_00112233445566778899aabbccddeeff",
        "type": "function",
        "function": {
          "name": "search_appointments",
          "arguments": { "date": "2025-01-02", "service": "consultation" }
        }
      }
    ],
    "toolWithToolCallList": [
      {
        "type": "function",
        "function": { "name": "search_appointments" },
        "toolCall": {
          "id": "call_00112233445566778899aabbccddeeff",
          "type": "function",
          "function": {
            "name": "search_appointments",
            "arguments": { "date": "2025-01-02", "service": "consultation" }
          }
        }
      }
    ]
  }
}

Polja, ki veljajo samo za Vapi, kot so assistant, artifact in celoten objekt call, niso poslana.

Vrnite Vapi-jevo ovojnico odgovora z ujemajočim se ID-jem klica orodja:

{
  "results": [
    {
      "toolCallId": "call_00112233445566778899aabbccddeeff",
      "result": "{\"available_slots\":[\"9:00 AM\",\"2:00 PM\"]}"
    }
  ]
}

ThunderPhone agentu AI posreduje neoviti niz result. Zaradi združljivosti sprejme tudi vrednost JSON s končnih točk, ki jo že vračajo. error namesto result je agentu AI vrnjen kot napaka orodja. Če končna točka vrne nepravilno oblikovano ali neujemajočo se ovojnico Vapi, ThunderPhone zabeleži opozorilo in namesto prekinitve klica uporabi standardno razčlenjevanje odgovorov.

Retell

retell pošlje zahtevo, dokumentirano za funkcijo po meri Retell:

{
  "name": "search_appointments",
  "call": {
    "call_id": "987654321",
    "from_number": "+14155550199",
    "to_number": "+14155550100",
    "direction": "inbound"
  },
  "args": { "date": "2025-01-02", "service": "consultation" }
}

Pri telefonskih klicih objekt call vsebuje call_id, from_number, to_number in direction (inbound ali outbound), imena polj, ki jih uporablja Retellov objekt telefonskega klica. Ujemajo se z glavami s številko klica in so v nasprotju z glavami zajeta v obeh podpisih. Številka, ki je skrita ali ni telefonska številka, je izpuščena. Pri spletnih preizkusih, preizkusih gradnika, preizkusih v realnem času in preizkusih Talk v brskalniku vsebuje samo call_id. ThunderPhone ne vključuje polj, specifičnih za Retell, ki jih ob pošiljanju ne more zanesljivo zagotoviti, kot so agent_id, transcript, transcript_object, metadata ali dinamične spremenljivke. Retell sprejme poljubno telo odgovora; ThunderPhone ga posreduje s standardno obravnavo odgovorov.

Pri GET / DELETE so argumenti poslani kot parametri poizvedbe, telo pa je prazno ne glede na request_format. Podpis V2 zajema niz poizvedbe, kot je poslan; starejši podpis se izračuna na praznem nizu bajtov. Glejte Preverjanje podpisov webhookov.

Odgovor

Vrnite odgovor JSON z rezultatom orodja:

{
  "available_slots": ["9:00 AM", "2:00 PM", "4:30 PM"],
  "timezone": "America/Los_Angeles"
}

Odgovor je oblikovan in posredovan AI, da nadaljuje pogovor. Odgovori, ki niso JSON, so oviti kot {"data": "<text>"}; prekinitve zaradi časovne omejitve in povezave so AI sporočene kot napake, zato se lahko agent opraviči in nadaljuje, namesto da obstane.

Posredovanje v načinu webhook

Orodja brez endpoint so posredovana na URL starejšega webhooka vaše organizacije kot podpisana zahteva telephony.tool (telefonski klici) ali web.tool (spletni klici). Za razliko od obvestil za revizijo, dostavljenih na končne točke webhookov po izvedbi, ta zahteva je izvedba — vaš odgovor HTTP je rezultat orodja.

{
  "type": "telephony.tool",
  "data": {
    "call_id": 987654321,
    "tool_name": "search_appointments",
    "arguments": { "date": "2026-04-21" },
    "from_number": "+14155550199",
    "to_number": "+15551234567"
  }
}

web.tool namesto from_number / to_number vsebuje origin_domain. Odgovorite z rezultatom orodja v obliki JSON — z enako pogodbo odgovora kot pri neposrednih klicih končne točke. Zahteva je podpisana s skrivnostjo webhooka organizacije in vsebuje obe glavi podpisa, tako kot vsak drug webhook.


Dolgo čakanje: način čakanja in poznejši odgovor

Nekatera orodja čakajo na osebo: vodjo, ki odobri popust, ali lastnika, ki odgovori na vprašanje v Slacku. Za taka orodja nastavite wait_mode na "hold".

wait_mode: "updates" (privzeto)wait_mode: "hold"
Kaj sliši klicateljVrstico ob zagonu orodja, nato kratko vrstico »še vedno delam« po približno 12 s in drugo približno vsakih 15 sVrstico ob zagonu orodja, nato glasbo za čakanje, dokler ne prispe rezultat
Največja vrednost timeout180 s600 s
Čakajoči odgovoriPosredovani agentu kot rezultatOrodje ostane odprto, dokler ne dostavite rezultata

V načinu čakanja agent ob zagonu orodja izgovori eno vrstico (s svojimi besedami ali vrstico ob zagonu orodja, nastavljeno za agenta), nato klicatelj sliši glasbo za čakanje. Glasba postopoma utihne, preden agent izgovori rezultat. Orodje, ki odgovori v sekundi ali dveh, sploh ne predvaja glasbe. Ko se agent pogovarja s telefonskim menijem ali predalom glasovne pošte, namesto tega uporablja govorne posodobitve, saj bi glasbo lahko razumeli kot odgovor. To velja tudi za klic, za katerega se med čakanjem ugotovi, da gre za meni ali predal glasovne pošte: glasba se ustavi in prevzamejo jo govorne posodobitve. Enako velja za klic, pri katerem glasbe ni mogoče predvajati.

Če klicatelj med čakanjem govori, se glasba še naprej predvaja in agent še ne odgovori. Agent sliši, kaj je klicatelj povedal, in odgovori na to skupaj z rezultatom. Prekinitev klica konča klic in odprto orodje.

Odgovorite pozneje

Lastni odgovor vaše končne točke mora še vedno prispeti v 180 s. Če želite klicatelja zadržati dlje, takoj odgovorite s čakajočim rezultatom:

{ "status": "pending", "request_id": "ask-4471" }

request_id je poljuben niz do 200 znakov, ki na vaši strani prepozna to zahtevo. Klicatelj ostane na čakanju, dokler ne dostavite rezultata zanj z POST /v1/calls/{call_id}/tool-results. call_id je vrednost glave X-ThunderPhone-Call-ID zahteve orodja.

curl -X POST https://api.thunderphone.com/v1/calls/987654321/tool-results \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "ask-4471",
    "result": { "answer": "Yes, book Tuesday at 10." }
  }'

Agent prebere result kot odgovor orodja, enako kot če bi ga vrnila vaša končna točka. Če rezultat ne prispe pred timeout orodja, šteto od trenutka, ko je bilo orodje poklicano, je agent obveščen, da odgovor ni prispel, in klicatelju ponudi naslednje korake, na primer sprejem sporočila.

Rezultat lahko pošljete takoj, tudi preden vaš čakajoči odgovor doseže ThunderPhone. Koda 202 pomeni, da ga je klic sprejel: prevzela ga je odprta zahteva ali pa je lastna zahteva orodja še vedno v teku in ga bo prevzel njen čakajoči odgovor. Rezultat, ki ga ne prevzame nobena zahteva (vaša končna točka je nato za ta request_id odgovorila z nečim drugim kot s čakajočim odgovorom), se zavrže.

Če ima povezava preoblikovanje odgovora (kodo, ki prepiše odgovor vaše končne točke, preden ga vidi agent), se preoblikovanje izvede na lastnem odgovoru vaše končne točke, preden ThunderPhone preveri čakajoči odgovor, zato mora v čakajočem odgovoru ohraniti status in request_id. Ne izvede se na rezultatu, ki ga pošljete pozneje: agent prejme ta rezultat, kot ga pošljete.

Agent s polnim dupleksom nima glasbe za čakanje ali vrstic s posodobitvami, zato se na njegovih klicih orodje za čakanje obnaša kot orodje updates: čakajoči odgovor doseže agenta kot rezultat orodja.

Čakajoči odgovor orodja v načinu updates ne ostane odprt: agent ga prejme kot rezultat orodja.

Preverjanje podpisa

Neposredni klici orodij so podpisani enako kot spletne kljuke, pri čemer se uporablja skrivnost spletne kljuke vaše organizacije:

  • X-ThunderPhone-Signature-V2 podpiše časovni žig, metodo, pot in poizvedbo, kot so bili poslani, ter natančne bajte telesa. Zavrnite zahteve, katerih časovni žig odstopa od vaše ure za več kot 5 minut.
  • X-ThunderPhone-Signature (podedovana različica) podpiše samo bajte telesa, pri GET / DELETE pa prazen niz bajtov. Še vedno se pošilja nespremenjena.

Pomožne funkcije SDK preverijo glavo V2, vključno s 5-minutnim časovnim oknom:

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

Celotni postopki — podpisani niz, izdelan primer, koda brez SDK, primer GET / DELETE in opozorilo glede odsotnosti skrivnosti — so v Preverjanje podpisov spletnih kljuk.


Primer: celoten potek rezervacije

Tukaj je nabor orodij za celoten sistem rezervacije terminov:

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_appointments",
        "description": "Find available appointment slots",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "service": { "type": "string" }
          },
          "required": ["date"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/search",
        "method": "POST",
        "headers": { "X-Api-Key": "key" }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "book_appointment",
        "description": "Book an appointment at a specific time",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "time": { "type": "string", "description": "HH:MM format" },
            "customer_name": { "type": "string" },
            "customer_phone": { "type": "string" }
          },
          "required": ["date", "time", "customer_name"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/book",
        "method": "POST",
        "headers": { "X-Api-Key": "key" }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "cancel_appointment",
        "description": "Cancel an existing appointment",
        "parameters": {
          "type": "object",
          "properties": {
            "confirmation_number": { "type": "string" }
          },
          "required": ["confirmation_number"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/cancel",
        "method": "POST",
        "headers": { "X-Api-Key": "key" }
      }
    }
  ]
}

Zaženite orodje ob začetku klica

Orodje se lahko samodejno zažene tudi ob začetku vsakega telefonskega klica, preden agent izreče prvo besedo, da lahko pozdrav uporabi rezultat. Običajen primer je iskanje v CRM-ju po številki klicatelja: »Dobrodošli nazaj, Arthi! Ali želite svoje običajno naročilo?«

Na nadzorni plošči odprite povezavo API in nastavite Kdaj se zažene na Ob začetku vsakega telefonskega klica, nato pa vnesite vrednost, ki jo prejme vsak parameter. Prek API-ja nastavite trigger integracije na call_start in njene call_start_arguments (Povezave API) ali dodajte blok call_start v vgrajeno orodje:

{
  "type": "function",
  "function": {
    "name": "get_contact_by_phone",
    "description": "Look up a customer by phone number.",
    "parameters": {
      "type": "object",
      "properties": {
        "business_id": {"type": "string"},
        "phone_number": {"type": "string"}
      },
      "required": ["business_id", "phone_number"]
    }
  },
  "endpoint": {"url": "https://crm.example.com/contacts/lookup"},
  "call_start": {
    "arguments": {
      "business_id": "a0a81c23",
      "phone_number": "{{caller_number}}"
    }
  }
}

Argumenti potrebujejo vrednost za vsak zahtevani parameter, saj ob začetku klica nihče ničesar ne izpolni. Vrednosti so nizi, števila ali logične vrednosti. Shranijo in vrnejo se kot navadno besedilo, agent pa jih vidi, zato skrivnosti, kot so ključi API, hranite v glavah povezave, ne tukaj. Nizi lahko uporabljajo te označbe mesta:

Označba mestaVrednost
{{caller_number}}Druga oseba v klicu v obliki E.164, na primer +61402122887: klicatelj pri dohodnem klicu, klicana oseba pri odhodnem klicu
{{caller_number_national}}Ista številka v nacionalni obliki svoje države brez presledkov, na primer 0402122887
{{agent_number}}Lastna številka agenta

Delovanje:

  • Zahteva je enaka zahtevi, ki jo pošljejo klici agentovega orodja (ista končna točka, glave, oblika zahteve in podpis).
  • Orodje se zažene ob začetku klica in deluje, medtem ko se predvaja ton za vzpostavitev povezave, uvod ali obvestilo o snemanju. Pozdrav nanj od takrat čaka največ približno 3 sekunde. Počasnejši rezultat se agentu posreduje takoj, ko prispe, za preostanek klica. Pri odhodnem klicu se zažene, ko je klic vzpostavljen, zato se izvede pri vsakem poskusu, tudi pri tistih, na katere se nihče ne oglasi.
  • Pri agentu, kjer klicatelj govori prvi, ni pozdrava, ki bi moral čakati; agent prejme rezultat takoj, ko prispe.
  • Rezultat se agentu posreduje kot kontekst za celoten klic. V pozivu agentu povejte, kako naj ga uporabi; sicer se ne prebere na glas.
  • Če orodje ne uspe ali poteče časovna omejitev, agent pozdravi klicatelja kot običajno in o tem ne pove ničesar.
  • Agent lahko orodje pozneje med klicem še vedno pokliče sam.
  • Deluje pri telefonskih klicih, vključno s preskusnimi klici z nadzorne plošče na vaš telefon, in pri simulacijah AI, ki vaši končni točki pošljejo številko simuliranega klicatelja. Ne deluje pri preskusih Pogovor v brskalniku ali sejah spletnega gradnika, ki nimajo številke klicatelja, pri klicih s skrito identifikacijo klicatelja ali pri agentih s koraki.
  • Agent hkrati zažene največ tri orodja ob začetku klica.

V pozivu navedite rezultat, da agent ve, kako ga uporabiti, na primer: »Če je iskanje ob začetku klica našlo klicatelja, ga pozdravite z imenom.«


Najboljše prakse

Napišite jasne opise

Polje description pomaga UI razumeti, kdaj uporabiti orodje. Natančno opišite, kaj počne in kdaj ga je primerno uporabiti.

Ustrezno obravnavajte napake

Vrnite sporočila o napakah, ki jih UI razume: {"error": "No slots available for that date"} namesto splošnih napak 500.

Odgovori naj bodo jedrnati

Vrnite samo tisto, kar AI potrebuje za nadaljevanje pogovora. Rezultat orodja ostane v pogovoru in se znova prebere pri vsakem naslednjem koraku, zato velik rezultat poveča stroške in zakasnitev preostanka klica. Rezultati, daljši od 100.000 znakov, se skrajšajo na predogled, za katerega AI ve, da je nepopoln, pri zelo dolgem klicu pa se lahko starejši rezultati odstranijo (AI lahko orodje znova pokliče). Dodajte parameter, da lahko AI hkrati poišče en element ali kategorijo, večjo referenčno vsebino, kot so meniji ali katalogi, pa shranite v bazo znanja. Pošljite preskusno zahtevo na nadzorni plošči prikaže velikost vsakega rezultata in opozori, kadar je velik.

Polja, ki so obvezna, uporabljajte premišljeno

Polja označite kot required le, kadar je to res potrebno. UI bo pred klicem orodja uporabnika vprašala za zahtevane informacije.


Sorodno