استفاده از ابزار در چت API پیکو با یک خروجی قابل بررسی

فرض کنید چت پشتیبانی باید وضعیت سفارش را از سیستم خودتان بخواند. مدل می‌تواند پیشنهاد دهد که تابع lookup_order با یک شناسه اجرا شود. اجرای تابع، بررسی دسترسی مشتری و تصمیم دربارهٔ دادهٔ قابل نمایش در بک‌اند شما انجام می‌شود.

قرارداد ابزار را محدود تعریف کنید

{
  "type": "function",
  "function": {
    "name": "lookup_order",
    "description": "وضعیت سفارش را برای مشتری واردشده برگردان",
    "parameters": {
      "type": "object",
      "properties": { "orderId": { "type": "string" } },
      "required": ["orderId"],
      "additionalProperties": false
    }
  }
}

این قرارداد را در آرایهٔ tools درخواست چت بفرستید. قابلیت ابزار را برای مدل و مسیر انتخابی با یک نمونهٔ کوچک بررسی کنید. اگر پاسخ شامل tool_calls بود، فقط نام‌های مجاز را بپذیرید، آرگومان‌ها را به عنوان ورودی غیرقابل اعتماد بررسی کنید و مالکیت سفارش را با نشست کاربر تطبیق دهید. نتیجهٔ تابع می‌تواند فقط وضعیت سفارش باشد.

حلقه را قابل کنترل نگه دارید

پس از اجرای ابزار، نتیجه را با شناسهٔ همان فراخوانی در پیام ابزار به مدل برگردانید تا پاسخ نهایی بسازد. سقف تعداد دورها را مشخص کنید و با رسیدن به سقف، مسیر عادی پشتیبانی را نشان دهید. برای عملیات تغییردهنده مثل لغو یا پرداخت، جریان تأیید جداگانه تعریف کنید.

برای شروع، یک سفارش ساختگی را تست کنید و ببینید درخواست نامعتبر یا سفارش کاربر دیگر به اجرای تابع نمی‌رسد. مستندات API پیکو