Skip to main content
POST
إنشاء استجابة

أدوات الخادم

تدعم /v1/responses أدوات الدوال العادية وأدوات الخادم التالية التي يديرها Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
  • phaseo:apply_patch

مثال التاريخ والوقت

عند استخدام أداة خادم، تتضمن بيانات الاستخدام العدادات المطابقة usage.server_tool_use.*.
  • gateway:datetime -> datetime_requests
  • phaseo:web_search -> web_search_requests, web_search_results, web_search_extra_results
  • phaseo:web_fetch -> web_fetch_requests
  • phaseo:advisor -> advisor_requests
  • phaseo:image_generation -> image_generation_requests
  • phaseo:apply_patch -> apply_patch_requests

ملاحظة حول البث

يدعم stream: true أيضًا. وبالنسبة إلى أدوات الخادم التي يديرها Gateway، قد يعالج Phaseo دور استدعاء الأداة لدى المزوّد، ثم يواصل الحلقة ويعيد إصدار تدفق اصطناعي.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json
model
string
مطلوب
input
مطلوب
background
boolean
include
string[]
instructions
string
max_output_tokens
integer
النطاق المطلوب: x >= 1
metadata
object
session_id
string

معرّف فريد لتجميع الطلبات المرتبطة (مثل محادثة أو سير عمل وكيل) لأغراض قابلية المراقبة.

Maximum string length: 256
parallel_tool_calls
boolean
previous_response_id
string
reasoning
object
service_tier
enum<string>
الخيارات المتاحة:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
store
boolean
stream
boolean
temperature
number
النطاق المطلوب: 0 <= x <= 2
text
object
tool_choice

استراتيجية اختيار الأدوات. تُقبل أنواع أدوات خادم Phaseo وتُحوّل إلى أهداف وظائف أو أدوات لدى المزوّد upstream.

الخيارات المتاحة:
auto,
none,
required,
phaseo:datetime,
phaseo:web_search,
phaseo:web_fetch,
phaseo:subagent,
phaseo:fusion,
phaseo:search_models,
gateway:datetime,
gateway:web_search,
gateway:web_fetch
tools
object[]

تعريفات الأدوات لاستدعاءات وظائف النماذج وأدوات خادم البوابة. أدوات خادم البوابة المدمجة هي gateway:datetime وgateway:web_search وgateway:web_fetch.

top_p
number
النطاق المطلوب: 0 <= x <= 1
truncation
enum<string>
الخيارات المتاحة:
auto,
disabled
user
string
prompt_cache_key
string | null
safety_identifier
string | null
modalities
enum<string>[]
الخيارات المتاحة:
text,
image,
audio
image_config
object
provider_options
object

خيارات خاصة بالمزوّد، اختيارية.

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

عناصر تحكم تصحيح أخطاء البوابة. لا تُمرر هذه العلامات إلى المزوّد مطلقًا.

provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

الاستجابة

استجابة

id
string
object
string
created
integer
model
string
provider
string
provider_id
string
nativeResponseId
string | null
status
enum<string>
الخيارات المتاحة:
completed,
failed,
incomplete
finish_reason
string | null
meta
object
cost_nanos
number
cost_cents
integer
currency
string
pricing_lines
object[]
output
object[]
output_items
object[]
content
object[]
role
string
stop_reason
string
type
string
usage
object
آخر تعديل في ٢ أكتوبر ٢٠٢٦