Passer à la navigation

Envoyer un message de conversation

Alpha

Envoie une entrée à une conversation et attend que l’agent termine ou attende les résultats d’un outil client. Lorsque background est défini sur true, l’endpoint renvoie 202 lorsque le serveur accepte le tour. Diffusez ensuite les événements du tour en définissant Last-Event-ID sur stream_cursor. Cet endpoint est en version alpha et peut évoluer.

Paramètres de chemin

conversation_idstringRequis

L’ID de la conversation

En-têtes

xi-api-keystringOptionnel

Requête

This endpoint expects an object.
inputlist of objectsRequis

Soit un seul user_message, qui commence un nouveau tour, soit des éléments client_tool_result, qui répondent aux required_actions du tour en attente et le poursuivent. Les appels omis restent en attente. Les outils clients attendent sans délai d’expiration. Tant que des appels sont en attente, un user_message est rejeté. Un user_message peut inclure des éléments contextual_update, au maximum un par context_id. Les éléments client_tool_result qui répondent à tous les appels en attente peuvent inclure des mises à jour end.

backgroundbooleanOptionnelPar défaut false

Si sa valeur est true, renvoie un identifiant 202 une fois le tour accepté, au lieu d’attendre la fin de la génération.

Réponse

Réponse réussie

turn_idstring
statusenum
Valeurs autorisées:
outputlist of objectsOptionnel
errorobject or nullOptionnel
required_actionslist of objectsOptionnel

Actions que l’agent attend. Répondez à chaque client_tool_call par un élément client_tool_result dans input pour continuer.

stream_cursorstring or nullOptionnel

Jeton de reprise pour le flux d’événements de ce tour. Présent tant que le tour est en cours ; transmettez-le comme Last-Event-ID pour diffuser les événements du tour.

Erreurs

422
Unprocessable Entity Error