Enviar una ejecución asíncrona del Agent de investigación.
Exa
Semantic search, page content, cited answers and asynchronous research.
Enviar una ejecución asíncrona del Agent de investigación.
Envía una tarea de investigación asíncrona. Proporciona query; opcionalmente systemPrompt y effort (solo minimal). Idempotency-Key es obligatorio. HTTP 202 devuelve un job; usa su id con el endpoint de sondeo de Felo correspondiente hasta completed, failed o cancelled. Los campos de precios del job son metadatos de autorización y liquidación del proveedor, no registros de facturación de Felo.
Referencia de precios
- Medición: referencia por solicitud fija.
- Estimación de referencia por solicitud: USD 0.1.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: stringIdempotency
- Key obligatorioLa longitud UTF-8 recortada debe ser de 1 a 191 bytes.
- Tipo: stringqueryobligatorio
Consulta no vacía después de recortar los espacios en blanco.
- Tipo: string | null enumeffort
Solo se admite el esfuerzo minimal; los valores omitidos, vacíos y null se normalizan a minimal.
valores- null
- minimal
- Tipo: string | nullsystem
Prompt
- Tipo: object202
Correcto
- Tipo: string | null Formato: date-timecompleted
At obligatoriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- Tipo: string | null Formato: date-timecreated
At obligatoriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- Tipo: string | nullendpointobligatorio
Identificador de operación del proveedor; usa la ruta de job documentada de Felo para el polling.
- Tipo: object | nullerrorobligatorio
- codeTipo: string | null
- messageTipo: string | null
- Tipo: string | nullidobligatorio
- objectconstante:integration_async_jobobligatorio
- outputobligatorio
- Tipo: object | nullpricingobligatorio
Metadatos de autorización y liquidación del proveedor en micro-USD; no son un saldo, una retención ni un recibo de facturación de Felo.
- authorizedTipo: integer | null
Micros U S D Integer numbers.
- billingTipo: string | null
Mode - currencyTipo: string | null
- finalTipo: integer | null
Micros U S D Integer numbers.
- Tipo: string enumstatusobligatoriovalores
- queued
- running
- completed
- failed
- cancelled
- Tipo: boolean | nulloutput
Expired
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
La operación falló. Guarda el ID de solicitud de la respuesta al contactar con el soporte de 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"
}