عامل پشتیبانی و فروش

ساخت و انتشار

برای اجرای نسخهٔ منتشرشده، کلید محدود agents:run بساز. این کلید نمی‌تواند پیش‌نویس را اجرا کند، عامل را تغییر دهد، نسخه منتشر کند یا مدل‌ها را مستقیماً صدا بزند. کلیدهای قدیمی با agents:write و responses:write همچنان کار می‌کنند. مدیریت و اجرای پیش‌نویس به دسترسی‌های مدیریتی قبلی نیاز دارد. POST /v1/agents تعریف پایه را می‌سازد. با PATCH /v1/agents/{id}/configuration تنظیمات دانش، سقف اعتبار، نگهداری گفتگو، ثبت درخواست تماس و ارجاع انسانی را ذخیره کن. POST /v1/agents/{id}/publish یک نسخهٔ ثابت از دستورها، مدل و تنظیمات منتشر می‌کند. تغییر پیش‌نویس روی نسخهٔ زنده اثر ندارد.

گفتگو

POST /v1/agents/{id}/chat ورودی input، customer_id و در ادامه conversation_id را می‌گیرد. شناسهٔ مشتری را در سرور از هویت برنامه بساز؛ آن را مستقیماً از ورودی مرورگر نپذیر. هر گفتگو به پروژه، عامل و مشتری مشخص تعلق دارد. پاسخ شامل output_text، sources، outcomes، conversation_id و version است. draft:true پیش‌نویس را با اعتبار واقعی آزمایش می‌کند. اجرای Work همچنان از /runs استفاده می‌کند.

کارهای کسب‌وکار

عامل می‌تواند درخواست تماس با رضایت مشتری یا ارجاع انسانی ثبت کند. نتیجه در تاریخچهٔ عامل ذخیره می‌شود و رویداد agent.lead یا agent.handoff به وب‌هوک متصل می‌رود. این ثبت، رزرو قطعی نوبت یا تضمین پاسخ‌گویی نیست. برای اتصال CRM یا تقویم، گیرندهٔ رویداد باید شناسه را ذخیره و اقدام را با دسترسی کسب‌وکار اجرا کند.

محدودیت‌های اجرا

در بخش «محدودیت‌ها و دسترسی» می‌توان پاسخ‌گویی را متوقف کرد، سقف نویسهٔ ورودی، توکن خروجی و مراحل مدل را تعیین کرد و وجود منبع دانش را برای اجرا الزامی کرد. این تنظیمات جزو نسخه‌اند و پس از انتشار اعمال می‌شوند؛ درخواست در حال اجرا با تنظیمات قبلی ادامه دارد. enabled:false درخواست‌های تازه را با AGENT_PAUSED رد می‌کند. max_input_chars سقف ورودی، max_output_tokens سقف خروجی هر مرحله و max_steps سقف مراحل مدل است. require_knowledge:true اجرای بدون منبع بازیابی‌شده را رد می‌کند؛ این گزینه تضمین صحت معنایی پاسخ نیست. مدل فقط ابزارهای فعال ثبت تماس و ارجاع را در اختیار دارد.

کنترل و نگهداری

max_credits سقف هر نوبت پاسخ، شامل مراحل ابزار، است. گفتگوها ۷ یا ۳۰ روز نگهداری می‌شوند. GET /v1/conversations/{id}?customer_id=... تاریخچه و DELETE همان نشانی حذف آن را انجام می‌دهد. اجرای هم‌زمان در یک گفتگو با CONVERSATION_BUSY رد می‌شود. GET /v1/agents/{id}/history اجرای اخیر را می‌دهد. GET /versions نسخه‌ها و POST /publish با restore_version نسخهٔ پیشین را به‌عنوان انتشار تازه فعال می‌کند.