ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Function Tools

Funkcijski alati

Omogućite svojim AI agentima funkcijske alate koji tijekom razgovora pozivaju vanjske API-je — dohvaćaju podatke o korisnicima, rezerviraju termine, ažuriraju zapise — s tipiziranim parametrima.

Funkcijski alati omogućuju vašim AI agentima pozivanje vanjskih API-ja tijekom telefonskih poziva. Upotrijebite ih za dohvaćanje podataka o korisnicima, provjeru dostupnosti, rezerviranje termina ili izvođenje bilo koje radnje koju vaš pozadinski sustav podržava.

Kako funkcionira

  1. Definirate alate sa shemom (koje argumente alat prihvaća)
  2. Navodite konfiguraciju endpoint (gdje ThunderPhone poziva vaš API) — ili je izostavite kako biste pozive alata primali na webhooku svoje organizacije
  3. Tijekom poziva AI odlučuje kada upotrijebiti alat na temelju razgovora
  4. ThunderPhone poziva vašu krajnju točku s argumentima alata
  5. Odgovor vašeg API-ja vraća se AI-ju radi nastavka razgovora
MogućnostGdje se izvršavaPostavljanje
Ugrađeni alatiThunderPhoneUpute u promptu; neki alati zahtijevaju i postavku agenta
Povezivanja aplikacijaThunderPhone i povezani pružatelj uslugePovežite račun i priložite odobrene radnje
API povezivanja i funkcijski alatiVaš HTTP APIDefinirajte krajnju točku i shemu ili primajte pozive funkcija putem webhooka
MCP poslužiteljiUdaljeni MCP poslužiteljDodajte poslužitelj, otkrijte njegove alate i priložite ga agentu

Shema alata

Svaki alat slijedi ovu strukturu:

