ابزارها و خروجی ساختاریافته

ابزارها و خروجی ساختاریافته

POST /v1/chat/completions با کلید دارای responses:write از قالب OpenAI Chat Completions استفاده می‌کند. tools آرایه‌ای از function با name و parameters است. tool_choice می‌تواند auto، none، required یا نام یک تابع باشد. اجرای ابزار در برنامهٔ شما انجام می‌شود؛ ساروی نام تابع و arguments را برمی‌گرداند. نتیجهٔ هر ابزار را با role:tool و tool_call_id منطبق به تاریخچه اضافه کنید و درخواست بعدی را بفرستید. در فراخوانی موازی، همهٔ نتیجه‌ها لازم هستند. reasoning_details مدل را در تاریخچه حفظ کنید.

JSON Schema

response_format با type:json_schema و json_schema شامل name، schema و strict:true ارسال می‌شود. json_object فقط JSON درخواست می‌کند. پشتیبانی واقعی مدل را از supported_parameters در /v1/models بررسی کنید؛ قابلیت پشتیبانی‌نشده پیش از رزرو اعتبار خطا می‌دهد.

Responses

در /v1/responses ابزار تابع به‌صورت تخت با type، name و parameters و خروجی ساختاریافته با text.format ارسال می‌شود. برای ادامه، function_call و function_call_output با call_id منطبق را بفرستید. تاریخچه را خودتان ارسال کنید؛ previous_response_id پشتیبانی نمی‌شود. store:false است.

جریان و اعتبار

stream:true رویدادهای ابزار و متن را حفظ می‌کند. در Chat پایان معتبر [DONE] همراه finish_reason و در Responses رویداد response.completed است؛ بسته‌شدن اتصال به‌تنهایی موفقیت نیست. خطاهای جریان به‌صورت error یا response.failed می‌آیند. برای بررسی، X-Request-ID را نگه دارید. مصرف از موجودی مشترک همان حساب و با سقف پروژه و کلید محاسبه می‌شود. اگر خروجی تولید شود ولی مصرف ارائه‌دهنده نرسد، BILLING_SETTLEMENT_PENDING نمایش داده می‌شود و رزرو برای تطبیق نگه داشته می‌شود.

برنامهٔ محلی ساروی

Sarovi CLI ابزارهای فایل، ترمینال، مرورگر و برنامه‌های رایانه را در اختیار دارد و مدل‌ها را از همین API می‌گیرد. همهٔ مدل‌های گفتگوی پشتیبانی‌شده با اعتبار حساب قابل استفاده‌اند و به اشتراک حرفه‌ای نیاز ندارند. ورود مرورگری از /cli/connect یک کلید ۹۰روزه با سقف ماهانهٔ ۱۰٬۰۰۰ اعتبار می‌سازد. اتصال را هر زمان در /developers/connections قطع کنید.