ಫಂಕ್ಷನ್ ಟೂಲ್‌ಗಳು

ನಿಮ್ಮ AI ಏಜೆಂಟ್‌ಗಳಿಗೆ ಸಂಭಾಷಣೆಯ ಮಧ್ಯೆ ಬಾಹ್ಯ APIಗಳನ್ನು ಕರೆಸುವ ಫಂಕ್ಷನ್ ಟೂಲ್‌ಗಳನ್ನು ನೀಡಿ — ಗ್ರಾಹಕ ಡೇಟಾವನ್ನು ಪಡೆಯಿರಿ, ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್‌ಗಳನ್ನು ಬುಕ್ ಮಾಡಿ, ದಾಖಲೆಗಳನ್ನು ನವೀಕರಿಸಿ — ಟೈಪ್ ಮಾಡಿದ ಪ್ಯಾರಾಮೀಟರ್‌ಗಳೊಂದಿಗೆ.

ಕಾರ್ಯ ಸಾಧನಗಳು ನಿಮ್ಮ AI ಏಜೆಂಟ್‌ಗಳು ಫೋನ್ ಕರೆಗಳ ಸಮಯದಲ್ಲಿ ಬಾಹ್ಯ APIಗಳನ್ನು ಆಹ್ವಾನಿಸಲು ಅನುಮತಿಸುತ್ತವೆ. ಗ್ರಾಹಕ ಡೇಟಾವನ್ನು ಹುಡುಕಲು, ಲಭ್ಯತೆಯನ್ನು ಪರಿಶೀಲಿಸಲು, ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್‌ಗಳನ್ನು ಬುಕ್ ಮಾಡಲು ಅಥವಾ ನಿಮ್ಮ ಬ್ಯಾಕೆಂಡ್ ಬೆಂಬಲಿಸುವ ಯಾವುದೇ ಕ್ರಿಯೆಯನ್ನು ನಿರ್ವಹಿಸಲು ಅವುಗಳನ್ನು ಬಳಸಿ.

ಇದು ಹೇಗೆ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ#

1. ನೀವು ಸ್ಕೀಮಾದೊಂದಿಗೆ ಸಾಧನಗಳನ್ನು ವ್ಯಾಖ್ಯಾನಿಸುತ್ತೀರಿ (ಸಾಧನವು ಸ್ವೀಕರಿಸುವ ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳು)
2. ನೀವು endpoint ಸಂರಚನೆಯನ್ನು ಒದಗಿಸುತ್ತೀರಿ (ThunderPhone ನಿಮ್ಮ API ಅನ್ನು ಎಲ್ಲಿ ಕರೆಯುತ್ತದೆ) — ಅಥವಾ ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿ ಸಾಧನ ಕರೆಗಳನ್ನು ಸ್ವೀಕರಿಸಲು ಅದನ್ನು ಬಿಡಬಹುದು
3. ಕರೆಯ ಸಮಯದಲ್ಲಿ, ಸಂಭಾಷಣೆಯ ಆಧಾರದ ಮೇಲೆ ಸಾಧನವನ್ನು ಯಾವಾಗ ಬಳಸಬೇಕೆಂದು AI ನಿರ್ಧರಿಸುತ್ತದೆ
4. ThunderPhone ಸಾಧನದ ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳೊಂದಿಗೆ ನಿಮ್ಮ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ಕರೆ ಮಾಡುತ್ತದೆ
5. ಸಂಭಾಷಣೆಯನ್ನು ಮುಂದುವರಿಸಲು ನಿಮ್ಮ API ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು AI ಗೆ ಮರಳಿ ನೀಡಲಾಗುತ್ತದೆ

ಸಾಧನ ಸ್ಕೀಮಾ#

ಪ್ರತಿಯೊಂದು ಸಾಧನವೂ ಈ ರಚನೆಯನ್ನು ಅನುಸರಿಸುತ್ತದೆ:

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

ಸಾಧನ ಸಂರಚನೆ#

ಕಾರ್ಯದ ವ್ಯಾಖ್ಯಾನ#

ಎಂಡ್‌ಪಾಯಿಂಟ್ ಸಂರಚನೆ#

ಎರಡು ಆಹ್ವಾನ ಮಾರ್ಗಗಳು#

ನಿಮ್ಮ ಸರ್ವರ್ ಯಾವ ವಿನಂತಿಯನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ ಎಂಬುದು ಸಾಧನವು endpoint ಹೊಂದಿದೆಯೇ ಎಂಬುದರ ಮೇಲೆ ಅವಲಂಬಿತವಾಗಿದೆ:

