ThunderPhone v3 ഇപ്പോൾ ലൈവാണ്.സ്വയം തുടങ്ങാം — 2¢/മിനിറ്റ് മുതൽ.പ്രഖ്യാപനം വായിക്കുക

Function Tools

ഫംഗ്ഷൻ ടൂളുകൾ

സംഭാഷണത്തിനിടയിൽ ബാഹ്യ API-കളെ വിളിക്കുന്ന ഫംഗ്ഷൻ ടൂളുകൾ നിങ്ങളുടെ AI ഏജന്റുകൾക്ക് നൽകുക — ഉപഭോക്തൃ ഡാറ്റ നേടുക, അപ്പോയിന്റ്മെന്റുകൾ ബുക്ക് ചെയ്യുക, റെക്കോർഡുകൾ അപ്ഡേറ്റ് ചെയ്യുക — ടൈപ്പ് ചെയ്ത പാരാമീറ്ററുകളോടെ.

ഫംഗ്ഷൻ ടൂളുകൾ നിങ്ങളുടെ AI ഏജന്റുകൾക്ക് ഫോൺ കോളുകൾക്കിടെ ബാഹ്യ API-കൾ പ്രവർത്തിപ്പിക്കാൻ അനുവദിക്കുന്നു. ഉപഭോക്തൃ ഡാറ്റ കണ്ടെത്താനും, ലഭ്യത പരിശോധിക്കാനും, അപ്പോയിന്റ്മെന്റുകൾ ബുക്ക് ചെയ്യാനും, അല്ലെങ്കിൽ നിങ്ങളുടെ ബാക്കെൻഡ് പിന്തുണയ്ക്കുന്ന ഏതെങ്കിലും പ്രവർത്തനം നടത്താനും അവ ഉപയോഗിക്കുക.

ഇത് എങ്ങനെ പ്രവർത്തിക്കുന്നു

  1. നിങ്ങൾ ഒരു സ്കീമ ഉപയോഗിച്ച് ടൂളുകൾ നിർവചിക്കുന്നു (ടൂൾ സ്വീകരിക്കുന്ന ആർഗ്യുമെന്റുകൾ)
  2. നിങ്ങൾ ഒരു endpoint കോൺഫിഗറേഷൻ നൽകുന്നു (ThunderPhone നിങ്ങളുടെ API വിളിക്കുന്ന സ്ഥലം) — അല്ലെങ്കിൽ നിങ്ങളുടെ ഓർഗനൈസേഷൻ വെബ്ഹുക്കിൽ ടൂൾ കോളുകൾ ലഭിക്കാൻ ഇത് ഒഴിവാക്കുക
  3. കോളിനിടെ, സംഭാഷണത്തെ അടിസ്ഥാനമാക്കി ടൂൾ എപ്പോൾ ഉപയോഗിക്കണമെന്ന് AI തീരുമാനിക്കുന്നു
  4. ThunderPhone ടൂൾ ആർഗ്യുമെന്റുകളോടെ നിങ്ങളുടെ endpoint വിളിക്കുന്നു
  5. സംഭാഷണം തുടരുന്നതിനായി നിങ്ങളുടെ API പ്രതികരണം AI-യിലേക്ക് തിരികെ നൽകുന്നു
ശേഷിഇത് പ്രവർത്തിക്കുന്ന സ്ഥലംസജ്ജീകരണം
ബിൽറ്റ്-ഇൻ ടൂളുകൾThunderPhonePrompt നിർദ്ദേശങ്ങൾ; ചില ടൂളുകൾക്ക് ഏജന്റ് ക്രമീകരണവും ആവശ്യമാണ്
ആപ്പ് കണക്ഷനുകൾThunderPhone-ഉം കണക്റ്റ് ചെയ്ത പ്രൊവൈഡറുംഅക്കൗണ്ട് കണക്റ്റ് ചെയ്ത് അംഗീകരിച്ച പ്രവർത്തനങ്ങൾ അറ്റാച്ച് ചെയ്യുക
API കണക്ഷനുകൾ, ഫംഗ്ഷൻ ടൂളുകൾനിങ്ങളുടെ HTTP APIendpoint-ഉം സ്കീമയും നിർവചിക്കുക, അല്ലെങ്കിൽ വെബ്ഹുക്ക് വഴി ഫംഗ്ഷൻ കോളുകൾ സ്വീകരിക്കുക
MCP സെർവറുകൾഒരു റിമോട്ട് MCP സെർവർസെർവർ ചേർക്കുക, അതിന്റെ ടൂളുകൾ കണ്ടെത്തുക, ഏജന്റിലേക്ക് അറ്റാച്ച് ചെയ്യുക

ടൂൾ സ്കീമ

ഓരോ ടൂളും ഈ ഘടന പിന്തുടരുന്നു:

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

ടൂൾ കോൺഫിഗറേഷൻ

ഫീൽഡ്തരംആവശ്യമാണ്വിവരണം
timeoutനമ്പർഇല്ലസെക്കൻഡുകളിലെ പരമാവധി നിർവഹണ സമയം (സ്ഥിരസ്ഥിതി: 20, പരമാവധി: 180, അല്ലെങ്കിൽ wait_mode: "hold" ഉപയോഗിച്ച് 600)
wait_modeസ്ട്രിംഗ്ഇല്ലടൂൾ പ്രവർത്തിക്കുമ്പോൾ കോളർ കേൾക്കുന്നത്: updates (സ്ഥിരസ്ഥിതി), ഹ്രസ്വമായ വാചിക അപ്‌ഡേറ്റുകൾ; അല്ലെങ്കിൽ hold, ഹോൾഡ് സംഗീതം. ദൈർഘ്യമേറിയ കാത്തിരിപ്പുകൾ: ഹോൾഡ് മോഡും പിന്നീട് മറുപടി നൽകലും കാണുക
call_startഒബ്ജക്റ്റ്ഇല്ലഎല്ലാ ഫോൺ കോളുകളുടെയും തുടക്കത്തിൽ, അഭിവാദ്യത്തിന് മുമ്പ്, ടൂൾ സ്വയമേവ പ്രവർത്തിപ്പിക്കാനും കഴിയും. കോളിന്റെ തുടക്കത്തിൽ ഒരു ടൂൾ പ്രവർത്തിപ്പിക്കുക കാണുക

