DocumentazioneL’endpoint dell’assistente

I tuoi assistenti

L’endpoint dell’assistente

Una sola richiesta in formato OpenAI. Il tuo assistente risponde con le sue istruzioni e la sua memoria, in streaming.

In questa pagina
  1. Chiamare l’assistente
  2. La risposta
  3. Cosa cambia rispetto a un modello da solo

Chiamare l’assistente

POST /v1/agents/chat/completions Un turno di conversazione completo.

Indica l’assistente con assistantId. Per continuare la stessa conversazione, invia invece threadId.

curl -N https://api.learnya.ai/v1/agents/chat/completions \
  -H "Authorization: Bearer $LEARNYA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "ASSISTANT_ID",
    "stream": true,
    "messages": [
      {"role": "user", "content": "Where is my invoice?"}
    ]
  }'

La risposta

ModalitàCosa ricevi
In streamingFrammenti chat.completion.chunk in formato OpenAI, poi [DONE]
Senza streamingUna risposta immediata senza testo, con finish_reason a queued e gli ID del thread, del messaggio e dell’esecuzione da seguire

Cosa cambia rispetto a un modello da solo

OggettoCon un assistente
Il campo modelSceglie il modello di questa risposta, non l’assistente
Messaggi tool e immaginiRifiutati: l’assistente chiama da sé i propri strumenti
Conteggio dei tokenUna stima, e completion_tokens vale 0
AccessoIl token di accesso di una persona, non una chiave API

Per un modello senza assistente, resta sulla conversazione semplice con una chiave API.