Felo API PlatformFelo API Platform
כל ה-endpoints של Exa
v0.2.0-beta
OpenAPI 3.1.0

שליחת ריצת Agent מחקרית אסינכרונית.

שרת:https://openapi.felo.ai
ספריות לקוח

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.

כותרות
  • Idempotency-Key
    סוג: string
    חובה

    אורך UTF-8 לאחר קיצוץ חייב להיות בין 1 ל-191 בייטים.

גוף
חובה
application/json
  • query
    סוג: string
    חובה

    שאילתה לא ריקה לאחר הסרת רווחים.

  • effort
    סוג: string | null enum

    רק effort מסוג minimal נתמך; ערכים שהושמטו, ריקים ו-null מנורמלים ל-minimal.

    ערכים
    • null
    • minimal
  • systemPrompt
    סוג: string | null
תגובות
  • 202
    סוג: object

    הצלחה

    • completedAt
      סוג: string | null פורמט: date-time
      חובה

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • createdAt
      סוג: string | null פורמט: date-time
      חובה

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • endpoint
      סוג: string | null
      חובה

      מזהה פעולת ספק; השתמשו בנתיב המשימה המתועד של Felo לסקירה.

    • error
      סוג: object | null
      חובה
      • code
        סוג: string | null
      • message
        סוג: string | null
    • id
      סוג: string | null
      חובה
    • object
      const:  
      integration_async_job
      חובה
    • output
      חובה
    • pricing
      סוג: object | null
      חובה

      מטא-נתוני הרשאה והסדר של הספק במיקרו-דולר; אינם יתרת Felo, החזקה או קבלת חיוב.

      • authorizedMicrosUSD
        סוג: integer | null

        Integer numbers.

      • billingMode
        סוג: string | null
      • currency
        סוג: string | null
      • finalMicrosUSD
        סוג: integer | null

        Integer numbers.

    • status
      סוג: string enum
      חובה
      ערכים
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      סוג: boolean | null
    application/json
  • 400

    לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    הפעולה נכשלה. שמרו את מזהה הבקשה של התגובה בעת יצירת קשר עם תמיכת Felo.

Request Example for post/v1/beta/exa/agent/runs
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"
}
Submit an asynchronous research Agent run.