ഫംഗ്ഷൻ നിർവചനം

ഫീൽഡ്തരംആവശ്യമാണ്വിവരണം
nameസ്ട്രിംഗ്അതെഒരു കോളിലെ ടൂളുകൾക്കിടയിൽ അദ്വിതീയമായ ടൂളിന്റെ ഐഡന്റിഫയർ. വ്യത്യസ്ത ഏജന്റുകൾക്ക് ഒരേ പേരിലുള്ള സ്വന്തം ടൂൾ ഉണ്ടായിരിക്കാം
descriptionസ്ട്രിംഗ്അതെഈ ടൂൾ എപ്പോൾ ഉപയോഗിക്കണമെന്ന് AI-യോട് വിശദീകരിക്കുന്നു
parametersഒബ്ജക്റ്റ്അതെടൂൾ ആർഗ്യുമെന്റുകൾക്കുള്ള JSON Schema

Endpoint കോൺഫിഗറേഷൻ

ഫീൽഡ്തരംആവശ്യമാണ്വിവരണം
urlസ്ട്രിംഗ്ഉണ്ട്നിങ്ങളുടെ API endpoint URL
methodസ്ട്രിംഗ്ഇല്ലHTTP രീതി (സ്ഥിരസ്ഥിതി: POST)
headersഒബ്ജക്റ്റ്ഇല്ലഉൾപ്പെടുത്തേണ്ട ഇഷ്ടാനുസൃത ഹെഡറുകൾ

രണ്ട് ഇൻവൊക്കേഷൻ പാതകൾ

നിങ്ങളുടെ സെർവറിന് ലഭിക്കുന്ന അഭ്യർത്ഥന, ടൂളിന് endpoint ഉണ്ടോ എന്നതിനെ ആശ്രയിച്ചിരിക്കുന്നു:

endpoint ഉള്ള ടൂൾendpoint ഇല്ലാത്ത ടൂൾ
അഭ്യർത്ഥന പോകുന്ന സ്ഥലംനേരിട്ട് endpoint.url-ലേക്ക്നിങ്ങളുടെ ഓർഗനൈസേഷന്റെ ലെഗസി വെബ്ഹുക്ക് URL
ബോഡിതിരഞ്ഞെടുത്ത അഭ്യർത്ഥന ഫോർമാറ്റ് (സ്ഥിരസ്ഥിതിയായി ആർഗ്യുമെന്റുകൾ മാത്രം)telephony.tool / web.tool എൻവലപ്പ്
ഹെഡറുകൾനിങ്ങളുടെ endpoint.headers + X-ThunderPhone-Call-ID + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature, കൂടാതെ ഫോൺ കോളുകളിൽ കോളിന്റെ നമ്പറുകൾContent-Type + X-ThunderPhone-Signature-V2 + X-ThunderPhone-Signature
സൈനിംഗ് കീഓർഗ് വെബ്ഹുക്ക് രഹസ്യംഓർഗ് വെബ്ഹുക്ക് രഹസ്യം

രണ്ട് പാതകളും തടയുന്നതാണ് — ഫലത്തിനായി AI വാക്യത്തിനിടയിൽ കാത്തിരിക്കുന്നു. ഡിഫോൾട്ട് സമയപരിധി 20 സെ ആണ്; 180 സെ പ്ലാറ്റ്ഫോം പരമാവധി വരെ ദൈർഘ്യമേറിയ നിർവഹണം അനുവദിക്കാൻ ടൂളിന്റെ ഉയർന്നതല timeout സജ്ജമാക്കുക. ഹാൻഡ്‌ലറുകൾ വേഗത്തിൽ നിലനിർത്തുക. ഒരു വ്യക്തിയെയോ മന്ദഗതിയിലുള്ള ജോബിനെയോ കാത്തിരിക്കേണ്ടിവരുമ്പോൾ hold mode ഉപയോഗിക്കുക. ഇവയുടെ മിശ്രണം ഉപയോഗിക്കാം: webhook URL ഉള്ള ഒരു org-ന്റെ കോളിൽ, endpoint ഉള്ള ടൂളുകൾ നേരിട്ട് വിളിക്കപ്പെടുകയും ബാക്കിയുള്ളവ webhook-ലേക്ക് മടങ്ങുകയും ചെയ്യും.

നേരിട്ടുള്ള എൻഡ്പോയിന്റ് കോൾകൾ

AI ഒരു endpoint ഉള്ള ടൂൾ ഇൻവോക്ക് ചെയ്യുമ്പോൾ, ThunderPhone നിങ്ങളുടെ URL-ലേക്ക് ഒരു അഭ്യർത്ഥന അയയ്ക്കുന്നു:

അഭ്യർത്ഥന ഹെഡറുകൾ

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

നിങ്ങളുടെ endpoint.headers-ലെ ഇഷ്ടാനുസൃത ഹെഡറുകൾ എല്ലായ്പ്പോഴും അതേപടി ഉൾപ്പെടുത്തും, കൂടാതെ ഈ ThunderPhone-നെയിംസ്‌പേസ്ഡ് ഹെഡറുകളും ഉൾപ്പെടും:

  • X-ThunderPhone-Signature-V2 — മെത്തഡ്, പാത്ത്, ക്വറി, ബോഡി എന്നിവയിൽ നിങ്ങളുടെ ഓർഗിന്റെ വെബ്ഹുക്ക് സീക്രട്ട് ഉപയോഗിച്ച് സൃഷ്ടിച്ച ടൈംസ്റ്റാമ്പ് ഉൾക്കൊള്ളുന്ന HMAC-SHA256. ഇത് പരിശോധിച്ച് 5 മിനിറ്റിലധികം പഴക്കമുള്ള അഭ്യർത്ഥനകൾ നിരസിക്കുക; കാണുക വെബ്ഹുക്ക് സിഗ്നേച്ചറുകൾ പരിശോധിക്കുക
  • X-ThunderPhone-Signature — കൃത്യമായ റിക്വസ്റ്റ്-ബോഡി ബൈറ്റുകളുടെ ലെഗസി HMAC-SHA256, അതേ കീ ഉപയോഗിക്കുന്നു, നിലവിലുള്ള വെരിഫയറുകൾക്കായി ഇപ്പോഴും അയയ്ക്കുന്നു
  • X-ThunderPhone-Call-ID — നിലവിലെ കോൾ ID
  • X-ThunderPhone-From-Number, X-ThunderPhone-To-Number — കോൾ ചെയ്യുന്നവന്റെയും സ്വീകരിക്കുന്നവന്റെയും E.164 നമ്പറുകൾ. ഇവ telephony.complete ലെ from_number, to_number എന്നിവയ്ക്ക് തുല്യമാണ്: ഔട്ട്ബൗണ്ട് കോളിൽ, From നിങ്ങളുടെ ഏജന്റിന്റെ നമ്പറും To വിളിക്കപ്പെടുന്ന വ്യക്തിയുമാണ്. കോളർ ID മറച്ചുവെച്ചിരിക്കുമ്പോഴോ അത് ഫോൺ നമ്പർ അല്ലാതിരിക്കുമ്പോഴോ ഒരു നമ്പർ ഒഴിവാക്കപ്പെടും
  • X-ThunderPhone-Call-Direction — inbound അല്ലെങ്കിൽ outbound, അതിനാൽ ഉപഭോക്താവിന്റെ നമ്പർ ഏതാണ് എന്ന് നിങ്ങൾക്ക് തിരിച്ചറിയാം

