cicora.ai
API-määritysMessages-muoto

Messages API

Käytä Messages-muotoa keskusteluihin, joissa on ylimmän tason järjestelmäohje ja nimenomainen tulosteraja.

Integraatio-opas: valitse parametrit ja saatavilla olevat ominaisuudet ympäristösi tilin API-asetuksista ja malliluettelosta.

Muodosta viesti

Pyyntö sisältää mallin, viestit ja max_tokens-arvon; järjestelmäohje lähetetään erillisessä system-kentässä. Säilytä roolit ja viestijärjestys, jotta uusi yritys voi toistaa kontekstin.

Raakaa HTTP:tä käytettäessä kutsutaan osoitetta https://cicora.ai/api/v1/messages, kun taas Messages SDK saa vain yhdyskäytävän juuren https://cicora.ai/api ja lisää itse /v1/messages.

Messages API -pyyntö
bash
curl --request POST https://cicora.ai/api/v1/messages \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 500,
    "system": "Answer with a compact checklist.",
    "messages": [{"role": "user", "content": "Prepare a release plan."}]
  }'

Työkalut ja suoratoisto

  • Lisää tools ja tool_choice vain niitä tukeville malleille.
  • Käsittele suoratoistotilaa tapahtumajaksona yhden JSON-objektin sijasta.
  • Vahvista työkaluargumenttien rakenne ennen toiminnon suorittamista.

Valitse muoto

Älä sekoita kahden muodon kenttiä yhteen pyyntöön. Valitse asiakasrajalla chat- tai Messages-muoto ja normalisoi sisäinen historia kerran.

Testaa siirto tallennetulla tunnistetiedot poistetulla keskustelulla, joka sisältää työkalutuloksen ja pitkän kontekstin.