Skip to main content
POST
Crea una nuova sessione

Autorizzazioni

Authorization
string
header
obbligatorio

Chiave API personale (apk_user_*) o chiave API di servizio (apk_*)

Corpo

application/json
prompt
string
obbligatorio
idempotent
boolean
predefinito:false
knowledge_ids
string[] | null

Elenco degli ID di Knowledge da utilizzare. Se è None, utilizza tutta la Knowledge. Se è una lista vuota, non utilizzare alcuna Knowledge.

max_acu_limit
integer | null

Limite massimo di ACU, deve essere positivo

Intervallo richiesto: x > 0
playbook_id
string | null
secret_ids
string[] | null

Elenco di ID di secret da utilizzare. Se è None, vengono usati tutti i secret. Se è una lista vuota, non viene usato alcun secret.

session_secrets
SessionSecretInput · object[] | null

Elenco di segreti specifici della sessione da utilizzare. Questi segreti sono disponibili solo in questa sessione e non vengono archiviati tra i segreti dell’organizzazione.

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

Schema JSON (Draft 7) per convalidare l’output strutturato. Dimensione massima 64 KB. Deve essere autosufficiente (nessun $ref esterno).

tags
string[] | null

Elenco di tag da aggiungere alla sessione.

Maximum array length: 50
title
string | null

Titolo personalizzato per la sessione. Se è None, il titolo verrà generato automaticamente.

unlisted
boolean
predefinito:false

Risposta

Risposta corretta

Corpo della risposta restituito quando una sessione è stata creata correttamente.

session_id
string
obbligatorio
url
string
obbligatorio
is_new_session
boolean | null