കോൾ-നമ്പർ ഹെഡറുകൾ ഫോൺ കോളുകളിൽ മാത്രമാണ് അയയ്ക്കുന്നത്. വെബ്, വിജറ്റ്, റിയൽടൈം, ബ്രൗസർ Talk ടെസ്റ്റുകൾക്ക് ഫോൺ നമ്പർ ഇല്ലാത്തതിനാൽ അവ ഒഴിവാക്കുന്നു. ഏജന്റ് എഡിറ്ററിൽ നിന്നുള്ള ടെസ്റ്റ് കോളുകളും AI സിമുലേഷനുകളും സിമുലേറ്റ് ചെയ്ത കോളറുടെ നമ്പർ ഉൾക്കൊള്ളുന്നു. സിഗ്നേച്ചറുകൾ ഹെഡറുകളെ ഉൾക്കൊള്ളുന്നില്ല: V2 ടൈംസ്റ്റാമ്പ്, മെത്തഡ്, പാത്ത്, ക്വറി, ബോഡി എന്നിവയിൽ ഒപ്പിടുന്നു. നമ്പറുകളിലും ഒപ്പുണ്ടാകണമെങ്കിൽ, അവ ബോഡിയിൽ നിന്ന് വായിക്കുക: retell റിക്വസ്റ്റ് ഫോർമാറ്റിൽ മൂന്നും ഉൾപ്പെടുന്നു, vapi ഉപഭോക്താവിന്റെ നമ്പർ ഉൾക്കൊള്ളുന്നു.

നിങ്ങളുടെ endpoint.headers അത് ഓവർറൈഡ് ചെയ്യുന്നില്ലെങ്കിൽ Content-Type: application/json സജ്ജീകരിക്കും — കസ്റ്റം Content-Type-നാണ് മുൻഗണന.

അഭ്യർത്ഥനാ ഫോർമാറ്റ്

ഓരോ API കണക്ഷനും request_format ക്രമീകരണം ഉണ്ട്. ഇംപോർട്ട് ചെയ്ത ഒരു ടൂൾ ആ പ്ലാറ്റ്‌ഫോമിനായി നിർമ്മിച്ച എൻഡ്‌പോയിന്റിനെ തുടർന്നും വിളിക്കേണ്ടതാണെങ്കിൽ vapi അല്ലെങ്കിൽ retell തിരഞ്ഞെടുക്കുക. പുതിയതും നിലവിലുള്ളതുമായ കണക്ഷനുകൾ ഡിഫോൾട്ടായി standard ഉപയോഗിക്കും.

POST / PUT / PATCH എന്നിവയ്ക്കായി, ThunderPhone തിരഞ്ഞെടുത്ത എൻവലപ്പ് കാനോനിക്കലായി സീരിയലൈസ് ചെയ്യുന്നു (ക്രമീകരിച്ച കീകൾ, കോംപാക്റ്റ് സെപ്പറേറ്ററുകൾ). രണ്ട് സിഗ്നേച്ചറുകളും ഈ കൃത്യമായ ബൈറ്റുകളെ ഉൾക്കൊള്ളുന്നു.

സ്റ്റാൻഡേർഡ്

standard ഒരു റാപ്പറും ഇല്ലാതെ ടൂൾ ആർഗ്യുമെന്റുകൾ മാത്രം അയയ്ക്കുന്നു. ഇത് ഡിഫോൾട്ടാണ്, കൂടാതെ ThunderPhone-ന്റെ യഥാർത്ഥ റിക്വസ്റ്റ് ബോഡി ബൈറ്റ്-ബൈറ്റായി സംരക്ഷിക്കുന്നു:

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

Vapi

vapi, Vapi രേഖപ്പെടുത്തുന്ന രൂപത്തിൽ Vapi-യുടെ tool-calls സെർവർ സന്ദേശം അയയ്ക്കുന്നു. call.id, ThunderPhone കോൾ ID ആണ്. ഫോൺ കോളുകളിൽ, call.customer.number Vapi-യുടെ കോൾ ഒബ്ജക്റ്റിലുള്ളതുപോലെ മറ്റേ കക്ഷിയുടെ നമ്പറാണ്: ഇൻബൗണ്ട് കോളിലെ കോളറുടെയും ഔട്ട്ബൗണ്ട് കോളിൽ വിളിക്കപ്പെടുന്ന വ്യക്തിയുടെയും നമ്പർ. ആ നമ്പർ മറച്ചുവെച്ചിരിക്കുമ്പോഴോ അത് ഫോൺ നമ്പർ അല്ലാതിരിക്കുമ്പോഴോ ഇത് ഒഴിവാക്കപ്പെടും. ടൂൾ-കോളിന്റെ id, ആ വിളിക്കലിന് മാത്രമുള്ളതും എൻഡ്‌പോയിന്റിന്റെ ഫലവുമായി പൊരുത്തപ്പെടുത്തുന്നതിനായി പുനരുപയോഗിക്കുന്നതുമാണ്. കോൾ toolCallList-ലും toolWithToolCallList-ലും ദൃശ്യമാകും, function.arguments ഒരു 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" }
          }
        }
      }
    ]
  }
}

