数据 API / Exa / Agent

Submit an asynchronous research Agent run.

Submit an asynchronous research task. query and Idempotency-Key are required. Configure effort, outputSchema, dataSources and previousRunId as needed. HTTP 202 returns a job; poll get_exa_agent_run until completed, failed or cancelled. Completed output contains text, structured data and grounding. Reusing an Idempotency-Key returns the existing job. Job pricing fields are provider metadata, not Felo billing records.

参数

请求头

Idempotency-Keystring必填
Unique key (1 to 191 characters) that makes the submit idempotent. Re-submitting with the same key and request fingerprint returns the original run.

请求体

querystring必填
The natural-language research query.
outputSchemaobject可选
JSON Schema used to validate the structured output.
inputobject可选
Row-processing input: rows to process and exclusions.
dataarray可选
Input rows for the run.
exclusion可选
Items to exclude from processing.
effortstring可选
Compute/depth tier for the run.
previousRunIdstring可选
Continue from a previously completed run.
dataSourcesarray可选
Third-party data sources (Exa Connect) the Agent is granted access to.

请求示例

curl -X POST "https://openapi.felo.ai/v1/beta/exa/agent/runs" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Idempotency-Key: <string>" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "<string>",
  "outputSchema": {},
  "input": {},
  "effort": "<string>",
  "previousRunId": "<string>",
  "dataSources": "<string>"
}'

响应

响应字段

idstring可选
Job identifier. Use it with the corresponding Felo polling endpoint.
objectstring可选
Always "integration_async_job".
endpointstring可选
Provider operation identifier stored with the job. This metadata is not a Felo polling URL; use the documented Felo job path or Location header.
statusstring可选
允许值： queued · running · completed · failed · cancelled
Customer-facing lifecycle status. queued and running are non-terminal; completed, failed, and cancelled are terminal.
createdAtstring可选
When the job was accepted.
completedAt可选
When the job reached a terminal status. Null while the job is still queued or running.
pricingobject可选
currencystring可选
authorizedMicrosUSDinteger可选
Provider authorization metadata in micro-USD. This is not a Felo credit hold or billing record.
finalMicrosUSD可选
Provider settlement metadata in micro-USD, nullable before settlement. This is not the Felo charge.
billingModestring可选
Provider job billing mode. Felo charges follow Felo billing records.
output可选
Job result payload. Present only once status is completed. For Agent Runs this is the structured research result.
outputExpiredboolean可选
True when the result has been retained past its retention window and is no longer retrievable.
error可选
Present when status is failed. Null otherwise.