ಎರಡೂ ಮಾರ್ಗಗಳು ತಡೆಹಿಡಿಯುವ ಸ್ವರೂಪದವು — ಫಲಿತಾಂಶಕ್ಕಾಗಿ AI ವಾಕ್ಯದ ಮಧ್ಯದಲ್ಲೇ ಕಾಯುತ್ತಿದೆ. ಡೀಫಾಲ್ಟ್ ಕಾಲಾವಧಿ 20 ಸೆ; ಹೆಚ್ಚು ಸಮಯದ ಕಾರ್ಯಗತಗೊಳಿಸುವಿಕೆಯನ್ನು ಅನುಮತಿಸಲು ಸಾಧನದ ಮೇಲ್ಮಟ್ಟದ timeout ಅನ್ನು ಹೊಂದಿಸಿ, ಗರಿಷ್ಠ 180 ಸೆ ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ಮಿತಿಯವರೆಗೆ. ಹ್ಯಾಂಡ್ಲರ್‌ಗಳನ್ನು ವೇಗವಾಗಿರಿಸಿ. ಮಿಶ್ರಣವೂ ಸರಿ: ಸಂಸ್ಥೆಯು ವೆಬ್‌ಹುಕ್ URL ಹೊಂದಿರುವ ಕರೆಯಲ್ಲಿ, endpoint ಹೊಂದಿರುವ ಸಾಧನಗಳನ್ನು ನೇರವಾಗಿ ಕರೆಯಲಾಗುತ್ತದೆ ಮತ್ತು ಉಳಿದವು ವೆಬ್‌ಹುಕ್‌ಗೆ ಮರಳುತ್ತವೆ.

ನೇರ ಎಂಡ್‌ಪಾಯಿಂಟ್ ಕರೆಗಳು#

AI endpoint ಹೊಂದಿರುವ ಟೂಲ್ ಅನ್ನು ಆಹ್ವಾನಿಸಿದಾಗ, ThunderPhone ನಿಮ್ಮ URL ಗೆ ವಿನಂತಿಯನ್ನು ಕಳುಹಿಸುತ್ತದೆ:

ವಿನಂತಿ ಹೆಡರ್‌ಗಳು#

POST /appointments/search HTTP/1.1
Host: api.example.com
Content-Type: application/json
X-ThunderPhone-Signature: abc123...
X-ThunderPhone-Call-ID: 987654321
X-Api-Key: your-api-key

ನಿಮ್ಮ endpoint.headers ನಿಂದ ಕಸ್ಟಮ್ ಹೆಡರ್‌ಗಳನ್ನು ಯಾವಾಗಲೂ ಬದಲಾವಣೆ ಇಲ್ಲದೆ ಸೇರಿಸಲಾಗುತ್ತದೆ, ಜೊತೆಗೆ ThunderPhone-ನೇಮ್‌ಸ್ಪೇಸ್ ಹೊಂದಿರುವ ಎರಡು ಹೆಡರ್‌ಗಳು:

• X-ThunderPhone-Signature — ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ವೆಬ್‌ಹುಕ್ ಸೀಕ್ರೆಟ್ ಬಳಸಿ ಕೀ ಮಾಡಲಾದ, ನಿಖರ ವಿನಂತಿ-ಬಾಡಿ ಬೈಟ್‌ಗಳ HMAC-SHA256
• X-ThunderPhone-Call-ID — ಪ್ರಸ್ತುತ ಕರೆ ID

ನಿಮ್ಮ endpoint.headers ಅದನ್ನು ಓವರ್‌ರೈಡ್ ಮಾಡದ ಹೊರತು Content-Type: application/json ಹೊಂದಿಸಲಾಗುತ್ತದೆ — ಕಸ್ಟಮ್ Content-Type ಗೆ ಆದ್ಯತೆ ಇರುತ್ತದೆ.

ವಿನಂತಿ ಬಾಡಿ#

POST / PUT / PATCH ಗಾಗಿ, ಬಾಡಿಯು ಮಾತ್ರ ಟೂಲ್ ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ (ಯಾವುದೇ ರ್ಯಾಪರ್ ಇಲ್ಲದೆ), ಕ್ಯಾನೊನಿಕಲ್ ಆಗಿ ಸೀರಿಯಲೈಸ್ ಮಾಡಲಾಗುತ್ತದೆ (ವಿಂಗಡಿಸಿದ ಕೀಗಳು, ಸಾಂದ್ರ ಸೆಪರೇಟರ್‌ಗಳು):

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

GET / DELETE ಗಾಗಿ, ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗಳನ್ನು ಕ್ವೆರಿ ಪ್ಯಾರಾಮೀಟರ್‌ಗಳಾಗಿ ಕಳುಹಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಬಾಡಿ ಖಾಲಿಯಾಗಿರುತ್ತದೆ — ಆಗ ಖಾಲಿ ಬೈಟ್ ಸ್ಟ್ರಿಂಗ್ ಮೇಲೆ ಸಹಿಯನ್ನು ಲೆಕ್ಕಹಾಕಲಾಗುತ್ತದೆ. ವೆಬ್‌ಹುಕ್ ಸಹಿಗಳನ್ನು ಪರಿಶೀಲಿಸಿ ನೋಡಿ.

ಪ್ರತಿಕ್ರಿಯೆ#