assistant, artifact, പൂർണ്ണ call ഒബ്‌ജക്റ്റ് എന്നിവ പോലുള്ള Vapi-മാത്രം ഫീൽഡുകൾ അയയ്ക്കുന്നില്ല.

പൊരുത്തപ്പെടുന്ന ടൂൾ-കോൾ ID ഉപയോഗിച്ച് Vapi-യുടെ പ്രതികരണ എൻവലപ്പ് നൽകുക:

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

ThunderPhone റാപ്പ് നീക്കിയ result സ്ട്രിംഗ് AI-ക്ക് നൽകുന്നു. ഇതിനകം JSON മൂല്യം നൽകുന്ന എൻഡ്‌പോയിന്റുകളുമായുള്ള അനുയോജ്യതയ്ക്കായി അത് സ്വീകരിക്കുകയും ചെയ്യുന്നു. result-ന് പകരം error ഉണ്ടെങ്കിൽ, അത് AI-ക്ക് ഒരു ടൂൾ പിശകായി നൽകും. എൻഡ്‌പോയിന്റ് തെറ്റായ രൂപത്തിലുള്ളതോ പൊരുത്തമില്ലാത്തതോ ആയ Vapi എൻവലപ്പ് നൽകുകയാണെങ്കിൽ, ThunderPhone ഒരു മുന്നറിയിപ്പ് ലോഗ് ചെയ്ത് കോൾ പരാജയപ്പെടുത്തുന്നതിന് പകരം അതിന്റെ സ്റ്റാൻഡേർഡ് പ്രതികരണ പാഴ്സിങ്ങിലേക്ക് മടങ്ങും.

Retell

retell, ഒരു Retell കസ്റ്റം ഫംഗ്ഷനായി രേഖപ്പെടുത്തിയിരിക്കുന്ന അഭ്യർത്ഥന അയയ്ക്കുന്നു:

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

ഫോൺ കോളുകളിൽ, call ഒബ്‌ജക്റ്റിൽ call_id, from_number, to_number, direction (inbound അല്ലെങ്കിൽ outbound) എന്നിവ ഉണ്ടാകും. ഇവ Retell-ന്റെ ഫോൺ കോൾ ഒബ്‌ജക്റ്റ് ഉപയോഗിക്കുന്ന ഫീൽഡ് നാമങ്ങളാണ്. അവ കോൾ-നമ്പർ ഹെഡറുകളുമായി പൊരുത്തപ്പെടുന്നു, കൂടാതെ ഹെഡറുകളിൽനിന്ന് വ്യത്യസ്തമായി രണ്ട് സിഗ്നേച്ചറുകളിലും ഉൾപ്പെടുന്നു. മറച്ചുവെച്ചതോ ഫോൺ നമ്പർ അല്ലാത്തതോ ആയ ഒരു നമ്പർ ഒഴിവാക്കപ്പെടും. വെബ്, വിജറ്റ്, റിയൽടൈം, ബ്രൗസർ Talk പരിശോധനകളിൽ ഇതിൽ call_id മാത്രമേ ഉണ്ടാകൂ. ഡിസ്‌പാച്ച് സമയത്ത് യഥാർത്ഥത്തിൽ നൽകാൻ കഴിയാത്ത agent_id, transcript, transcript_object, metadata, അല്ലെങ്കിൽ ഡൈനാമിക് വേരിയബിളുകൾ പോലുള്ള Retell-നിർദ്ദിഷ്ട ഫീൽഡുകൾ ThunderPhone ഉൾപ്പെടുത്തുന്നില്ല. Retell ഏത് റെസ്‌പോൺസ് ബോഡിയും സ്വീകരിക്കും; സാധാരണ റെസ്‌പോൺസ് കൈകാര്യം ചെയ്യൽ ഉപയോഗിച്ച് ThunderPhone അത് അതേപടി കൈമാറും.

GET / DELETE എന്നിവയ്ക്കായി, request_format പരിഗണിക്കാതെ ആർഗ്യുമെന്റുകൾ ക്വറി പാരാമീറ്ററുകളായി അയയ്ക്കുകയും ബോഡി ശൂന്യമായിരിക്കുകയും ചെയ്യും. അയച്ചതുപോലെയുള്ള ക്വറി സ്ട്രിംഗിനെ V2 സിഗ്നേച്ചർ ഉൾക്കൊള്ളുന്നു; ലെഗസി സിഗ്നേച്ചർ ശൂന്യമായ ബൈറ്റ് സ്ട്രിംഗിൽ കണക്കാക്കുന്നു. കാണുക വെബ്ഹുക്ക് സിഗ്നേച്ചറുകൾ പരിശോധിക്കുക.

പ്രതികരണം

ടൂൾ ഫലത്തോടുകൂടിയ ഒരു JSON പ്രതികരണം നൽകുക:

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

സംഭാഷണം തുടരുന്നതിനായി പ്രതികരണം ഫോർമാറ്റ് ചെയ്ത് AI-ക്ക് നൽകും. JSON അല്ലാത്ത പ്രതികരണങ്ങൾ {"data": "<text>"} ആയി റാപ്പ് ചെയ്യും; ടൈംഔട്ടുകളും കണക്ഷൻ പരാജയങ്ങളും AI-ക്ക് പിശകുകളായി റിപ്പോർട്ട് ചെയ്യും, അതിനാൽ ഏജന്റിന് ക്ഷമ ചോദിച്ച് തടസ്സപ്പെടാതെ മുന്നോട്ട് പോകാനാകും.

വെബ്ഹുക്ക്-മോഡ് ഡിസ്പാച്ച്