{
  "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 alata

PoljeVrstaObaveznoOpis
timeoutbrojNeMaksimalno vrijeme izvršavanja u sekundama (zadano: 20, najviše: 180 ili 600 uz wait_mode: "hold")
wait_modeniz znakovaNeŠto pozivatelj čuje dok se alat izvršava: updates (zadano), kratka govorna ažuriranja; ili hold, glazbu na čekanju. Pogledajte Duga čekanja: način rada na čekanju i kasniji odgovor
call_startobjektNeTakođer automatski pokrenite alat na početku svakog telefonskog poziva, prije pozdrava. Pogledajte Pokrenite alat na početku poziva

Definicija funkcije

PoljeVrstaObaveznoOpis
nameniz znakovaDaIdentifikator alata, jedinstven među alatima jednog poziva. Različiti agenti mogu imati vlastiti alat s istim nazivom
descriptionniz znakovaDaObjašnjava AI-ju kada koristiti ovaj alat
parametersobjektDaJSON shema za argumente alata

Konfiguracija krajnje točke

PoljeVrstaObaveznoOpis
urlniz znakovaDaURL krajnje točke vašeg API-ja
methodniz znakovaNeHTTP metoda (zadano: POST)
headersobjektNePrilagođena zaglavlja koja treba uključiti

Dva načina pozivanja

Zahtjev koji vaš poslužitelj primi ovisi o tome ima li alat endpoint:

Alat s endpointAlat bez endpoint
Odredište zahtjevaIzravno na endpoint.urlZastarjeli URL webhooka vaše organizacije
TijeloOdabrani format zahtjeva (prema zadanim postavkama samo argumenti)Omotnica telephony.tool / web.tool
ZaglavljaVaša endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, kao i brojevi poziva pri telefonskim pozivimaContent-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature
Ključ za potpisivanjeTajna webhooka organizacijeTajna webhooka organizacije

Oba su puta blokirajuća — AI usred rečenice čeka rezultat. Zadano vrijeme isteka je 20 s; postavite timeout na najvišoj razini alata kako biste omogućili dulje izvršavanje, do najvećih 180 s koje platforma dopušta. Održavajte rukovatelje brzim. Za čekanje osobe ili sporog zadatka koristite način čekanja. Kombinacija je u redu: u pozivu čija organizacija ima URL webhooka alati s endpoint pozivaju se izravno, a ostali se vraćaju na webhook.

Izravni pozivi krajnjih točaka

Kada AI pozove alat koji ima endpoint, ThunderPhone šalje zahtjev na Vaš URL:

Zaglavlja zahtjeva

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

Prilagođena zaglavlja iz vašeg endpoint.headers uvijek se uključuju doslovno, uz ova zaglavlja u imenskom prostoru ThunderPhone:

  • X-ThunderPhone-Signature-V2 — HMAC-SHA256 s vremenskom oznakom nad metodom, putanjom, upitom i tijelom, s ključem koji je vaša tajna webhooka organizacije. Provjerite ovaj potpis i odbacite zahtjeve starije od 5 minuta; pogledajte Provjera potpisa webhooka
  • X-ThunderPhone-Signature — naslijeđeni HMAC-SHA256 točnih bajtova tijela zahtjeva, s istim ključem, i dalje se šalje za postojeće provjere
  • X-ThunderPhone-Call-ID — Trenutačni ID poziva
  • X-ThunderPhone-From-Number i X-ThunderPhone-To-Number — brojevi From i To poziva u formatu E.164. Znače isto što i from_number i to_number u telephony.complete: pri odlaznom pozivu From je broj vašeg agenta, a To je broj pozvane osobe. Broj se izostavlja kada je ID pozivatelja skriven ili nije telefonski broj
  • X-ThunderPhone-Call-Direction — inbound ili outbound, tako da možete utvrditi koji je broj korisnikov

Zaglavlja s brojevima poziva šalju se samo pri telefonskim pozivima. Web, widget, realtime i Talk testovi u pregledniku nemaju telefonski broj pa ih izostavljaju. Testni pozivi iz uređivača agenta i AI simulacije sadrže broj simuliranog pozivatelja. Potpisi ne obuhvaćaju zaglavlja: V2 potpisuje vremensku oznaku, metodu, putanju, upit i tijelo. Ako trebate potpisane brojeve, umjesto toga ih pročitajte iz tijela: format zahtjeva retell sadrži sva tri, a vapi sadrži broj korisnika.

Content-Type: application/json postavlja se osim ako ga Vaš endpoint.headers ne nadjača — prilagođeni Content-Type ima prednost.

Format zahtjeva

Svaka API veza ima postavku request_format. Odaberite vapi ili retell kada uvezeni alat treba nastaviti pozivati krajnju točku izrađenu za tu platformu. Nove i postojeće veze zadano koriste standard.

Za POST / PUT / PATCH, ThunderPhone kanonski serijalizira odabranu omotnicu (sortirani ključevi, sažeti razdjelnici). Oba potpisa obuhvaćaju točno te bajtove.

Standard

standard šalje samo argumente alata, bez omotača. Ovo je zadana opcija i čuva izvorno tijelo zahtjeva ThunderPhonea bajt po bajt:

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

Vapi

vapi šalje Vapi-jevu poslužiteljsku poruku tool-calls u obliku koji Vapi dokumentira. call.id je ID ThunderPhone poziva. U telefonskim pozivima call.customer.number je broj druge strane, kao u Vapi-jevu objektu poziva: pozivatelja za dolazni poziv, odnosno osobe koja se poziva za odlazni poziv. Izostavlja se kada je taj broj skriven ili nije telefonski broj. id poziva alata jedinstven je za pozivanje i ponovno se koristi za podudaranje s rezultatom krajnje točke. Poziv se pojavljuje i u toolCallList i u toolWithToolCallList, pri čemu je function.arguments JSON objekt:

{
  "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 samo za Vapi, kao što su assistant, artifact i cijeli objekt call, ne šalju se.

Vratite Vapi-jevu omotnicu odgovora s odgovarajućim ID-jem poziva alata:

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

ThunderPhone AI-ju daje raspakiranu vrijednost niza result. Prihvaća i JSON vrijednost radi kompatibilnosti s krajnjim točkama koje je već vraćaju. error umjesto result vraća se AI-ju kao pogreška alata. Ako krajnja točka vrati neispravnu ili nepodudarajuću Vapi omotnicu, ThunderPhone bilježi upozorenje i vraća se na standardnu obradu odgovora umjesto da prekine poziv.

Retell

retell šalje zahtjev dokumentiran za prilagođenu funkciju Retell:

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

U telefonskim pozivima objekt call sadrži call_id, from_number, to_number i direction (inbound ili outbound), nazive polja koje upotrebljava Retellov objekt telefonskog poziva. Oni odgovaraju zaglavljima broja poziva, a za razliku od zaglavlja obuhvaćeni su obama potpisima. Broj koji je skriven ili nije telefonski broj izostavlja se. U testovima Talk na webu, u widgetu, u stvarnom vremenu i pregledniku sadrži samo call_id. ThunderPhone ne uključuje polja specifična za Retell koja pri slanju ne može pouzdano pružiti, kao što su agent_id, transcript, transcript_object, metadata ili dinamičke varijable. Retell prihvaća bilo koje tijelo odgovora; ThunderPhone ga prosljeđuje uz standardnu obradu odgovora.

Za GET / DELETE, argumenti se šalju kao parametri upita i tijelo je prazno neovisno o request_format. Potpis V2 obuhvaća niz upita onako kako je poslan; naslijeđeni potpis izračunava se nad praznim nizom bajtova. Pogledajte Provjera potpisa webhooka.

Odgovor

Vratite JSON odgovor s rezultatom alata:

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

Odgovor se formatira i dostavlja AI-ju kako bi nastavio razgovor. Odgovori koji nisu JSON omataju se kao {"data": "<text>"}; vremenska ograničenja i neuspjele veze prijavljuju se AI-ju kao pogreške, pa se agent može ispričati i nastaviti umjesto da zastane.

Slanje u načinu webhooka

Alati bez endpoint šalju se na URL naslijeđenog webhooka Vaše organizacije kao potpisani zahtjev telephony.tool (telefonski pozivi) ili web.tool (web-pozivi). Za razliku od obavijesti o reviziji koje se dostavljaju na krajnje točke webhooka nakon izvršavanja, ovaj zahtjev jest izvršavanje — Vaš HTTP odgovor rezultat je alata.

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

web.tool sadrži origin_domain umjesto from_number / to_number. Odgovorite rezultatom alata u JSON formatu — uz isti ugovor odgovora kao i za izravne pozive krajnje točke. Zahtjev je potpisan tajnom webhooka organizacije, s oba zaglavlja potpisa, kao i svaki drugi webhook.


Duga čekanja: način čekanja i kasniji odgovor

Neki alati čekaju osobu: voditelja koji odobrava popust, vlasnika koji odgovara na pitanje u Slacku. Za te alate postavite wait_mode na "hold".

wait_mode: "updates" (zadano)wait_mode: "hold"
Što pozivatelj čujePočetnu poruku alata, zatim kratku poruku „još radim” nakon otprilike 12 s i drugu otprilike svakih 15 sPočetnu poruku alata, zatim glazbu na čekanju dok rezultat ne stigne
Maksimalni timeout180 s600 s
Odgovori na čekanjuProsljeđuju se agentu kao rezultatAlat ostaje otvoren dok ne dostavite rezultat

U načinu čekanja agent izgovori jednu rečenicu pri pokretanju alata (vlastitim riječima ili početnu poruku alata postavljenu na agentu), a zatim pozivatelj čuje glazbu na čekanju. Glazba postupno utihne prije nego što agent izgovori rezultat. Alat koji odgovori unutar jedne ili dvije sekunde uopće ne pokreće glazbu. Kada agent razgovara s telefonskim izbornikom ili govornom poštom, umjesto toga koristi glasovne obavijesti jer bi se glazba mogla čuti kao odgovor. To uključuje poziv za koji se tijekom čekanja utvrdi da je izbornik ili govorna pošta: glazba se zaustavlja, a glasovne obavijesti preuzimaju. Isto vrijedi i za poziv na kojem se glazba ne može reproducirati.

Ako pozivatelj govori tijekom čekanja, glazba nastavlja svirati, a agent još ne odgovara. Čuje što je pozivatelj rekao i odgovara na to zajedno s rezultatom. Prekid poziva završava poziv i otvoreni alat.

Odgovorite kasnije

Vlastiti odgovor vaše krajnje točke i dalje mora stići unutar 180 s. Kako biste pozivatelja zadržali dulje, odmah odgovorite rezultatom na čekanju:

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

request_id je bilo koji niz do 200 znakova koji na vašoj strani identificira ovaj zahtjev. Pozivatelj ostaje na čekanju dok mu ne dostavite rezultat putem POST /v1/calls/{call_id}/tool-results. call_id je zaglavlje X-ThunderPhone-Call-ID zahtjeva alata.

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 čita result kao odgovor alata, jednako kao da ga je vratila vaša krajnja točka. Ako rezultat ne stigne prije isteka timeout vrijednosti alata, računajući od trenutka kada je alat pozvan, agentu se javlja da odgovor nije stigao te pozivatelju nudi sljedeće korake, primjerice ostavljanje poruke.

Rezultat možete poslati čim želite, čak i prije nego što vaš odgovor na čekanju stigne do ThunderPhonea. Kod 202 znači da ga je poziv prihvatio: preuzeo ga je otvoreni zahtjev ili je vlastiti zahtjev alata još u tijeku pa će ga preuzeti njegov odgovor na čekanju. Rezultat koji nijedan zahtjev nikada ne preuzme (vaša krajnja točka zatim odgovori nečim drugim osim odgovora na čekanju za taj request_id) odbacuje se.

Ako veza ima transformaciju odgovora (kôd koji prepisuje odgovor vaše krajnje točke prije nego što ga agent vidi), transformacija se pokreće nad vlastitim odgovorom vaše krajnje točke prije nego što ThunderPhone provjeri postoji li odgovor na čekanju, stoga u odgovoru na čekanju mora zadržati status i request_id. Ne pokreće se nad rezultatom koji kasnije pošaljete: agent taj rezultat dobiva onako kako ga pošaljete.

Agent s punim dupleksom nema glazbu na čekanju ni poruke o ažuriranju, pa se na njegovim pozivima alat na čekanju ponaša kao alat updates: odgovor na čekanju stiže do agenta kao rezultat alata.

Odgovor na čekanju alata u načinu updates ne ostaje otvoren: agent ga prima kao rezultat alata.

Provjera potpisa

Izravni pozivi alata potpisuju se na isti način kao webhookovi, s pomoću tajne webhooka vaše organizacije:

  • X-ThunderPhone-Signature-V2 potpisuje vremensku oznaku, metodu, putanju i upit onako kako su poslani te točne bajtove tijela. Odbijte zahtjeve čija je vremenska oznaka udaljena više od 5 minuta od vremena na vašem satu.
  • X-ThunderPhone-Signature (naslijeđeni) potpisuje samo bajtove tijela, odnosno prazan niz bajtova za GET / DELETE. I dalje se šalje, neizmijenjen.

Pomoćne funkcije SDK-a provjeravaju zaglavlje V2, uključujući vremenski okvir od 5 minuta:

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

Cjeloviti primjeri — potpisani niz, razrađeni primjer, kôd bez SDK-a, slučaj GET / DELETE i napomena za slučaj bez tajne — nalaze se u odjeljku Provjera potpisa webhookova.


Primjer: potpuni tijek rezervacije

Evo skupa alata za potpuni sustav rezervacije termina:

{
  "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" }
      }
    }
  ]
}

