cicora.ai
Specifica APIOutput unificato

Responses API

Usa un solo oggetto di input quando è utile alla tua applicazione gestire elementi di output e azioni in un unico modello di dati.

Riferimento per l'integrazione: scegli i parametri e le funzionalità disponibili dalle impostazioni API del tuo account e dal catalogo dei modelli per il tuo ambiente.

Crea una risposta

Una richiesta Responses contiene model e input. L'input può essere una breve stringa o un insieme strutturato di elementi quando il flusso di lavoro lo richiede.

Progetta il gestore intorno all'array output: testo, chiamata di strumento ed elementi del servizio possono avere tipi diversi.

Richiesta Responses API
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."
  }'

Controlla il flusso di lavoro

  • Conserva nel tuo sistema l'ID risposta e l'ID conversazione o sessione associato.
  • Limita sul lato dell'applicazione i passaggi automatici in un ciclo di agente.
  • Controlla i parametri del modello prima di aggiungere audio, immagini o strumenti.

Analizza il risultato

Non fare affidamento sulla posizione di un singolo elemento di testo. Scorri l'output, estrai i tipi riconosciuti e conserva quelli sconosciuti per l'osservabilità.

Quando serve lo streaming, usa la forma streaming dello stesso flusso di lavoro e combina i delta solo in base agli identificatori degli elementi.