endpoint ഇല്ലാത്ത ടൂളുകൾ നിങ്ങളുടെ org-ന്റെ ലെഗസി വെബ്ഹുക്ക് URL-ലേക്ക് സൈൻ ചെയ്ത telephony.tool (ഫോൺ കോൾകൾ) അല്ലെങ്കിൽ web.tool (വെബ് കോൾകൾ) അഭ്യർത്ഥനയായി ഡിസ്പാച്ച് ചെയ്യപ്പെടും. നിർവഹണത്തിന് ശേഷം വെബ്ഹുക്ക് എൻഡ്പോയിന്റുകളിലേക്ക് എത്തിക്കുന്ന ഓഡിറ്റ് അറിയിപ്പുകളിൽ നിന്ന് വ്യത്യസ്തമായി, ഈ അഭ്യർത്ഥന തന്നെയാണ് നിർവഹണം — നിങ്ങളുടെ HTTP പ്രതികരണമാണ് ടൂൾ ഫലം.

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

web.tool, from_number / to_number-ന് പകരം origin_domain വഹിക്കുന്നു. ടൂൾ ഫലത്തോടൊപ്പം JSON ആയി പ്രതികരിക്കുക — ഡയറക്ട് endpoint കോളുകൾക്കുള്ള അതേ പ്രതികരണ കരാറാണ് ഇത്. മറ്റെല്ലാ webhook-ുകളെയും പോലെ, രണ്ട് signature header-ുകളും ഉപയോഗിച്ച് org webhook secret ഉപയോഗിച്ച് അഭ്യർത്ഥന സൈൻ ചെയ്തിരിക്കുന്നു.


ദൈർഘ്യമേറിയ കാത്തിരിപ്പുകൾ: ഹോൾഡ് മോഡും പിന്നീട് മറുപടി നൽകലും

ചില ടൂളുകൾ ഒരു വ്യക്തിക്കായി കാത്തിരിക്കും: ഒരു മാനേജർ ഡിസ്കൗണ്ട് അംഗീകരിക്കുന്നത്, ഒരു ഉടമ Slack-ൽ ഒരു ചോദ്യത്തിന് മറുപടി നൽകുന്നത്. അത്തരം ടൂളുകളിൽ wait_mode "hold" ആയി സജ്ജമാക്കുക.

wait_mode: "updates" (സ്ഥിരസ്ഥിതി)wait_mode: "hold"
കോളർ കേൾക്കുന്നത്ടൂൾ ആരംഭിക്കുന്ന വരി, തുടർന്ന് ഏകദേശം 12 s കഴിഞ്ഞ് ഒരു ചെറിയ "ഇപ്പോഴും പ്രവർത്തിക്കുന്നു" വരിയും, ശേഷം ഏകദേശം ഓരോ 15 s-ലും മറ്റൊന്നുംടൂൾ ആരംഭിക്കുന്ന വരി, തുടർന്ന് ഫലം ലഭിക്കുന്നതുവരെ ഹോൾഡ് സംഗീതം
timeout പരമാവധി180 s600 s
തീർപ്പാക്കാത്ത മറുപടികൾഫലമായി ഏജന്റിന് കൈമാറുന്നുനിങ്ങൾ ഫലം നൽകുന്നതുവരെ ടൂൾ തുറന്നിരിക്കും

ഹോൾഡ് മോഡിൽ ടൂൾ ആരംഭിക്കുമ്പോൾ ഏജന്റ് ഒരു വരി പറയുന്നു (അതിന്റെ സ്വന്തം വാക്കുകളോ ഏജന്റിൽ സജ്ജീകരിച്ച ടൂൾ-ആരംഭ വരിയോ), തുടർന്ന് കോളർ ഹോൾഡ് സംഗീതം കേൾക്കും. ഏജന്റ് ഫലം പറയുന്നതിന് മുമ്പ് സംഗീതം മങ്ങിക്കുറയും. ഒരു സെക്കൻഡോ രണ്ടോ ഉള്ളിൽ മറുപടി നൽകുന്ന ടൂളിന് സംഗീതമൊന്നും ലഭിക്കില്ല. ഏജന്റ് ഒരു ഫോൺ മെനുവുമായോ വോയ്‌സ്‌മെയിൽ ബോക്സുമായോ സംസാരിക്കുമ്പോൾ, മറുപടിയായി സംഗീതം കേൾക്കപ്പെടാനിടയുള്ളതിനാൽ അത് പകരം വാചിക അപ്ഡേറ്റുകൾ ഉപയോഗിക്കുന്നു. ഹോൾഡിനിടെ മെനുവോ മെയിൽബോക്സോ ആണെന്ന് കണ്ടെത്തുന്ന കോളും ഇതിൽ ഉൾപ്പെടുന്നു: സംഗീതം നിൽക്കുകയും വാചിക അപ്ഡേറ്റുകൾ ഏറ്റെടുക്കുകയും ചെയ്യും. സംഗീതം പ്ലേ ചെയ്യാൻ കഴിയാത്ത കോളിലും ഇതുതന്നെ സംഭവിക്കും.

ഹോൾഡിനിടെ കോളർ സംസാരിച്ചാൽ, സംഗീതം തുടർന്നും പ്ലേ ചെയ്യുകയും ഏജന്റ് ഇതുവരെ മറുപടി നൽകാതിരിക്കുകയും ചെയ്യും. കോളർ പറഞ്ഞത് അത് കേൾക്കുകയും ഫലത്തോടൊപ്പം അതിന് മറുപടി നൽകുകയും ചെയ്യും. കോൾ വിച്ഛേദിക്കുന്നത് കോളും തുറന്ന ടൂളും അവസാനിപ്പിക്കും.

പിന്നീട് മറുപടി നൽകുക

നിങ്ങളുടെ endpoint-ന്റെ സ്വന്തം പ്രതികരണം ഇപ്പോഴും 180 s-നുള്ളിൽ എത്തണം. കോളറെ കൂടുതൽ സമയം ഹോൾഡിൽ നിർത്താൻ, തീർപ്പാക്കാത്ത ഫലവുമായി ഉടൻ മറുപടി നൽകുക:

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

request_id എന്നത് നിങ്ങളുടെ ഭാഗത്ത് ഈ അഭ്യർത്ഥന തിരിച്ചറിയുന്ന, പരമാവധി 200 അക്ഷരങ്ങളുള്ള ഏതെങ്കിലും സ്ട്രിങ്ങാണ്. അതിന്റെ ഫലം നിങ്ങൾ POST /v1/calls/{call_id}/tool-results ഉപയോഗിച്ച് നൽകുന്നതുവരെ കോളർ ഹോൾഡിൽ തുടരും. call_id എന്നത് ടൂൾ അഭ്യർത്ഥനയുടെ X-ThunderPhone-Call-ID ഹെഡറാണ്.

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." }
  }'

