Felo API PlatformFelo API Platform
Tous les endpoints Exa
v0.2.0-beta
OpenAPI 3.1.0

Soumettre une exécution asynchrone de l'Agent de recherche.

Serveur:https://openapi.felo.ai
Bibliothèques clientes

Exa

​

Semantic search, page content, cited answers and asynchronous research.

Soumettre une exécution asynchrone de l'Agent de recherche.

​

Soumet une tâche de recherche asynchrone. Fournissez query ; éventuellement systemPrompt et effort (minimal uniquement). Idempotency-Key est obligatoire. HTTP 202 renvoie un job ; utilisez son id avec le point de terminaison d'interrogation Felo correspondant jusqu'à completed, failed ou cancelled. Les champs de tarification du job sont des métadonnées d'autorisation et de règlement du fournisseur, et non des enregistrements de facturation Felo.

Référence tarifaire

  • Mesure : référence par requête fixe.
  • Estimation de référence par requête : USD 0.1.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

En-têtes
  • Idempotency-Key
    Type: string
    obligatoire

    La longueur UTF-8 après rognage doit être comprise entre 1 et 191 octets.

Corps
obligatoire
application/json
  • query
    Type: string
    obligatoire

    Requête non vide après suppression des espaces.

  • effort
    Type: string | null enum

    Seul l'effort minimal est pris en charge ; les valeurs omises, vides et null sont normalisées en minimal.

    valeurs
    • null
    • minimal
  • systemPrompt
    Type: string | null
Réponses
  • 202
    Type: object

    Succès

    • completedAt
      Type: string | null Format: date-time
      obligatoire

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

    • createdAt
      Type: string | null Format: date-time
      obligatoire

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

    • endpoint
      Type: string | null
      obligatoire

      Identifiant d'opération du fournisseur ; utilisez le chemin de job Felo documenté pour le polling.

    • error
      Type: object | null
      obligatoire
      • code
        Type: string | null
      • message
        Type: string | null
    • id
      Type: string | null
      obligatoire
    • object
      constante:  
      integration_async_job
      obligatoire
    • output
      obligatoire
    • pricing
      Type: object | null
      obligatoire

      Métadonnées d'autorisation et de règlement du fournisseur en micro-USD ; ni un solde, ni une retenue, ni un reçu de facturation Felo.

      • authorizedMicrosUSD
        Type: integer | null

        Integer numbers.

      • billingMode
        Type: string | null
      • currency
        Type: string | null
      • finalMicrosUSD
        Type: integer | null

        Integer numbers.

    • status
      Type: string enum
      obligatoire
      valeurs
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      Type: boolean | null
    application/json
  • 400

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    L'opération a échoué. Conservez l'ID de requête de la réponse lorsque vous contactez le support 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.