cicora.ai
Especificação da APISaída unificada

API Responses

Use um objeto de entrada quando a sua aplicação beneficiar de tratar itens de saída e ações num único modelo de dados.

Referência de integração: escolha os parâmetros e as capacidades disponíveis nas definições da API da sua conta e no catálogo de modelos do seu ambiente.

Criar uma resposta

Um pedido Responses transporta model e input. O campo input pode ser uma cadeia curta ou um conjunto estruturado de itens quando o fluxo de trabalho o exige.

Conceba o processador em função da matriz de saída: o texto, uma chamada de ferramenta e os itens do serviço podem ter tipos diferentes.

Pedido da API Responses
bash
curl --request POST https://cicora.ai/api/v1/responses \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "input": "Summarize the incident report for an engineer."
  }'

Controlar o fluxo de trabalho

  • Conserve no seu sistema o ID da resposta e o ID de conversa ou sessão associado.
  • Limite no lado da aplicação as etapas automáticas de um ciclo de agente.
  • Verifique os parâmetros do modelo antes de acrescentar áudio, imagens ou ferramentas.

Analisar o resultado

Não dependa da posição de um único item de texto. Percorra output, extraia tipos reconhecidos e conserve os desconhecidos para observabilidade.

Quando precisar de transmissão, use a forma transmitida do mesmo fluxo e combine incrementos apenas pelos identificadores dos itens.