നിങ്ങളുടെ endpoint അത് തിരികെ നൽകിയതുപോലെതന്നെ, ഏജന്റ് result ടൂളിന്റെ മറുപടിയായി വായിക്കും. ടൂൾ വിളിക്കപ്പെട്ട സമയം മുതൽ കണക്കാക്കുന്ന ടൂളിന്റെ timeout-ന് മുമ്പ് ഫലമൊന്നും എത്തിയില്ലെങ്കിൽ, മറുപടി തിരികെ വന്നില്ലെന്ന് ഏജന്റിനോട് അറിയിക്കുകയും സന്ദേശം എടുക്കുന്നത് പോലുള്ള അടുത്ത ഘട്ടങ്ങൾ കോളർക്ക് വാഗ്ദാനം ചെയ്യുകയും ചെയ്യും.

നിങ്ങളുടെ തീർപ്പാക്കാത്ത പ്രതികരണം ThunderPhone-ൽ എത്തിയതിനുമുമ്പുതന്നെ, നിങ്ങൾക്ക് ഇഷ്ടമുള്ളപ്പോൾ ഫലം പോസ്റ്റ് ചെയ്യാം. ഒരു 202 എന്നാൽ കോൾ അത് സ്വീകരിച്ചു എന്നാണ്: തുറന്ന ഒരു അഭ്യർത്ഥന അത് സ്വീകരിച്ചു, അല്ലെങ്കിൽ ടൂളിന്റെ സ്വന്തം അഭ്യർത്ഥന ഇപ്പോഴും പുരോഗതിയിലായിരിക്കുകയും അതിന്റെ തീർപ്പാക്കാത്ത മറുപടി അത് ഏറ്റെടുക്കുകയും ചെയ്യും. ഒരു അഭ്യർത്ഥനയും ഒരിക്കലും ഏറ്റെടുക്കാത്ത ഫലം (request_id-ന് നിങ്ങളുടെ endpoint പിന്നീട് തീർപ്പാക്കാത്തതല്ലാത്ത മറ്റെന്തെങ്കിലും മറുപടി നൽകിയാൽ) ഒഴിവാക്കപ്പെടും.

കണക്ഷനിൽ ഒരു പ്രതികരണ പരിവർത്തനം ഉണ്ടെങ്കിൽ (ഏജന്റ് കാണുന്നതിന് മുമ്പ് നിങ്ങളുടെ endpoint-ന്റെ മറുപടി പുനരെഴുതുന്ന കോഡ്), ThunderPhone തീർപ്പാക്കാത്ത മറുപടി പരിശോധിക്കുന്നതിന് മുമ്പ് പരിവർത്തനം നിങ്ങളുടെ endpoint-ന്റെ സ്വന്തം മറുപടിയിൽ പ്രവർത്തിക്കും, അതിനാൽ അത് തീർപ്പാക്കാത്ത മറുപടിയിൽ status, request_id എന്നിവ നിലനിർത്തണം. പിന്നീട് നിങ്ങൾ പോസ്റ്റ് ചെയ്യുന്ന ഫലത്തിൽ അത് പ്രവർത്തിക്കില്ല: നിങ്ങൾ അയയ്ക്കുന്നതുപോലെതന്നെ ഏജന്റിന് ആ ഫലം ലഭിക്കും.

ഒരു ഫുൾ-ഡ്യൂപ്ലെക്സ് ഏജന്റിന് ഹോൾഡ് സംഗീതമോ അപ്ഡേറ്റ് വരികളോ ഇല്ല, അതിനാൽ അതിന്റെ കോളുകളിൽ ഒരു ഹോൾഡ് ടൂൾ updates ടൂൾ പോലെ പ്രവർത്തിക്കും: തീർപ്പാക്കാത്ത മറുപടി ടൂളിന്റെ ഫലമായി ഏജന്റിലെത്തും.

updates മോഡിലുള്ള ടൂളിൽനിന്നുള്ള തീർപ്പാക്കാത്ത പ്രതികരണം തുറന്നുവയ്ക്കില്ല: ടൂളിന്റെ ഫലമായി ഏജന്റിന് അത് ലഭിക്കും.

സിഗ്നേച്ചർ പരിശോധന

നിങ്ങളുടെ ഓർഗനൈസേഷൻ webhook സീക്രട്ട് ഉപയോഗിച്ച്, webhook-ുകൾക്ക് സമാനമായ രീതിയിൽ നേരിട്ടുള്ള ടൂൾ കോളുകൾ സൈൻ ചെയ്യപ്പെടുന്നു:

  • X-ThunderPhone-Signature-V2 അയച്ചതുപോലെയുള്ള timestamp, method, path, query എന്നിവയിലും കൃത്യമായ body byte-ുകളിലും സൈൻ ചെയ്യുന്നു. നിങ്ങളുടെ ക്ലോക്കിൽ നിന്ന് 5 മിനിറ്റിൽ കൂടുതലായി വ്യത്യാസമുള്ള timestamp ഉള്ള റിക്വസ്റ്റുകൾ നിരസിക്കുക.
  • X-ThunderPhone-Signature (ലെഗസി) body byte-ുകളിൽ മാത്രം സൈൻ ചെയ്യുന്നു; GET / DELETE നായി ശൂന്യ byte സ്ട്രിങ്ങാണ് ഉപയോഗിക്കുന്നത്. ഇത് മാറ്റമില്ലാതെ ഇപ്പോഴും അയയ്ക്കപ്പെടുന്നു.

5-മിനിറ്റ് വിൻഡോ ഉൾപ്പെടെ V2 header SDK ഹെൽപ്പറുകൾ പരിശോധിക്കുന്നു:

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

സൈൻ ചെയ്ത സ്ട്രിങ്, പ്രവർത്തിക്കുന്ന ഉദാഹരണം, SDK ഇല്ലാത്ത കോഡ്, GET / DELETE കേസ്, സീക്രട്ട് ഇല്ലാത്ത സാഹചര്യത്തെക്കുറിച്ചുള്ള കുറിപ്പ് എന്നിവയുൾപ്പെടെയുള്ള പൂർണ്ണ റെസിപ്പികൾ webhook സിഗ്നേച്ചറുകൾ പരിശോധിക്കുക-ൽ ലഭ്യമാണ്.


