cicora.ai
Čeština
Specifikace APIJednotný výstup

Responses API

Použijte jeden vstupní objekt, pokud je pro vaši aplikaci výhodné zpracovávat výstupní položky a akce v jediném datovém modelu.

Referenční dokumentace integrace: parametry a dostupné možnosti vybírejte v nastavení API svého účtu a v katalogu modelů pro své prostředí.

Vytvoření odpovědi

Požadavek Responses obsahuje model a input. Input může být krátký řetězec nebo strukturovaná sada položek, pokud to pracovní postup vyžaduje.

Obslužnou rutinu navrhněte s ohledem na výstupní pole: text, volání nástroje a položky služby mohou mít různé typy.

Požadavek 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."
  }'

Řízení pracovního postupu

  • ID odpovědi a související ID konverzace nebo relace uchovávejte ve vlastním systému.
  • Počet automatických kroků ve smyčce agenta omezte na straně aplikace.
  • Před přidáním zvuku, obrázků nebo nástrojů zkontrolujte parametry modelu.

Zpracování výsledku

Nespoléhejte na pozici jedné textové položky. Projděte výstup, extrahujte rozpoznané typy a neznámé typy uchovejte pro pozorovatelnost.

Je-li potřeba streamování, použijte streamovací variantu stejného pracovního postupu a delty spojujte pouze podle identifikátorů položek.

Kam dál