Exa
Semantic search, page content, cited answers and asynchronous research.
ارسال یک اجرای Agent پژوهشی ناهمگام.
یک وظیفه پژوهش ناهمگام ارسال کنید. query را بدهید؛ بهصورت اختیاری systemPrompt و effort (فقط minimal). Idempotency-Key الزامی است. HTTP 202 یک کار برمیگرداند؛ id آن را با نقطه پایانی بررسی دورهای متناظر Felo تا رسیدن به completed، failed یا cancelled استفاده کنید. فیلدهای قیمتگذاری کار، مجوز ارائهدهنده و فراداده تسویهاند، نه سوابق صورتحساب Felo.
مرجع قیمتگذاری
- اندازهگیری: مرجع به ازای هر درخواست.
- برآورد درخواست مرجع: 0.1 دلار آمریکا.
فقط فراداده مرجع، نه نقلقول حساب، نه قیمت تضمینشده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینههای نهایی تابع سوابق صورتحساب Felo است.
- نوع: stringIdempotency
- Key الزامیطول UTF-8 پس از حذف فاصلهها باید بین 1 تا 191 بایت باشد.
- نوع: stringqueryالزامی
پرسوجوی غیرخالی پس از حذف فاصلهها.
- نوع: string | null فهرست مقادیرeffort
فقط effort از نوع minimal پشتیبانی میشود؛ مقادیر حذفشده، خالی و null به minimal نرمال میشوند.
مقادیر- null
- minimal
- نوع: string | nullsystem
Prompt
- نوع: object202
موفقیت
- نوع: string | null قالب: date-timecompleted
At الزامیthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- نوع: string | null قالب: date-timecreated
At الزامیthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- نوع: string | nullendpointالزامی
شناسه عملیات ارائهدهنده؛ برای نظرسنجی از مسیر مستند وظیفه Felo استفاده کنید.
- نوع: object | nullerrorالزامی
- codeنوع: string | null
- messageنوع: string | null
- نوع: string | nullidالزامی
- objectمقدار ثابت:integration_async_jobالزامی
- outputالزامی
- نوع: object | nullpricingالزامی
فراداده مجوز و تسویه ارائهدهنده به میکرو-دلار؛ نه موجودی Felo، نه بلوکه و نه رسید صورتحساب Felo.
- authorizedنوع: integer | null
Micros U S D Integer numbers.
- billingنوع: string | null
Mode - currencyنوع: string | null
- finalنوع: integer | null
Micros U S D Integer numbers.
- نوع: string فهرست مقادیرstatusالزامیمقادیر
- queued
- running
- completed
- failed
- cancelled
- نوع: boolean | nulloutput
Expired
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمییابد چون یک الزام صورتحساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیدهاید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورتحساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
عملیات ناموفق بود. هنگام تماس با پشتیبانی Felo، شناسه درخواست پاسخ را نگه دارید.
curl https://openapi.felo.ai/v1/beta/exa/agent/runs \
--request POST \
--header 'Idempotency-Key: ' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"query": "Find the official documentation for Go"
}'
{
"completedAt": null,
"createdAt": null,
"endpoint": null,
"error": {
"code": null,
"message": null
},
"id": null,
"object": "integration_async_job",
"output": null,
"outputExpired": null,
"pricing": {
"authorizedMicrosUSD": null,
"billingMode": null,
"currency": null,
"finalMicrosUSD": null
},
"status": "queued"
}