Enviar uma execução assíncrona do Agent de pesquisa.
Exa
Semantic search, page content, cited answers and asynchronous research.
Enviar uma execução assíncrona do Agent de pesquisa.
Envia uma tarefa de pesquisa assíncrona. Informe query; opcionalmente systemPrompt e effort (somente minimal). Idempotency-Key é obrigatório. HTTP 202 retorna um job; use seu id com o endpoint de consulta correspondente da Felo até completed, failed ou cancelled. Os campos de preço do job são metadados de autorização e liquidação do provedor, não registros de cobrança da Felo.
Referência de preços
- Medição: referência por requisição fixa.
- Estimativa de referência por requisição: USD 0.1.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: stringIdempotency
- Key obrigatórioO comprimento UTF-8 aparado deve ser de 1 a 191 bytes.
- Tipo: stringqueryobrigatório
Consulta não vazia após remover os espaços em branco.
- Tipo: string | null enumeffort
Apenas o esforço minimal é suportado; valores omitidos, vazios e null são normalizados para minimal.
valores- null
- minimal
- Tipo: string | nullsystem
Prompt
- Tipo: object202
Sucesso
- Tipo: string | null Formato: date-timecompleted
At obrigatóriothe 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 obrigatóriothe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- Tipo: string | nullendpointobrigatório
Identificador de operação do provedor; use o caminho de job documentado da Felo para o polling.
- Tipo: object | nullerrorobrigatório
- codeTipo: string | null
- messageTipo: string | null
- Tipo: string | nullidobrigatório
- objectconst:integration_async_jobobrigatório
- outputobrigatório
- Tipo: object | nullpricingobrigatório
Metadados de autorização e liquidação do provedor em micro-USD; não é saldo, retenção nem recibo de cobrança da 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 enumstatusobrigatóriovalores
- queued
- running
- completed
- failed
- cancelled
- Tipo: boolean | nulloutput
Expired
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
A operação falhou. Guarde o ID de requisição da resposta ao contatar o suporte da 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"
}