ಟೂಲ್ ಫಲಿತಾಂಶದೊಂದಿಗೆ JSON ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಹಿಂತಿರುಗಿಸಿ:

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

ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಫಾರ್ಮ್ಯಾಟ್ ಮಾಡಿ ಸಂವಾದವನ್ನು ಮುಂದುವರಿಸಲು AI ಗೆ ಒದಗಿಸಲಾಗುತ್ತದೆ. JSON ಅಲ್ಲದ ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು {"data": "<text>"} ಎಂದು ರ್ಯಾಪ್ ಮಾಡಲಾಗುತ್ತದೆ; ಟೈಮ್‌ಔಟ್‌ಗಳು ಮತ್ತು ಸಂಪರ್ಕ ವೈಫಲ್ಯಗಳನ್ನು AI ಗೆ ದೋಷಗಳಾಗಿ ವರದಿ ಮಾಡಲಾಗುತ್ತದೆ, ಆದ್ದರಿಂದ ಏಜೆಂಟ್ ಕ್ಷಮೆಯಾಚಿಸಿ ಸ್ಥಗಿತಗೊಳ್ಳುವ ಬದಲು ಮುಂದುವರಿಯಬಹುದು.

ವೆಬ್‌ಹುಕ್-ಮೋಡ್ ಡಿಸ್ಪ್ಯಾಚ್#

endpoint ಇಲ್ಲದ ಟೂಲ್‌ಗಳನ್ನು ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ಲೆಗಸಿ ವೆಬ್‌ಹುಕ್ 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 ಆಗಿ ಪ್ರತಿಕ್ರಿಯಿಸಿ — ನೇರ ಎಂಡ್‌ಪಾಯಿಂಟ್ ಕರೆಗಳಂತೆಯೇ ಅದೇ ಪ್ರತಿಕ್ರಿಯೆ ಒಪ್ಪಂದವಿದೆ. ಇತರ ಪ್ರತಿಯೊಂದು ವೆಬ್‌ಹುಕ್‌ನಂತೆ, ಕಚ್ಚಾ ಬಾಡಿಯ ಮೇಲೆ ಸಂಸ್ಥೆಯ ವೆಬ್‌ಹುಕ್ ಸೀಕ್ರೆಟ್ ಬಳಸಿ ವಿನಂತಿಗೆ ಸಹಿ ಮಾಡಲಾಗುತ್ತದೆ.

ಸಹಿ ಪರಿಶೀಲನೆ#

ನೇರ ಟೂಲ್ ಕರೆಗಳಿಗೆ ವೆಬ್‌ಹುಕ್‌ಗಳಂತೆಯೇ ಸಹಿ ಮಾಡಲಾಗುತ್ತದೆ:

• ನಿಖರವಾದ ವಿನಂತಿ-ಬಾಡಿ ಬೈಟ್‌ಗಳ ಮೇಲಿನ HMAC-SHA256 (ಕ್ಯಾನಾನಿಕಲ್ JSON — ವಿಂಗಡಿಸಲಾದ ಕೀಗಳು, ಹೆಚ್ಚುವರಿ ವೈಟ್‌ಸ್ಪೇಸ್ ಇಲ್ಲ)
• ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ವೆಬ್‌ಹುಕ್ ಸೀಕ್ರೆಟ್ ಬಳಸಿ ಕೀ ಮಾಡಲಾಗಿದೆ
• GET / DELETE ಟೂಲ್‌ಗಳು ಖಾಲಿ ಬೈಟ್ ಸ್ಟ್ರಿಂಗ್‌ಗೆ ಸಹಿ ಮಾಡುತ್ತವೆ

import hmac
import hashlib
 
def verify_tool_call(body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)
 
@app.post("/appointments/search")
async def search_appointments(request: Request):
    body = await request.body()
    signature = request.headers.get("X-ThunderPhone-Signature", "")
 
    if not verify_tool_call(body, signature, WEBHOOK_SECRET):
        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}

app.post('/appointments/search', express.raw({type: 'application/json'}), (req, res) => {
  const signature = req.headers['x-thunderphone-signature'] || '';
  const expected = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(req.body)
    .digest('hex');
 
  if (!signature ||
      signature.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) {
    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 });
});

ಖಾಲಿ-ಬಾಡಿ ಪ್ರಕರಣ ಮತ್ತು ಸೀಕ್ರೆಟ್ ಇಲ್ಲದಿರುವ ಎಚ್ಚರಿಕೆಯನ್ನು ಒಳಗೊಂಡ ಸಂಪೂರ್ಣ ಪಾಕವಿಧಾನಗಳು ವೆಬ್‌ಹುಕ್ ಸಹಿಗಳನ್ನು ಪರಿಶೀಲಿಸಿ ನಲ್ಲಿ ಇವೆ.

ಉದಾಹರಣೆ: ಸಂಪೂರ್ಣ ಬುಕಿಂಗ್ ಫ್ಲೋ#

ಸಂಪೂರ್ಣ ಅಪಾಯಿಂಟ್‌ಮೆಂಟ್ ಬುಕಿಂಗ್ ವ್ಯವಸ್ಥೆಗಾಗಿ ಟೂಲ್‌ಗಳ ಒಂದು ಸೆಟ್ ಇಲ್ಲಿದೆ:

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

ಉತ್ತಮ ಅಭ್ಯಾಸಗಳು#

ಸಂಬಂಧಿತ#