Objets partages

Cible de modele

Les endpoints de chat utilisent une chaine cible:

group:123e4567-e89b-12d3-a456-426614174000
custom:123e4567-e89b-12d3-a456-426614174111

Utilisez group:<uuid> pour un groupe de modeles et custom:<uuid> pour un modele personnalise.

Message de chat

Structure generale:

{
  "role": "user",
  "content": "Mon message"
}

Version avec contenu compose:

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "Analyse ce contenu"
    }
  ]
}

denied_tools

Utilise par POST /v1/chat/resume pour refuser une execution.

[
  {
    "tool_execution_id": "1fb2fd25-8f78-412a-a0b8-7976e3700fc4",
    "reason": "Action refusee"
  }
]

reason est optionnel et peut contenir jusqu’a 2000 caracteres.

Portee de partage

Les outils, ressources API et fichiers televerses peuvent etre partages avec des equipes, des modeles personnalises ou des groupes de modeles.

{
  "type": "team",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Valeurs acceptees pour type:

• team
• customModel
• groupModel

Reference de modele

Les groupes de modeles utilisent des objets ModelRef pour le brain et les agents.

{
  "type": "custom",
  "customModelId": "123e4567-e89b-12d3-a456-426614174111"
}

Formes acceptees:

• { "type": "llm", "llmModelName": "gpt-5-mini" }
• { "type": "custom", "customModelId": "<uuid>" }
• { "type": "group", "groupModelId": "<uuid>" }

usage

Objet de consommation renvoye dans les reponses standards:

{
  "prompt_tokens": 120,
  "completion_tokens": 84,
  "total_tokens": 204
}

En streaming, la meme structure peut apparaitre dans un evenement SSE data: avant data: [DONE].

kitemesh

Certaines reponses ajoutent un objet kitemesh utile cote client.

Exemples de champs possibles:

• approval_id
• execution_id
• expires_at
• credits_charged
• request_id

tool_calls

Quand une approbation est requise, les appels d’outils apparaissent dans tool_calls.

[
  {
    "id": "1fb2fd25-8f78-412a-a0b8-7976e3700fc4",
    "type": "function",
    "function": {
      "name": "create_ticket",
      "arguments": "{\"priority\":\"high\"}"
    }
  }
]

Erreur standard

Les erreurs suivent la structure suivante:

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "request_id": "req_123"
  }
}