ഉദാഹരണം: സമ്പൂർണ്ണ ബുക്കിംഗ് ഫ്ലോ

സമ്പൂർണ്ണ അപ്പോയിന്റ്മെന്റ് ബുക്കിംഗ് സിസ്റ്റത്തിനായുള്ള ടൂളുകളുടെ ഒരു സെറ്റ് ഇതാ:

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

കോളിന്റെ തുടക്കത്തിൽ ഒരു ടൂൾ പ്രവർത്തിപ്പിക്കുക

ഓരോ ഫോൺ കോളിന്റെയും തുടക്കത്തിൽ, ഏജന്റ് ആദ്യ വാക്ക് പറയുന്നതിന് മുമ്പ്, ഒരു ടൂൾ സ്വയമേവ പ്രവർത്തിപ്പിക്കാനും കഴിയും; അങ്ങനെ അഭിവാദ്യത്തിന് ഫലം ഉപയോഗിക്കാം. സാധാരണയായി ഇത് വിളിക്കുന്നയാളുടെ നമ്പർ ഉപയോഗിച്ചുള്ള CRM തിരയലാണ്: "വീണ്ടും സ്വാഗതം, ആർതി! നിങ്ങളുടെ പതിവ് ഓർഡർ വേണോ?"

ഡാഷ്ബോർഡിൽ API കണക്ഷൻ തുറന്ന് പ്രവർത്തിക്കുന്ന സമയം എന്നത് ഓരോ ഫോൺ കോളിന്റെയും തുടക്കത്തിൽ എന്ന് സജ്ജമാക്കുക, തുടർന്ന് ഓരോ പാരാമീറ്ററിനും ലഭിക്കേണ്ട മൂല്യം നൽകുക. API വഴി, ഇന്റഗ്രേഷന്റെ trigger എന്നത് call_start ആയും അതിന്റെ call_start_arguments ആയും സജ്ജമാക്കുക (API കണക്ഷനുകൾ), അല്ലെങ്കിൽ ഒരു ഇൻലൈൻ ടൂളിലേക്ക് call_start ബ്ലോക്ക് ചേർക്കുക:

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

കോൾ ആരംഭിക്കുമ്പോൾ ആരും ഒന്നും പൂരിപ്പിക്കാത്തതിനാൽ, ഓരോ ആവശ്യമായ പാരാമീറ്ററിനും ആർഗ്യുമെന്റുകളിൽ ഒരു മൂല്യം വേണം. മൂല്യങ്ങൾ സ്ട്രിംഗുകളോ നമ്പറുകളോ ബൂളിയനുകളോ ആണ്. അവ സാധാരണ ടെക്സ്റ്റായി സംഭരിക്കുകയും തിരികെ നൽകുകയും ചെയ്യുന്നു, ഏജന്റിന് അവ കാണാനും കഴിയും; അതിനാൽ API കീകൾ പോലുള്ള രഹസ്യങ്ങൾ ഇവിടെ അല്ല, കണക്ഷന്റെ ഹെഡറുകളിൽ സൂക്ഷിക്കുക. സ്ട്രിംഗുകളിൽ ഈ പ്ലേസ്‌ഹോൾഡറുകൾ ഉപയോഗിക്കാം:

പ്ലേസ്‌ഹോൾഡർമൂല്യം
{{caller_number}}E.164 ഫോർമാറ്റിലുള്ള കോളിലെ മറ്റേയാളുടെ നമ്പർ, ഉദാഹരണത്തിന് +61402122887: ഇൻബൗണ്ട് കോളിൽ വിളിക്കുന്നയാൾ, ഔട്ട്ബൗണ്ട് കോളിൽ വിളിക്കപ്പെടുന്നയാൾ
{{caller_number_national}}സ്‌പേസുകളില്ലാത്ത അതത് രാജ്യത്തിന്റെ ദേശീയ ഫോർമാറ്റിലുള്ള അതേ നമ്പർ, ഉദാഹരണത്തിന് 0402122887
{{agent_number}}ഏജന്റിന്റെ സ്വന്തം നമ്പർ