Pokretanje alata na početku poziva

Alat se može automatski pokrenuti i na početku svakog telefonskog poziva, prije nego što agent izgovori prvu riječ, kako bi pozdrav mogao koristiti rezultat. Uobičajen je slučaj CRM pretraživanje prema broju pozivatelja: "Dobro nam se vratili, Arthi! Želite li svoju uobičajenu narudžbu?"

Na nadzornoj ploči otvorite API vezu i postavite Kada se pokreće na Na početku svakog telefonskog poziva, a zatim unesite vrijednost koju dobiva svaki parametar. Putem API-ja postavite trigger integracije na call_start i njezin call_start_arguments (API veze) ili dodajte blok call_start ugrađenom alatu:

{
  "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 trebaju vrijednost za svaki obavezni parametar jer nitko ne unosi ništa na početku poziva. Vrijednosti su nizovi znakova, brojevi ili Booleove vrijednosti. Pohranjuju se i vraćaju kao običan tekst te ih agent vidi, stoga tajne, poput API ključeva, čuvajte u zaglavljima veze, a ne ovdje. Nizovi znakova mogu koristiti ova mjesta za umetanje:

Mjesto za umetanjeVrijednost
{{caller_number}}Druga osoba u pozivu u formatu E.164, npr. +61402122887: pozivatelj u dolaznom pozivu, pozvana osoba u odlaznom pozivu
{{caller_number_national}}Isti broj u nacionalnom formatu njegove države bez razmaka, npr. 0402122887
{{agent_number}}Vlastiti broj agenta

Kako funkcionira:

  • Zahtjev je isti kao onaj koji šalju pozivi alata samog agenta (ista krajnja točka, zaglavlja, format zahtjeva i potpis).
  • Alat se pokreće kada započne poziv i radi dok se reproducira bilo koji ton uspostavljanja veze, uvodna poruka ili obavijest o snimanju. Pozdrav čeka rezultat najviše približno 3 sekunde od tog trenutka. Sporiji rezultat daje se agentu čim stigne, za ostatak poziva. U odlaznom pozivu pokreće se kada se poziv uputi, pa se izvršava pri svakom pokušaju, uključujući one na koje nitko ne odgovori.
  • Kod agenta kod kojeg pozivatelj prvi govori nema pozdrava koji treba čekati; agent dobiva rezultat čim stigne.
  • Rezultat se daje agentu kao kontekst za cijeli poziv. U upitu navedite agentu kako ga koristiti; inače se ne čita naglas.
  • Ako alat ne uspije ili istekne vrijeme, agent pozdravlja pozivatelja kao što bi inače i ne govori ništa o tome.
  • Agent i dalje može sam pozvati alat kasnije tijekom poziva.
  • Pokreće se u telefonskim pozivima, uključujući testne pozive s nadzorne ploče na vaš telefon, i u AI simulacijama, koje vašoj krajnjoj točki šalju broj simuliranog pozivatelja. Ne pokreće se u testovima Razgovor u pregledniku ni u sesijama web-widgeta, koje nemaju broj pozivatelja, u pozivima sa skrivenim ID-om pozivatelja ni kod agenata s koracima.
  • Agent pokreće najviše tri alata na početku poziva, sve istodobno.

Spomenite rezultat u upitu kako bi agent znao kako ga koristiti, na primjer: "Ako je pretraživanje na početku poziva pronašlo pozivatelja, pozdravite ga imenom."


Najbolje prakse

Napišite jasne opise

Polje description pomaže AI-ju razumjeti kada upotrijebiti alat. Jasno navedite što alat radi i kada ga je prikladno upotrijebiti.

Pravilno obradite pogreške

Vratite poruke o pogreškama koje AI može razumjeti: {"error": "No slots available for that date"} umjesto generičkih pogrešaka 500.

Neka odgovori budu sažeti

Vratite samo ono što AI-ju treba za nastavak razgovora. Rezultat alata ostaje u razgovoru i ponovno se čita u svakom sljedećem koraku, pa velik rezultat povećava trošak i kašnjenje tijekom ostatka poziva. Rezultati dulji od 100.000 znakova skraćuju se na pregled za koji AI zna da je nepotpun, a tijekom vrlo dugog poziva stariji se rezultati mogu odbaciti (AI može ponovno pozvati alat). Dodajte parametar kako bi AI mogao dohvatiti jednu stavku ili kategoriju odjednom, a veliki referentni sadržaj, poput jelovnika ili kataloga, smjestite u bazu znanja. Pošaljite testni zahtjev na nadzornoj ploči prikazuje veličinu svakog rezultata i upozorava kada je velik.

Razumno koristite obavezna polja

Označite polja kao required samo kada je to zaista potrebno. AI će od korisnika zatražiti obavezne informacije prije pozivanja alata.


Povezano