Method: projects.locations.apps.chatAiAssistant

Exécute Arc, l'assistant IA, pour la session d'assistant spécifiée.

Requête HTTP

POST https://ces.googleapis.com/v1beta/{app=projects/*/locations/*/apps/*}:chatAiAssistant

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
app

string

Obligatoire. L'application pour laquelle exécuter l'assistant. Format : projects/{project}/locations/{location}/apps/{app}

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
Champs
assistantSession

string

Obligatoire. Session de l'assistant à utiliser pour exécuter l'assistant. Format : projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

string

Obligatoire. Message à envoyer à l'agent de l'assistant.
attachedGcsUris[]

string

Facultatif. URI Cloud Storage des fichiers importés par l'utilisateur au cours de ce tour. Exemple : "gs://cxas-transient-uploads/uuid/prd.pdf"
contextToken

string

Facultatif. Jeton de contexte d'intégration opaque renvoyé par SessionService.GenerateOnboardingSuggestions. Lorsqu'il est défini et toujours actualisé, le serveur réutilise l'instantané d'intégration calculé pour l'état zéro au lieu de le recalculer pour le premier tour de conversation.

Corps de la réponse

Message de réponse pour AssistantService.ChatAiAssistant.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "eventId": string,
  "eventTime": string,
  "uiEvent": {
    object (UiEvent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textChunk": string,
  "statusMessage": string,
  "sessionCheckpoint": {
    object (SessionCheckpoint)
  }
  // End of mutually exclusive fields.
}
Champs
eventId

string

Identifiant unique de l'événement.
eventTime

string (Timestamp format)

Code temporel de l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
uiEvent

object (UiEvent)

Facultatif. Charge utile de l'événement d'UI.
Charge utile de l'événement. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
textChunk

string

Jeton de texte (pour diffuser les réponses de Gemini mot par mot)
statusMessage

string

Mise à jour simple de l'état
sessionCheckpoint

object (SessionCheckpoint)

Événement de récapitulatif de point de contrôle/compactage de session contenant l'intention utilisateur et un résumé glissant.
Fin des champs mutuellement exclusifs.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource app :

  • ces.apps.update

Pour en savoir plus, consultez la documentation IAM.