ഇത് പ്രവർത്തിക്കുന്ന രീതി:

  • അഭ്യർത്ഥന ഏജന്റിന്റെ സ്വന്തം ടൂൾ കോളുകൾ അയയ്ക്കുന്നതിന് സമാനമാണ് (ഒരേ എൻഡ്‌പോയിന്റ്, ഹെഡറുകൾ, അഭ്യർത്ഥനാ ഫോർമാറ്റ്, സിഗ്നേച്ചർ).
  • കോൾ ആരംഭിക്കുമ്പോൾ ടൂൾ ആരംഭിക്കുകയും, കണക്റ്റ് ടോൺ, ആമുഖം, അല്ലെങ്കിൽ റെക്കോർഡിംഗ് അറിയിപ്പ് പ്ലേ ചെയ്യുമ്പോൾ പ്രവർത്തിക്കുകയും ചെയ്യുന്നു. ആ ഘട്ടം മുതൽ ഏകദേശം 3 സെക്കൻഡ് വരെ അഭിവാദ്യം ഇതിനായി കാത്തിരിക്കും. വൈകിയെത്തുന്ന ഫലം എത്തുന്നയുടൻ, കോളിന്റെ ശേഷിക്കുന്ന സമയത്തേക്ക് ഏജന്റിന് നൽകും. ഔട്ട്ബൗണ്ട് കോളിൽ ഇത് കോൾ ചെയ്യുമ്പോൾ ആരംഭിക്കുന്നു; അതിനാൽ ആരും എടുക്കാത്തവ ഉൾപ്പെടെ എല്ലാ ശ്രമങ്ങളിലും ഇത് പ്രവർത്തിക്കും.
  • വിളിക്കുന്നയാൾ ആദ്യം സംസാരിക്കുന്ന ഏജന്റിൽ കാത്തിരിക്കേണ്ട അഭിവാദ്യമില്ല; ഫലം എത്തുന്നയുടൻ ഏജന്റിന് അത് ലഭിക്കും.
  • മുഴുവൻ കോളിനുമുള്ള സന്ദർഭമായി ഫലം ഏജന്റിന് നൽകുന്നു. അത് എങ്ങനെ ഉപയോഗിക്കണമെന്ന് നിങ്ങളുടെ prompt-ൽ ഏജന്റിനോട് പറയുക; അല്ലാത്തപക്ഷം അത് വായിച്ചുപറയില്ല.
  • ടൂൾ പരാജയപ്പെടുകയോ സമയപരിധി കവിയുകയോ ചെയ്താൽ, ഏജന്റ് സാധാരണ ചെയ്യുന്നതുപോലെ വിളിക്കുന്നയാളെ അഭിവാദ്യം ചെയ്യും, അതിനെക്കുറിച്ച് ഒന്നും പറയില്ല.
  • കോളിന്റെ പിന്നീടുള്ള ഘട്ടത്തിലും ഏജന്റിന് ടൂൾ സ്വയം വിളിക്കാനാകും.
  • നിങ്ങളുടെ ഫോണിലേക്കുള്ള ഡാഷ്ബോർഡ് ടെസ്റ്റ് കോളുകൾ ഉൾപ്പെടെയുള്ള ഫോൺ കോളുകളിലും, സിമുലേറ്റ് ചെയ്ത വിളിക്കുന്നയാളുടെ നമ്പർ നിങ്ങളുടെ എൻഡ്‌പോയിന്റിലേക്ക് അയയ്ക്കുന്ന AI സിമുലേഷനുകളിലും ഇത് പ്രവർത്തിക്കും. വിളിക്കുന്നയാളുടെ നമ്പർ ഇല്ലാത്ത ബ്രൗസർ സംസാരിക്കുക ടെസ്റ്റുകളിലോ വെബ് വിജറ്റ് സെഷനുകളിലോ, കോളർ ID മറച്ചുവെച്ച കോളുകളിലോ, ഘട്ടങ്ങളുള്ള ഏജന്റുകളിലോ ഇത് പ്രവർത്തിക്കില്ല.
  • ഒരു ഏജന്റ് ഒരേസമയം പരമാവധി മൂന്ന് കോൾ-തുടക്ക ടൂളുകൾ പ്രവർത്തിപ്പിക്കും.

ഫലം എങ്ങനെ ഉപയോഗിക്കണമെന്ന് ഏജന്റിന് അറിയാനായി നിങ്ങളുടെ prompt-ൽ അത് പരാമർശിക്കുക, ഉദാഹരണത്തിന്: "കോൾ ആരംഭത്തിലെ തിരയലിൽ വിളിക്കുന്നയാളെ കണ്ടെത്തിയാൽ, അവരുടെ ആദ്യ പേരുപയോഗിച്ച് അഭിവാദ്യം ചെയ്യുക."


മികച്ച രീതികൾ

വ്യക്തമായ വിവരണങ്ങൾ എഴുതുക

description ഫീൽഡ് ഉപകരണം എപ്പോൾ ഉപയോഗിക്കണമെന്ന് AI-യെ മനസ്സിലാക്കാൻ സഹായിക്കുന്നു. അത് എന്താണ് ചെയ്യുന്നതെന്നും എപ്പോൾ ഉപയോഗിക്കുന്നത് ഉചിതമാണെന്നും വ്യക്തമായി വ്യക്തമാക്കുക.

പിശകുകൾ സുഗമമായി കൈകാര്യം ചെയ്യുക

പൊതുവായ 500 പിശകുകൾക്ക് പകരം AI-ക്ക് മനസ്സിലാക്കാവുന്ന പിശക് സന്ദേശങ്ങൾ നൽകുക: {"error": "No slots available for that date"}.

മറുപടികൾ സംക്ഷിപ്തമായി നിലനിർത്തുക

സംഭാഷണം തുടരാൻ AI-യ്ക്ക് ആവശ്യമായത് മാത്രം മടക്കി നൽകുക. ഒരു ടൂൾ ഫലം സംഭാഷണത്തിൽ നിലനിൽക്കുകയും പിന്നീടുള്ള ഓരോ ടേണിലും വീണ്ടും വായിക്കപ്പെടുകയും ചെയ്യുന്നതിനാൽ, വലുതായ ഫലം കോളിന്റെ ശേഷിക്കുന്ന ഭാഗത്തിന് ചെലവും വൈകല്യവും കൂട്ടും. 100,000 പ്രതീകങ്ങളിൽ കൂടുതലുള്ള ഫലങ്ങൾ അപൂർണമാണെന്ന് AI-ക്ക് അറിയാവുന്ന ഒരു പ്രിവ്യൂവായി ചുരുക്കപ്പെടും, വളരെ ദൈർഘ്യമേറിയ കോളിൽ പഴയ ഫലങ്ങൾ ഒഴിവാക്കപ്പെട്ടേക്കാം (AI-ക്ക് ടൂൾ വീണ്ടും വിളിക്കാം). AI-ക്ക് ഒരു സമയം ഒരു ഇനമോ വിഭാഗമോ തിരയാൻ കഴിയുന്നവിധം ഒരു പാരാമീറ്റർ ചേർക്കുക; മെനുകൾ അല്ലെങ്കിൽ കാറ്റലോഗുകൾ പോലുള്ള വലിയ റഫറൻസ് ഉള്ളടക്കം ഒരു വിജ്ഞാന ശേഖരത്തിൽ ഇടുക. ഡാഷ്ബോർഡിലെ ടെസ്റ്റ് അഭ്യർത്ഥന അയയ്ക്കുക ഓരോ ഫലത്തിന്റെയും വലുപ്പം കാണിക്കുകയും അത് വലുതായിരിക്കുമ്പോൾ മുന്നറിയിപ്പ് നൽകുകയും ചെയ്യുന്നു.

ആവശ്യമായ ഫീൽഡുകൾ വിവേകത്തോടെ ഉപയോഗിക്കുക

യഥാർഥത്തിൽ ആവശ്യമുള്ളപ്പോൾ മാത്രം ഫീൽഡുകളെ required ആയി അടയാളപ്പെടുത്തുക. ഉപകരണം വിളിക്കുന്നതിന് മുമ്പ് AI ആവശ്യമായ വിവരങ്ങൾ ഉപയോക്താവിനോട് ചോദിക്കും.


ബന്ധപ്പെട്ടവ