Outil : update_app
Met à jour l'application spécifiée. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP update_app.
| Requête curl |
|---|
curl --location 'https://ces.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "update_app", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Schéma d'entrée
Message de requête pour AgentService.UpdateApp.
UpdateAppRequest
| Représentation JSON |
|---|
{
"app": {
object ( |
| Champs | |
|---|---|
app |
Obligatoire. Application à mettre à jour. |
updateMask |
Facultatif. Le masque de champ permet de contrôler les champs à mettre à jour. Si le masque n'est pas présent, tous les champs seront mis à jour. Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : |
Application
| Représentation JSON |
|---|
{ "name": string, "displayName": string, "description": string, "pinned": boolean, "rootAgent": string, "languageSettings": { object ( |
| Champs | |
|---|---|
name |
Identifiant. Identifiant unique de l'application. Format : |
displayName |
Obligatoire. Nom à afficher de l'application. |
description |
Facultatif. Description lisible par l'humain de l'application. |
pinned |
Facultatif. Indique si l'application est épinglée dans la liste des applications. |
rootAgent |
Facultatif. L'agent racine est le point d'entrée de l'application. Format : |
languageSettings |
Facultatif. Paramètres de langue de l'application. |
timeZoneSettings |
Facultatif. Paramètres de fuseau horaire de l'application. |
audioProcessingConfig |
Facultatif. Configuration du traitement audio de l'application. |
loggingSettings |
Facultatif. Paramètres de journalisation de l'application. |
errorHandlingSettings |
Facultatif. Paramètres de gestion des exceptions de l'application. |
modelSettings |
Facultatif. Paramètres du modèle LLM par défaut pour l'application. Les ressources individuelles (par exemple, les agents, les garde-fous) peuvent remplacer ces configurations si nécessaire. |
toolExecutionMode |
Facultatif. Mode d'exécution de l'outil pour l'application. S'il n'est pas fourni, la valeur par défaut est PARALLEL. |
evaluationMetricsThresholds |
Facultatif. Seuils d'évaluation de l'application. |
variableDeclarations[] |
Facultatif. Déclarations des variables. |
predefinedVariableDeclarations[] |
Uniquement en sortie. Déclarations des variables prédéfinies pour l'application. |
globalInstruction |
Facultatif. Instructions pour tous les agents de l'application. Vous pouvez utiliser cette instruction pour configurer une identité ou une personnalité stable pour tous les agents. |
guardrails[] |
Facultatif. Liste des garde-fous de l'application. Format : |
dataStoreSettings |
Facultatif. Paramètres du data store pour l'application. |
defaultChannelProfile |
Facultatif. Profil de canal par défaut utilisé par l'application. |
metadata |
Facultatif. Métadonnées sur l'application. Ce champ peut être utilisé pour stocker des informations supplémentaires pertinentes sur les détails de l'application ou les utilisations prévues. Objet contenant une liste de paires |
createTime |
Uniquement en sortie. Code temporel de la création de l'application. 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 : |
updateTime |
Uniquement en sortie. Code temporel de la dernière mise à jour de l'application. 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 : |
etag |
Uniquement en sortie. Etag utilisé pour s'assurer que l'objet n'a pas changé lors d'une opération de lecture-modification-écriture. Si l'etag est vide, la mise à jour écrasera toutes les modifications simultanées. |
deploymentCount |
Uniquement en sortie. Nombre de déploiements dans l'application. |
clientCertificateSettings |
Facultatif. Paramètres de certificat client par défaut pour l'application. |
vpcScSettings |
Facultatif. Paramètres VPC-SC de l'application. |
locked |
Facultatif. Indique si l'application est verrouillée pour les modifications. Si l'application est verrouillée, les modifications apportées aux ressources de l'application seront refusées. |
validationErrors[] |
Uniquement en sortie. Erreurs de configuration ou avertissements dans l'application. |
dashboardSettings |
Facultatif. Paramètres de tableau de bord spécifiques à l'application pour associer et configurer les tableaux de bord Contact Center Insights. |
LanguageSettings
| Représentation JSON |
|---|
{ "defaultLanguageCode": string, "supportedLanguageCodes": [ string ], "enableMultilingualSupport": boolean, "fallbackAction": string } |
| Champs | |
|---|---|
defaultLanguageCode |
Facultatif. Code de langue par défaut de l'application. |
supportedLanguageCodes[] |
Facultatif. Liste des codes de langue acceptés par l'application, en plus de |
enableMultilingualSupport |
Facultatif. Active la compatibilité multilingue. Si cette option est définie sur |
fallbackAction |
Facultatif. Obsolète : cette fonctionnalité n'est plus disponible. Utilisez plutôt Il peut s'agir d'une action prédéfinie ou d'un appel d'outil personnalisé. Les valeurs valides sont les suivantes : - Nom complet de la ressource d'un outil, qui déclenche l'exécution d'un outil spécifique. - Une action système prédéfinie, telle que "escalate" ou "exit", qui déclenche un signal |
TimeZoneSettings
| Représentation JSON |
|---|
{ "timeZone": string } |
| Champs | |
|---|---|
timeZone |
Facultatif. Fuseau horaire de l'application issu de la base de données des fuseaux horaires (par exemple, America/Los_Angeles, Europe/Paris). |
AudioProcessingConfig
| Représentation JSON |
|---|
{ "synthesizeSpeechConfigs": { string: { object ( |
| Champs | |
|---|---|
synthesizeSpeechConfigs |
Facultatif. Configuration de la synthèse de la réponse de l'agent, mappage du code de langue vers Si la configuration du code de langue spécifié est introuvable, la configuration du code de langue racine sera utilisée. Par exemple, si la carte contient "en-us" et "en", et que le code de langue spécifié est "en-gb", la configuration "en" sera utilisée. Remarque : Le code de langue n'est pas sensible à la casse. Objet contenant une liste de paires |
bargeInConfig |
Facultatif. Configure le comportement de l'agent pour les activités d'interruption de l'utilisateur. |
inactivityTimeout |
Facultatif. Durée d'inactivité de l'utilisateur (pas de parole ni d'interaction) avant que l'agent ne l'invite à se réengager. Si ce paramètre n'est pas défini, l'agent n'invitera pas l'utilisateur à se réengager. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
ambientSoundConfig |
Facultatif. Configuration du son ambiant à diffuser avec la réponse synthétisée de l'agent, afin d'améliorer le naturel de la conversation. |
customVoiceSamples[] |
Facultatif. Configure des échantillons de voix personnalisés pour le clonage de voix. |
SynthesizeSpeechConfigsEntry
| Représentation JSON |
|---|
{
"key": string,
"value": {
object ( |
| Champs | |
|---|---|
key |
|
value |
|
SynthesizeSpeechConfig
| Représentation JSON |
|---|
{ "voice": string, "speakingRate": number, "model": string, "instruction": string } |
| Champs | |
|---|---|
voice |
Facultatif. Nom de la voix. Si ce champ n'est pas défini, le service choisit une voix en fonction des autres paramètres, tels que language_code. Pour obtenir la liste des voix disponibles, consultez Voix et langues disponibles dans Cloud Text-to-Speech. |
speakingRate |
Facultatif. La vitesse d'élocution dans la plage [0,25, 2,0]. La valeur 1,0 correspond à la vitesse native normale compatible avec la voix spécifique. La valeur 2,0 est deux fois plus rapide et la valeur 0,5 est deux fois moins rapide. Les valeurs en dehors de la plage [0,25, 2,0] renverront une erreur. |
model |
Facultatif. Modèle utilisé pour synthétiser l'audio. Valeurs actuellement acceptées : - "gemini-3.1-flash-tts-preview" Si ce champ est vide, Chirp3-HD est utilisé. |
instruction |
Facultatif. Instruction utilisée pour synthétiser la voix lors de l'utilisation d'un modèle génératif. |
BargeInConfig
| Représentation JSON |
|---|
{ "disableBargeIn": boolean, "bargeInAwareness": boolean } |
| Champs | |
|---|---|
disableBargeIn |
Facultatif. Obsolète : Désactive l'interruption par l'utilisateur pendant que l'agent parle. Si la valeur est définie sur "true", l'entrée utilisateur pendant la lecture de la réponse de l'agent sera ignorée. |
bargeInAwareness |
Facultatif. Si cette option est activée, l'agent adaptera sa prochaine réponse en partant du principe que l'utilisateur n'a pas entendu l'intégralité du message précédent de l'agent. Cette option ne doit pas être utilisée dans les scénarios où les réponses de l'agent sont affichées visuellement. |
Durée
| Représentation JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Champs | |
|---|---|
seconds |
Secondes signées de l'intervalle de temps. Doit être compris entre -315 576 000 000 et +315 576 000 000 inclus. Remarque : Ces limites sont calculées à partir de : 60 s/min * 60 min/h * 24 h/jour * 365,25 jours/an * 10 000 ans. |
nanos |
Fractions de seconde signées à une résolution de l'ordre de la nanoseconde de l'intervalle de temps. Les durées inférieures à une seconde sont représentées par un champ |
AmbientSoundConfig
| Représentation JSON |
|---|
{ "volumeGainDb": number, // Union field |
| Champs | |
|---|---|
volumeGainDb |
Facultatif. Gain de volume (en dB) du volume natif normal compatible avec le bruit ambiant, dans la plage [-96,0, 16,0]. Si la valeur n'est pas définie ou si elle est définie sur une valeur de zéro (dB), elle est lue à une amplitude de signal natif normal. Une valeur de -6 (dB) est lue avec environ la moitié de l'amplitude du signal natif normal. Une valeur de +6 (dB) est lue avec environ deux fois plus d'amplitude que le signal natif normal. Nous vous recommandons vivement de ne pas dépasser +10 (dB), car il n'y a généralement pas d'augmentation efficace du volume pour une valeur supérieure à cette valeur. |
Champ d'union source. Bruit ambiant à diffuser avec la réponse de l'agent synthétisée, pour améliorer le naturel de la conversation. source ne peut être qu'un des éléments suivants : |
|
prebuiltAmbientNoise |
Facultatif. Obsolète : |
gcsUri |
Facultatif. Bruit ambiant sous forme de fichier WAV monocanal de 16 kHz stocké dans Cloud Storage. Remarque : Veuillez vous assurer que l'agent de service CES |
prebuiltAmbientSound |
Facultatif. Nom du son d'ambiance prédéfini. Les valeurs valides sont les suivantes : - "coffee_shop" - "keyboard" - "keypad" - "hum" - "office_1" - "office_2" - "office_3" - "room_1" - "room_2" - "room_3" - "room_4" - "room_5" - "air_conditioner" |
CustomVoiceSample
| Représentation JSON |
|---|
{ "name": string, "voiceSampleGcsUri": string, "consentAudioGcsUri": string, "voiceInstruction": string, "previewAudioContent": string, "previewText": string, "warnings": [ { object ( |
| Champs | |
|---|---|
name |
Facultatif. Nom défini par l'utilisateur pour l'échantillon de voix personnalisée. |
voiceSampleGcsUri |
Facultatif. URI Cloud Storage de l'échantillon audio pour le clonage de voix. L'échantillon audio doit être un fichier WAV monocanal de 24 kHz. |
consentAudioGcsUri |
Facultatif. Audio de consentement pour le clonage vocal. |
voiceInstruction |
Facultatif. Instructions en langage naturel pour le style, le ton, le rythme ou la prononciation de la voix. |
previewAudioContent |
Uniquement en sortie. Aperçu audio synthétisé pour la voix personnalisée, au format WAV canonique (LINEAR16, 24 kHz, 16 bits, mono). Chaîne encodée en base64. |
previewText |
Facultatif. Texte pour synthétiser l'aperçu audio d'une voix personnalisée. |
warnings[] |
Uniquement en sortie. Messages d'avertissement rencontrés lors du traitement du clonage vocal (par exemple, niveau audio faible). |
voiceInstructionMode |
Facultatif. Mode d'instruction pour l'extrait de voix. Si aucune valeur n'est spécifiée, la valeur par défaut est NO_INSTRUCTION. |
Avertissement
| Représentation JSON |
|---|
{
"message": string,
"type": enum ( |
| Champs | |
|---|---|
message |
Uniquement en sortie. Description lisible par l'humain de l'avertissement. |
type |
Uniquement en sortie. Type d'avertissement. |
LoggingSettings
| Représentation JSON |
|---|
{ "redactionConfig": { object ( |
| Champs | |
|---|---|
redactionConfig |
Facultatif. Configuration du masquage des données sensibles. |
audioRecordingConfig |
Facultatif. Configuration de l'enregistrement des interactions audio. L'audio est soumis à une occultation, comme configuré dans |
unredactedAudioRecordingConfig |
Facultatif. Configure un enregistrement supplémentaire de l'audio non masqué. Cela peut être utile pour conserver une copie audio brute lorsque la suppression audio est |
bigqueryExportSettings |
Facultatif. Configure les comportements d'exportation BigQuery pour l'application. Les données de conversation sont soumises à une occultation, comme configuré dans |
unredactedBigqueryExportSettings |
Facultatif. Configure les comportements d'exportation BigQuery pour l'application. Les données de conversation non masquées seront exportées vers des tables BigQuery si cette option est activée. |
cloudLoggingSettings |
Facultatif. Paramètres décrivant les comportements de Cloud Logging pour l'application. |
conversationLoggingSettings |
Facultatif. Paramètres décrivant les comportements de journalisation des conversations pour l'application. |
evaluationAudioRecordingConfig |
Facultatif. Configuration de l'enregistrement des interactions audio pour l'évaluation. Par défaut, l'enregistrement audio n'est pas activé pour les sessions d'évaluation. |
metricAnalysisSettings |
Facultatif. Paramètres décrivant les comportements de collecte des données de conversation pour le pipeline d'analyse LLM de l'application. |
requiredRecordingConsent |
Facultatif. Si l'application doit indiquer ce qui peut être enregistré avant que quoi que ce soit ne soit conservé. Si la valeur est "true", une session démarre avec l'enregistrement désactivé et reste désactivée jusqu'à ce que le client envoie Lorsque la valeur est |
RedactionConfig
| Représentation JSON |
|---|
{ "enableRedaction": boolean, "inspectTemplate": string, "deidentifyTemplate": string } |
| Champs | |
|---|---|
enableRedaction |
Facultatif. Si la valeur est |
inspectTemplate |
Facultatif. Nom du modèle d'inspection DLP pour configurer la détection des types de données sensibles. Format : |
deidentifyTemplate |
Facultatif. Nom du modèle d'anonymisation DLP pour indiquer comment anonymiser le contenu. Format : |
AudioRecordingConfig
| Représentation JSON |
|---|
{ "gcsBucket": string, "gcsPathPrefix": string } |
| Champs | |
|---|---|
gcsBucket |
Facultatif. Le bucket Cloud Storage pour stocker les enregistrements audio de la session. L'URI doit commencer par "gs://". Veuillez choisir un emplacement de bucket qui répond à vos exigences de résidence des données. Remarque : Si le bucket Cloud Storage se trouve dans un projet différent de celui de l'application, vous devez accorder l'autorisation |
gcsPathPrefix |
Facultatif. Préfixe du chemin d'accès Cloud Storage pour les enregistrements audio. Ce préfixe peut inclure les espaces réservés suivants, qui seront remplacés de manière dynamique au moment de la diffusion : - $project : ID du projet - $location : emplacement de l'application - $app : ID de l'application - $date : date de la session au format AAAA-MM-JJ - $session : ID de la session Si le préfixe de chemin d'accès n'est pas spécifié, le préfixe par défaut |
BigQueryExportSettings
| Représentation JSON |
|---|
{ "enabled": boolean, "project": string, "dataset": string } |
| Champs | |
|---|---|
enabled |
Facultatif. Indique si l'exportation BigQuery est activée. |
project |
Facultatif. L'ID du projet de l'ensemble de données BigQuery vers lequel exporter les données. Remarque : Si l'ensemble de données BigQuery se trouve dans un projet différent de celui de l'application, vous devez attribuer le rôle |
dataset |
Facultatif. ID de l'ensemble de données BigQuery vers lequel exporter les données. |
CloudLoggingSettings
| Représentation JSON |
|---|
{ "enableCloudLogging": boolean } |
| Champs | |
|---|---|
enableCloudLogging |
Facultatif. Indique si Cloud Logging doit être activé pour les sessions. |
ConversationLoggingSettings
| Représentation JSON |
|---|
{ "disableConversationLogging": boolean, "retentionWindow": string } |
| Champs | |
|---|---|
disableConversationLogging |
Facultatif. Indique si la journalisation des conversations doit être désactivée pour les sessions. |
retentionWindow |
Facultatif. Contrôle la période de conservation de la conversation. Si ce champ n'est pas défini, la conversation sera conservée pendant 365 jours. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
MetricAnalysisSettings
| Représentation JSON |
|---|
{ "llmMetricsOptedOut": boolean } |
| Champs | |
|---|---|
llmMetricsOptedOut |
Facultatif. Indique si les données de conversation doivent être collectées pour les métriques d'analyse LLM. Si la valeur est "true", les données de conversation ne seront pas collectées pour les métriques d'analyse LLM. Sinon, les données de conversation seront collectées. |
ErrorHandlingSettings
| Représentation JSON |
|---|
{ "errorHandlingStrategy": enum ( |
| Champs | |
|---|---|
errorHandlingStrategy |
Facultatif. Stratégie à utiliser pour la gestion des exceptions. |
fallbackResponseConfig |
Facultatif. Configuration pour la gestion des réponses de remplacement. |
endSessionConfig |
Facultatif. Configuration pour mettre fin à la session en cas d'erreurs système (par exemple, des erreurs LLM). |
FallbackResponseConfig
| Représentation JSON |
|---|
{ "customFallbackMessages": { string: string, ... }, "maxFallbackAttempts": integer } |
| Champs | |
|---|---|
customFallbackMessages |
Facultatif. Messages de remplacement en cas d'erreurs système (par exemple, erreurs LLM), mappés par code de langue compatible. Objet contenant une liste de paires |
maxFallbackAttempts |
Facultatif. Nombre maximal de tentatives de remplacement à effectuer avant que l'agent n'émette le signal |
CustomFallbackMessagesEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
EndSessionConfig
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union
|
|
escalateSession |
Facultatif. Indique s'il faut escalader la session dans |
ModelSettings
| Représentation JSON |
|---|
{ "model": string, "thinkingLevel": enum ( |
| Champs | |
|---|---|
model |
Facultatif. Modèle LLM que l'agent doit utiliser. Si ce champ n'est pas défini, l'agent héritera du modèle de son agent parent. |
thinkingLevel |
Facultatif. Niveau de raisonnement du modèle. |
Champ d'union
|
|
temperature |
Facultatif. Si elle est définie, cette température sera utilisée pour le modèle LLM. La température contrôle le degré de hasard des réponses du modèle. Des températures plus basses produisent des réponses plus prévisibles. Les températures plus élevées produisent des réponses plus créatives. |
EvaluationMetricsThresholds
| Représentation JSON |
|---|
{ "goldenEvaluationMetricsThresholds": { object ( |
| Champs | |
|---|---|
goldenEvaluationMetricsThresholds |
Facultatif. Seuils des métriques d'évaluation de référence. |
hallucinationMetricBehavior |
Facultatif. Obsolète : utilisez |
goldenHallucinationMetricBehavior |
Facultatif. Comportement de la métrique d'hallucination pour les évaluations de référence. |
scenarioHallucinationMetricBehavior |
Facultatif. Comportement de la métrique d'hallucination pour les évaluations de scénarios. |
GoldenEvaluationMetricsThresholds
| Représentation JSON |
|---|
{ "turnLevelMetricsThresholds": { object ( |
| Champs | |
|---|---|
turnLevelMetricsThresholds |
Facultatif. Seuils des métriques au niveau du tour de parole. |
expectationLevelMetricsThresholds |
Facultatif. Seuils des métriques au niveau de l'attente. |
toolMatchingSettings |
Facultatif. Paramètres de correspondance de l'outil. Un appel d'outil supplémentaire est un appel d'outil présent dans l'exécution, mais qui ne correspond à aucun appel d'outil dans l'attente de référence. |
TurnLevelMetricsThresholds
| Représentation JSON |
|---|
{ "semanticSimilarityChannel": enum ( |
| Champs | |
|---|---|
semanticSimilarityChannel |
Facultatif. Canal de similarité sémantique à utiliser pour l'évaluation. |
Champ d'union
|
|
semanticSimilaritySuccessThreshold |
Facultatif. Seuil de réussite pour la similarité sémantique. Veuillez saisir un nombre entier compris entre 0 et 4. La valeur par défaut est >= 3. |
Champ d'union
|
|
overallToolInvocationCorrectnessThreshold |
Facultatif. Seuil de réussite pour l'exactitude globale de l'appel d'outil. La valeur doit être un nombre à virgule flottante compris entre 0 et 1. La valeur par défaut est 1.0. |
ExpectationLevelMetricsThresholds
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union
|
|
toolInvocationParameterCorrectnessThreshold |
Facultatif. Seuil de réussite pour l'exactitude des paramètres d'appel d'un outil individuel. La valeur doit être un nombre à virgule flottante compris entre 0 et 1. La valeur par défaut est 1.0. |
ToolMatchingSettings
| Représentation JSON |
|---|
{
"extraToolCallBehavior": enum ( |
| Champs | |
|---|---|
extraToolCallBehavior |
Facultatif. Comportement pour les appels d'outils supplémentaires. La valeur par défaut est "FAIL". |
VariableDeclaration
| Représentation JSON |
|---|
{
"name": string,
"description": string,
"schema": {
object ( |
| Champs | |
|---|---|
name |
Obligatoire. Nom de la variable. Le nom doit commencer par une lettre ou un trait de soulignement, et ne peut contenir que des lettres, des chiffres ou des traits de soulignement. |
description |
Obligatoire. Description de la variable. |
schema |
Obligatoire. Schéma de la variable. |
Schéma
| Représentation JSON |
|---|
{ "type": enum ( |
| Champs | |
|---|---|
type |
Obligatoire. Type des données. |
properties |
Facultatif. Propriétés de Type.OBJECT. Objet contenant une liste de paires |
required[] |
Facultatif. Propriétés obligatoires de Type.OBJECT. |
description |
Facultatif. Description des données. |
items |
Facultatif. Schéma des éléments de Type.ARRAY. |
nullable |
Facultatif. Indique si la valeur peut être nulle. |
uniqueItems |
Facultatif. Indiquez que les éléments du tableau doivent être uniques. S'applique uniquement à TYPE.ARRAY. |
prefixItems[] |
Facultatif. Schémas des éléments initiaux de Type.ARRAY. |
additionalProperties |
Facultatif. Peut être une valeur booléenne ou un objet. Contrôle la présence de propriétés supplémentaires. |
anyOf[] |
Facultatif. La valeur doit être validée par rapport à un ou plusieurs des sous-schémas de la liste. |
enum[] |
Facultatif. Valeurs possibles de l'élément de type primitif avec le format enum. Exemples : 1. Nous pouvons définir la direction comme suit : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. Nous pouvons définir le numéro d'appartement comme suit : {type:INTEGER, format:enum, enum:["101", "201", "301"]} |
default |
Facultatif. Valeur par défaut des données. |
ref |
Facultatif. Autorise les références indirectes entre les nœuds de schéma. La valeur doit être une référence valide à un enfant de la racine Par exemple, le schéma suivant définit une référence à un nœud de schéma nommé "Pet" : La valeur de la propriété "pet" est une référence au nœud de schéma nommé "Pet". Pour en savoir plus, consultez https://json-schema.org/understanding-json-schema/structuring. |
defs |
Facultatif. Mappage de définitions à utiliser par Objet contenant une liste de paires |
title |
Facultatif. Titre du schéma. |
minItems |
Facultatif. Nombre minimal d'éléments pour Type.ARRAY. |
maxItems |
Facultatif. Nombre maximal d'éléments pour Type.ARRAY. |
Champ d'union
|
|
minimum |
Facultatif. Valeur minimale pour Type.INTEGER et Type.NUMBER. |
Champ d'union
|
|
maximum |
Facultatif. Valeur maximale pour Type.INTEGER et Type.NUMBER. |
PropertiesEntry
| Représentation JSON |
|---|
{
"key": string,
"value": {
object ( |
| Champs | |
|---|---|
key |
|
value |
|
Valeur
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants : |
|
nullValue |
Représente un |
numberValue |
Représente un nombre JSON. Ne doit pas être |
stringValue |
Représente une chaîne JSON. |
boolValue |
Représente une valeur booléenne JSON (littéral |
structValue |
Représente un objet JSON. |
listValue |
Représente un tableau JSON. |
Struct
| Représentation JSON |
|---|
{ "fields": { string: value, ... } } |
| Champs | |
|---|---|
fields |
Mappage non ordonné de valeurs saisies de manière dynamique. Objet contenant une liste de paires |
FieldsEntry
| Représentation JSON |
|---|
{ "key": string, "value": value } |
| Champs | |
|---|---|
key |
|
value |
|
ListValue
| Représentation JSON |
|---|
{ "values": [ value ] } |
| Champs | |
|---|---|
values[] |
Champ répété de valeurs saisies de manière dynamique. |
DefsEntry
| Représentation JSON |
|---|
{
"key": string,
"value": {
object ( |
| Champs | |
|---|---|
key |
|
value |
|
DataStoreSettings
| Représentation JSON |
|---|
{
"engines": [
{
object ( |
| Champs | |
|---|---|
engines[] |
Uniquement en sortie. Moteurs de l'application. |
Moteur
| Représentation JSON |
|---|
{
"name": string,
"type": enum ( |
| Champs | |
|---|---|
name |
Uniquement en sortie. Nom de ressource du moteur. Format : |
type |
Uniquement en sortie. Type de moteur. |
ChannelProfile
| Représentation JSON |
|---|
{ "profileId": string, "channelType": enum ( |
| Champs | |
|---|---|
profileId |
Facultatif. Identifiant unique du profil de canal. |
channelType |
Facultatif. Type du profil de canal. |
personaProperty |
Facultatif. Propriété "persona" du profil de la chaîne. |
webWidgetConfig |
Facultatif. Configuration du widget Web. |
whatsappConfig |
Facultatif. Configuration spécifique aux déploiements WhatsApp. |
instagramConfig |
Facultatif. Configuration spécifique aux déploiements Instagram. |
Champ d'union
|
|
disableDtmf |
Facultatif. Indique si vous souhaitez désactiver le DTMF (Dual-Tone Multi-Frequency). |
Champ d'union
|
|
disableBargeInControl |
Facultatif. Indique si le contrôle de l'interruption par l'utilisateur doit être désactivé dans la conversation. - true : les interruptions par l'utilisateur sont désactivées pendant que l'agent parle. - false : l'agent conserve le contrôle automatique sur le moment où l'utilisateur peut l'interrompre. |
Champ d'union
|
|
noiseSuppressionLevel |
Facultatif. Niveau de suppression du bruit du profil de canal. Les valeurs disponibles sont "low", "moderate", "high" et "very_high". |
PersonaProperty
| Représentation JSON |
|---|
{
"persona": enum ( |
| Champs | |
|---|---|
persona |
Facultatif. Le persona de la chaîne. |
WebWidgetConfig
| Représentation JSON |
|---|
{ "modality": enum ( |
| Champs | |
|---|---|
modality |
Facultatif. Modalité du widget Web. |
theme |
Facultatif. Thème du widget Web. |
webWidgetTitle |
Facultatif. Titre du widget Web. |
securitySettings |
Facultatif. Paramètres de sécurité du widget Web. |
SecuritySettings
| Représentation JSON |
|---|
{ "enablePublicAccess": boolean, "enableOriginCheck": boolean, "allowedOrigins": [ string ], "enableRecaptcha": boolean } |
| Champs | |
|---|---|
enablePublicAccess |
Facultatif. Indique si l'accès public au widget Web est activé. Si la valeur est |
enableOriginCheck |
Facultatif. Indique si la vérification de l'origine du widget Web est activée. Si la valeur est |
allowedOrigins[] |
Facultatif. Origines autorisées à héberger le widget Web. Une origine est définie par la RFC 6454. Si ce champ est vide, toutes les origines sont autorisées. Vous ne pouvez pas indiquer plus de 100 origines. Exemple : "https://example.com" |
enableRecaptcha |
Facultatif. Indique si la validation reCAPTCHA pour le widget Web est activée. |
WhatsAppConfig
| Représentation JSON |
|---|
{ "wabaId": string, "phoneNumberId": string, "phoneNumber": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Champs | |
|---|---|
wabaId |
Obligatoire. ID de compte WhatsApp Business. |
phoneNumberId |
Obligatoire. ID du numéro de téléphone Meta. |
phoneNumber |
Facultatif. Numéro de téléphone au format E.164. |
displayName |
Uniquement en sortie. Nom de la page d'entreprise Meta récupéré. |
thumbnailUrl |
Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée. |
description |
Uniquement en sortie. Description de la page ou du profil Meta Business. |
InstagramConfig
| Représentation JSON |
|---|
{ "instagramAccountId": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Champs | |
|---|---|
instagramAccountId |
Obligatoire. ID du compte Instagram. |
displayName |
Uniquement en sortie. Nom de la page d'entreprise Meta récupéré. |
thumbnailUrl |
Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée. |
description |
Uniquement en sortie. Description de la page ou du profil Meta Business. |
MetadataEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
Horodatage
| Représentation JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Champs | |
|---|---|
seconds |
Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z à 9999-12-31T23:59:59Z). |
nanos |
Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 (inclus). |
ClientCertificateSettings
| Représentation JSON |
|---|
{ "tlsCertificate": string, "privateKey": string, "passphrase": string } |
| Champs | |
|---|---|
tlsCertificate |
Obligatoire. Certificat TLS encodé au format PEM. Cette chaîne doit inclure les lignes d'en-tête de début et de pied de page de fin. |
privateKey |
Obligatoire. Nom de la ressource de version du secret Secret Manager stockant la clé privée encodée au format PEM. Format : |
passphrase |
Facultatif. Nom de la ressource de version de secret Secret Manager stockant la phrase secrète pour déchiffrer la clé privée. Doit être laissé non défini si la clé privée n'est pas chiffrée. Format : |
VpcScSettings
| Représentation JSON |
|---|
{ "allowedOrigins": [ string ] } |
| Champs | |
|---|---|
allowedOrigins[] |
Facultatif. Origines HTTP(S) autorisées que les outils OpenAPI de l'application peuvent appeler directement lorsque VPC Service Controls est activé. Ces chaînes doivent correspondre exactement à l'origine, y compris au port s'il est spécifié. Par exemple, "https://example.com" ou "https://example.com:443". Cette liste ne s'applique pas encore aux outils Python susceptibles d'effectuer des appels HTTP directs. |
DashboardSettings
| Représentation JSON |
|---|
{ "defaultDashboard": string } |
| Champs | |
|---|---|
defaultDashboard |
Facultatif. Nom de ressource du tableau de bord Contact Center Insights par défaut associé à l'application. Il s'agit du tableau de bord qui s'affiche lorsque les utilisateurs accèdent à la vue "Surveillance" de l'application. Format : |
FieldMask
| Représentation JSON |
|---|
{ "paths": [ string ] } |
| Champs | |
|---|---|
paths[] |
Ensemble de chemins d'accès au masque de champ. |
PrebuiltAmbientNoise
Bruit ambiant prédéfini.
| Enums | |
|---|---|
PREBUILT_AMBIENT_NOISE_UNSPECIFIED |
Non spécifié. |
RETAIL_STORE |
Bruit ambiant d'un magasin. |
CONVENTION_HALL |
Bruit ambiant d'un hall de congrès. |
OUTDOOR |
Bruit ambiant d'une rue. |
WarningType
Type d'avertissement rencontré lors du traitement de l'échantillon vocal.
| Enums | |
|---|---|
WARNING_TYPE_UNSPECIFIED |
Type d'avertissement non spécifié. |
LOW_AUDIO_LEVEL |
Le niveau audio de l'échantillon vocal est trop faible (par exemple, amplitude RMS faible). |
VoiceInstructionMode
Mode d'instruction pour l'extrait de voix.
| Enums | |
|---|---|
VOICE_INSTRUCTION_MODE_UNSPECIFIED |
Mode d'instruction non spécifié. La valeur par défaut est NO_INSTRUCTION. |
NO_INSTRUCTION |
Aucune instruction vocale ne sera utilisée. |
GENERATE_INSTRUCTION |
L'instruction vocale sera générée automatiquement par l'IA à partir de l'échantillon audio. |
CUSTOM_INSTRUCTION |
Instruction vocale personnalisée fournie par l'utilisateur. |
ErrorHandlingStrategy
Définit la stratégie de gestion des erreurs.
| Enums | |
|---|---|
ERROR_HANDLING_STRATEGY_UNSPECIFIED |
Stratégie de gestion des exceptions non spécifiée. |
NONE |
Aucun traitement spécifique n'est activé. |
FALLBACK_RESPONSE |
Un message de remplacement sera renvoyé à l'utilisateur en cas d'erreurs système (par exemple, des erreurs LLM). |
END_SESSION |
Un signal EndSession sera émis en cas d'erreurs système (par exemple, des erreurs LLM). |
ThinkingLevel
Configuration du niveau de raisonnement pour le modèle.
| Enums | |
|---|---|
THINKING_LEVEL_UNSPECIFIED |
Le niveau de raisonnement n'est pas spécifié. |
DEFAULT |
Niveau de raisonnement par défaut. |
LOW |
Niveau de réflexion faible. |
MEDIUM |
Niveau de raisonnement intermédiaire. |
HIGH |
Niveau de raisonnement élevé. |
ToolExecutionMode
Définit le comportement d'exécution des outils si plusieurs outils sont sélectionnés par l'agent en même temps.
| Enums | |
|---|---|
TOOL_EXECUTION_MODE_UNSPECIFIED |
Mode d'exécution de l'outil non spécifié. La valeur par défaut est PARALLEL. |
PARALLEL |
Si plusieurs outils sont sélectionnés, ils seront exécutés en parallèle, avec le même ToolContext. |
SEQUENTIAL |
Si plusieurs outils sont sélectionnés, ils seront exécutés de manière séquentielle. L'outil suivant ne sera exécuté qu'une fois l'outil précédent terminé, et il pourra voir le ToolContext mis à jour de l'outil précédent. |
SemanticSimilarityChannel
Canal de similarité sémantique à utiliser.
| Enums | |
|---|---|
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED |
Métrique non spécifiée. La valeur par défaut est TEXT. |
TEXT |
Utilisez la similarité sémantique du texte. |
AUDIO |
Utilisez la similarité sémantique audio. |
ExtraToolCallBehavior
Définit le comportement lorsqu'un appel d'outil supplémentaire est rencontré. Un appel d'outil supplémentaire est un appel d'outil présent dans l'exécution, mais qui ne correspond à aucun appel d'outil dans l'attente de référence.
| Enums | |
|---|---|
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED |
Comportement non spécifié. La valeur par défaut est "FAIL". |
FAIL |
Échouer l'évaluation si un appel d'outil supplémentaire est rencontré. |
ALLOW |
Autorisez l'appel d'outil supplémentaire. |
HallucinationMetricBehavior
Comportement de la métrique d'hallucination. Quel que soit le comportement, la métrique sera toujours calculée. La différence est que, lorsqu'elle est désactivée, la métrique n'est pas utilisée pour calculer le score d'évaluation global.
| Enums | |
|---|---|
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED |
Comportement de la métrique d'hallucination non spécifié. |
DISABLED |
Désactivez la métrique d'hallucination. |
ENABLED |
Activer la métrique d'hallucination. |
Type
Types de données OpenAPI.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Type non spécifié |
STRING |
Type de chaîne. |
INTEGER |
Type entier. |
NUMBER |
Type de nombre. |
BOOLEAN |
Type booléen. |
OBJECT |
Type d'objet. |
ARRAY |
Type Array. |
NullValue
Représente un null JSON.
NullValue est une sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle pour l'union de types Value.
Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent un Value avec un null_value défini comme un null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.
| Enums | |
|---|---|
NULL_VALUE |
Valeur nulle. |
Type
Type de moteur. Consultez la documentation disponible sur https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType et https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Type de moteur non spécifié. |
ENGINE_TYPE_SEARCH |
Moteur SOLUTION_TYPE_SEARCH de l'application. Tous les datastores de connecteur ajoutés à l'application seront ajoutés à ce moteur. |
ENGINE_TYPE_CHAT |
Type de moteur de chat. Moteur SOLUTION_TYPE_CHAT de l'application. Tous les datastores de connecteur ajoutés à l'application seront ajoutés à ce moteur. |
ChannelType
Type du profil de canal.
| Enums | |
|---|---|
UNKNOWN |
Type de canal inconnu. |
WEB_UI |
Canal de l'UI Web. |
API |
Canal d'API. |
TWILIO |
Canal Twilio. |
GOOGLE_TELEPHONY_PLATFORM |
Canal Google Telephony Platform. |
CONTACT_CENTER_AS_A_SERVICE |
Canal Contact Center as a Service (CCaaS). |
CONTACT_CENTER_AS_A_SERVICE_CHAT |
Canal Contact Center as a Service (CCaaS Chat). |
FIVE9 |
Canal Five9. |
CONTACT_CENTER_INTEGRATION |
Canal d'intégration de centre de contact tiers. |
WHATSAPP |
Canal WhatsApp. |
INSTAGRAM |
Instagram. |
Persona
Le persona de la chaîne.
| Enums | |
|---|---|
UNKNOWN |
Persona INCONNU. |
CONCISE |
L'agent fournit des réponses concises et précises. |
CHATTY |
L'agent fournit du contexte, des explications et des détails supplémentaires |
Modalité
Modalité du widget Web.
| Enums | |
|---|---|
MODALITY_UNSPECIFIED |
Modalité inconnue. |
CHAT_AND_VOICE |
Le widget accepte les entrées de chat et vocales. |
VOICE_ONLY |
Le widget n'accepte que la saisie vocale. |
CHAT_ONLY |
Le widget n'accepte que les entrées de chat. |
CHAT_VOICE_AND_VIDEO |
Le widget accepte les entrées de chat, vocales et vidéo. |
Thème
Thème du widget Web.
| Enums | |
|---|---|
THEME_UNSPECIFIED |
Thème inconnu. |
LIGHT |
Thème clair. |
DARK |
le thème sombre. |
Schéma de sortie
Une application sert de conteneur de premier niveau pour un groupe d'agents, y compris l'agent racine et ses sous-agents, ainsi que leurs configurations associées. Ces agents travaillent ensemble pour atteindre des objectifs spécifiques dans le contexte de l'application.
Application
| Représentation JSON |
|---|
{ "name": string, "displayName": string, "description": string, "pinned": boolean, "rootAgent": string, "languageSettings": { object ( |
| Champs | |
|---|---|
name |
Identifiant. Identifiant unique de l'application. Format : |
displayName |
Obligatoire. Nom à afficher de l'application. |
description |
Facultatif. Description lisible par l'humain de l'application. |
pinned |
Facultatif. Indique si l'application est épinglée dans la liste des applications. |
rootAgent |
Facultatif. L'agent racine est le point d'entrée de l'application. Format : |
languageSettings |
Facultatif. Paramètres de langue de l'application. |
timeZoneSettings |
Facultatif. Paramètres de fuseau horaire de l'application. |
audioProcessingConfig |
Facultatif. Configuration du traitement audio de l'application. |
loggingSettings |
Facultatif. Paramètres de journalisation de l'application. |
errorHandlingSettings |
Facultatif. Paramètres de gestion des exceptions de l'application. |
modelSettings |
Facultatif. Paramètres du modèle LLM par défaut pour l'application. Les ressources individuelles (par exemple, les agents, les garde-fous) peuvent remplacer ces configurations si nécessaire. |
toolExecutionMode |
Facultatif. Mode d'exécution de l'outil pour l'application. S'il n'est pas fourni, la valeur par défaut est PARALLEL. |
evaluationMetricsThresholds |
Facultatif. Seuils d'évaluation de l'application. |
variableDeclarations[] |
Facultatif. Déclarations des variables. |
predefinedVariableDeclarations[] |
Uniquement en sortie. Déclarations des variables prédéfinies pour l'application. |
globalInstruction |
Facultatif. Instructions pour tous les agents de l'application. Vous pouvez utiliser cette instruction pour configurer une identité ou une personnalité stable pour tous les agents. |
guardrails[] |
Facultatif. Liste des garde-fous de l'application. Format : |
dataStoreSettings |
Facultatif. Paramètres du data store pour l'application. |
defaultChannelProfile |
Facultatif. Profil de canal par défaut utilisé par l'application. |
metadata |
Facultatif. Métadonnées sur l'application. Ce champ peut être utilisé pour stocker des informations supplémentaires pertinentes sur les détails de l'application ou les utilisations prévues. Objet contenant une liste de paires |
createTime |
Uniquement en sortie. Code temporel de la création de l'application. 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 : |
updateTime |
Uniquement en sortie. Code temporel de la dernière mise à jour de l'application. 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 : |
etag |
Uniquement en sortie. Etag utilisé pour s'assurer que l'objet n'a pas changé lors d'une opération de lecture-modification-écriture. Si l'etag est vide, la mise à jour écrasera toutes les modifications simultanées. |
deploymentCount |
Uniquement en sortie. Nombre de déploiements dans l'application. |
clientCertificateSettings |
Facultatif. Paramètres de certificat client par défaut pour l'application. |
vpcScSettings |
Facultatif. Paramètres VPC-SC de l'application. |
locked |
Facultatif. Indique si l'application est verrouillée pour les modifications. Si l'application est verrouillée, les modifications apportées aux ressources de l'application seront refusées. |
validationErrors[] |
Uniquement en sortie. Erreurs de configuration ou avertissements dans l'application. |
dashboardSettings |
Facultatif. Paramètres de tableau de bord spécifiques à l'application pour associer et configurer les tableaux de bord Contact Center Insights. |
LanguageSettings
| Représentation JSON |
|---|
{ "defaultLanguageCode": string, "supportedLanguageCodes": [ string ], "enableMultilingualSupport": boolean, "fallbackAction": string } |
| Champs | |
|---|---|
defaultLanguageCode |
Facultatif. Code de langue par défaut de l'application. |
supportedLanguageCodes[] |
Facultatif. Liste des codes de langue acceptés par l'application, en plus de |
enableMultilingualSupport |
Facultatif. Active la compatibilité multilingue. Si cette option est définie sur |
fallbackAction |
Facultatif. Obsolète : cette fonctionnalité n'est plus disponible. Utilisez plutôt Il peut s'agir d'une action prédéfinie ou d'un appel d'outil personnalisé. Les valeurs valides sont les suivantes : - Nom complet de la ressource d'un outil, qui déclenche l'exécution d'un outil spécifique. - Une action système prédéfinie, telle que "escalate" ou "exit", qui déclenche un signal |
TimeZoneSettings
| Représentation JSON |
|---|
{ "timeZone": string } |
| Champs | |
|---|---|
timeZone |
Facultatif. Fuseau horaire de l'application issu de la base de données des fuseaux horaires (par exemple, America/Los_Angeles, Europe/Paris). |
AudioProcessingConfig
| Représentation JSON |
|---|
{ "synthesizeSpeechConfigs": { string: { object ( |
| Champs | |
|---|---|
synthesizeSpeechConfigs |
Facultatif. Configuration de la synthèse de la réponse de l'agent, mappage du code de langue vers Si la configuration du code de langue spécifié est introuvable, la configuration du code de langue racine sera utilisée. Par exemple, si la carte contient "en-us" et "en", et que le code de langue spécifié est "en-gb", la configuration "en" sera utilisée. Remarque : Le code de langue n'est pas sensible à la casse. Objet contenant une liste de paires |
bargeInConfig |
Facultatif. Configure le comportement de l'agent pour les activités d'interruption de l'utilisateur. |
inactivityTimeout |
Facultatif. Durée d'inactivité de l'utilisateur (pas de parole ni d'interaction) avant que l'agent ne l'invite à se réengager. Si ce paramètre n'est pas défini, l'agent n'invitera pas l'utilisateur à se réengager. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
ambientSoundConfig |
Facultatif. Configuration du son ambiant à diffuser avec la réponse synthétisée de l'agent, afin d'améliorer le naturel de la conversation. |
customVoiceSamples[] |
Facultatif. Configure des échantillons de voix personnalisés pour le clonage de voix. |
SynthesizeSpeechConfigsEntry
| Représentation JSON |
|---|
{
"key": string,
"value": {
object ( |
| Champs | |
|---|---|
key |
|
value |
|
SynthesizeSpeechConfig
| Représentation JSON |
|---|
{ "voice": string, "speakingRate": number, "model": string, "instruction": string } |
| Champs | |
|---|---|
voice |
Facultatif. Nom de la voix. Si ce champ n'est pas défini, le service choisit une voix en fonction des autres paramètres, tels que language_code. Pour obtenir la liste des voix disponibles, consultez Voix et langues disponibles dans Cloud Text-to-Speech. |
speakingRate |
Facultatif. La vitesse d'élocution dans la plage [0,25, 2,0]. La valeur 1,0 correspond à la vitesse native normale compatible avec la voix spécifique. La valeur 2,0 est deux fois plus rapide et la valeur 0,5 est deux fois moins rapide. Les valeurs en dehors de la plage [0,25, 2,0] renverront une erreur. |
model |
Facultatif. Modèle utilisé pour synthétiser l'audio. Valeurs actuellement acceptées : - "gemini-3.1-flash-tts-preview" Si ce champ est vide, Chirp3-HD est utilisé. |
instruction |
Facultatif. Instruction utilisée pour synthétiser la voix lors de l'utilisation d'un modèle génératif. |
BargeInConfig
| Représentation JSON |
|---|
{ "disableBargeIn": boolean, "bargeInAwareness": boolean } |
| Champs | |
|---|---|
disableBargeIn |
Facultatif. Obsolète : Désactive l'interruption par l'utilisateur pendant que l'agent parle. Si la valeur est définie sur "true", l'entrée utilisateur pendant la lecture de la réponse de l'agent sera ignorée. |
bargeInAwareness |
Facultatif. Si cette option est activée, l'agent adaptera sa prochaine réponse en partant du principe que l'utilisateur n'a pas entendu l'intégralité du message précédent de l'agent. Cette option ne doit pas être utilisée dans les scénarios où les réponses de l'agent sont affichées visuellement. |
Durée
| Représentation JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Champs | |
|---|---|
seconds |
Secondes signées de l'intervalle de temps. Doit être compris entre -315 576 000 000 et +315 576 000 000 inclus. Remarque : Ces limites sont calculées à partir de : 60 s/min * 60 min/h * 24 h/jour * 365,25 jours/an * 10 000 ans. |
nanos |
Fractions de seconde signées à une résolution de l'ordre de la nanoseconde de l'intervalle de temps. Les durées inférieures à une seconde sont représentées par un champ |
AmbientSoundConfig
| Représentation JSON |
|---|
{ "volumeGainDb": number, // Union field |
| Champs | |
|---|---|
volumeGainDb |
Facultatif. Gain de volume (en dB) du volume natif normal compatible avec le bruit ambiant, dans la plage [-96,0, 16,0]. Si la valeur n'est pas définie ou si elle est définie sur une valeur de zéro (dB), elle est lue à une amplitude de signal natif normal. Une valeur de -6 (dB) est lue avec environ la moitié de l'amplitude du signal natif normal. Une valeur de +6 (dB) est lue avec environ deux fois plus d'amplitude que le signal natif normal. Nous vous recommandons vivement de ne pas dépasser +10 (dB), car il n'y a généralement pas d'augmentation efficace du volume pour une valeur supérieure à cette valeur. |
Champ d'union source. Bruit ambiant à diffuser avec la réponse de l'agent synthétisée, pour améliorer le naturel de la conversation. source ne peut être qu'un des éléments suivants : |
|
prebuiltAmbientNoise |
Facultatif. Obsolète : |
gcsUri |
Facultatif. Bruit ambiant sous forme de fichier WAV monocanal de 16 kHz stocké dans Cloud Storage. Remarque : Veuillez vous assurer que l'agent de service CES |
prebuiltAmbientSound |
Facultatif. Nom du son d'ambiance prédéfini. Les valeurs valides sont les suivantes : - "coffee_shop" - "keyboard" - "keypad" - "hum" - "office_1" - "office_2" - "office_3" - "room_1" - "room_2" - "room_3" - "room_4" - "room_5" - "air_conditioner" |
CustomVoiceSample
| Représentation JSON |
|---|
{ "name": string, "voiceSampleGcsUri": string, "consentAudioGcsUri": string, "voiceInstruction": string, "previewAudioContent": string, "previewText": string, "warnings": [ { object ( |
| Champs | |
|---|---|
name |
Facultatif. Nom défini par l'utilisateur pour l'échantillon de voix personnalisée. |
voiceSampleGcsUri |
Facultatif. URI Cloud Storage de l'échantillon audio pour le clonage de voix. L'échantillon audio doit être un fichier WAV monocanal de 24 kHz. |
consentAudioGcsUri |
Facultatif. Audio de consentement pour le clonage vocal. |
voiceInstruction |
Facultatif. Instructions en langage naturel pour le style, le ton, le rythme ou la prononciation de la voix. |
previewAudioContent |
Uniquement en sortie. Aperçu audio synthétisé pour la voix personnalisée, au format WAV canonique (LINEAR16, 24 kHz, 16 bits, mono). Chaîne encodée en base64. |
previewText |
Facultatif. Texte pour synthétiser l'aperçu audio d'une voix personnalisée. |
warnings[] |
Uniquement en sortie. Messages d'avertissement rencontrés lors du traitement du clonage vocal (par exemple, niveau audio faible). |
voiceInstructionMode |
Facultatif. Mode d'instruction pour l'extrait de voix. Si aucune valeur n'est spécifiée, la valeur par défaut est NO_INSTRUCTION. |
Avertissement
| Représentation JSON |
|---|
{
"message": string,
"type": enum ( |
| Champs | |
|---|---|
message |
Uniquement en sortie. Description lisible par l'humain de l'avertissement. |
type |
Uniquement en sortie. Type d'avertissement. |
LoggingSettings
| Représentation JSON |
|---|
{ "redactionConfig": { object ( |
| Champs | |
|---|---|
redactionConfig |
Facultatif. Configuration du masquage des données sensibles. |
audioRecordingConfig |
Facultatif. Configuration de l'enregistrement des interactions audio. L'audio est soumis à une occultation, comme configuré dans |
unredactedAudioRecordingConfig |
Facultatif. Configure un enregistrement supplémentaire de l'audio non masqué. Cela peut être utile pour conserver une copie audio brute lorsque la suppression audio est |
bigqueryExportSettings |
Facultatif. Configure les comportements d'exportation BigQuery pour l'application. Les données de conversation sont soumises à une occultation, comme configuré dans |
unredactedBigqueryExportSettings |
Facultatif. Configure les comportements d'exportation BigQuery pour l'application. Les données de conversation non masquées seront exportées vers des tables BigQuery si cette option est activée. |
cloudLoggingSettings |
Facultatif. Paramètres décrivant les comportements de Cloud Logging pour l'application. |
conversationLoggingSettings |
Facultatif. Paramètres décrivant les comportements de journalisation des conversations pour l'application. |
evaluationAudioRecordingConfig |
Facultatif. Configuration de l'enregistrement des interactions audio pour l'évaluation. Par défaut, l'enregistrement audio n'est pas activé pour les sessions d'évaluation. |
metricAnalysisSettings |
Facultatif. Paramètres décrivant les comportements de collecte des données de conversation pour le pipeline d'analyse LLM de l'application. |
requiredRecordingConsent |
Facultatif. Si l'application doit indiquer ce qui peut être enregistré avant que quoi que ce soit ne soit conservé. Si la valeur est "true", une session démarre avec l'enregistrement désactivé et reste désactivée jusqu'à ce que le client envoie Lorsque la valeur est |
RedactionConfig
| Représentation JSON |
|---|
{ "enableRedaction": boolean, "inspectTemplate": string, "deidentifyTemplate": string } |
| Champs | |
|---|---|
enableRedaction |
Facultatif. Si la valeur est |
inspectTemplate |
Facultatif. Nom du modèle d'inspection DLP pour configurer la détection des types de données sensibles. Format : |
deidentifyTemplate |
Facultatif. Nom du modèle d'anonymisation DLP pour indiquer comment anonymiser le contenu. Format : |
AudioRecordingConfig
| Représentation JSON |
|---|
{ "gcsBucket": string, "gcsPathPrefix": string } |
| Champs | |
|---|---|
gcsBucket |
Facultatif. Le bucket Cloud Storage pour stocker les enregistrements audio de la session. L'URI doit commencer par "gs://". Veuillez choisir un emplacement de bucket qui répond à vos exigences de résidence des données. Remarque : Si le bucket Cloud Storage se trouve dans un projet différent de celui de l'application, vous devez accorder l'autorisation |
gcsPathPrefix |
Facultatif. Préfixe du chemin d'accès Cloud Storage pour les enregistrements audio. Ce préfixe peut inclure les espaces réservés suivants, qui seront remplacés de manière dynamique au moment de la diffusion : - $project : ID du projet - $location : emplacement de l'application - $app : ID de l'application - $date : date de la session au format AAAA-MM-JJ - $session : ID de la session Si le préfixe de chemin d'accès n'est pas spécifié, le préfixe par défaut |
BigQueryExportSettings
| Représentation JSON |
|---|
{ "enabled": boolean, "project": string, "dataset": string } |
| Champs | |
|---|---|
enabled |
Facultatif. Indique si l'exportation BigQuery est activée. |
project |
Facultatif. L'ID du projet de l'ensemble de données BigQuery vers lequel exporter les données. Remarque : Si l'ensemble de données BigQuery se trouve dans un projet différent de celui de l'application, vous devez attribuer le rôle |
dataset |
Facultatif. ID de l'ensemble de données BigQuery vers lequel exporter les données. |
CloudLoggingSettings
| Représentation JSON |
|---|
{ "enableCloudLogging": boolean } |
| Champs | |
|---|---|
enableCloudLogging |
Facultatif. Indique si Cloud Logging doit être activé pour les sessions. |
ConversationLoggingSettings
| Représentation JSON |
|---|
{ "disableConversationLogging": boolean, "retentionWindow": string } |
| Champs | |
|---|---|
disableConversationLogging |
Facultatif. Indique si la journalisation des conversations doit être désactivée pour les sessions. |
retentionWindow |
Facultatif. Contrôle la période de conservation de la conversation. Si ce champ n'est pas défini, la conversation sera conservée pendant 365 jours. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
MetricAnalysisSettings
| Représentation JSON |
|---|
{ "llmMetricsOptedOut": boolean } |
| Champs | |
|---|---|
llmMetricsOptedOut |
Facultatif. Indique si les données de conversation doivent être collectées pour les métriques d'analyse LLM. Si la valeur est "true", les données de conversation ne seront pas collectées pour les métriques d'analyse LLM. Sinon, les données de conversation seront collectées. |
ErrorHandlingSettings
| Représentation JSON |
|---|
{ "errorHandlingStrategy": enum ( |
| Champs | |
|---|---|
errorHandlingStrategy |
Facultatif. Stratégie à utiliser pour la gestion des exceptions. |
fallbackResponseConfig |
Facultatif. Configuration pour la gestion des réponses de remplacement. |
endSessionConfig |
Facultatif. Configuration pour mettre fin à la session en cas d'erreurs système (par exemple, des erreurs LLM). |
FallbackResponseConfig
| Représentation JSON |
|---|
{ "customFallbackMessages": { string: string, ... }, "maxFallbackAttempts": integer } |
| Champs | |
|---|---|
customFallbackMessages |
Facultatif. Messages de remplacement en cas d'erreurs système (par exemple, erreurs LLM), mappés par code de langue compatible. Objet contenant une liste de paires |
maxFallbackAttempts |
Facultatif. Nombre maximal de tentatives de remplacement à effectuer avant que l'agent n'émette le signal |
CustomFallbackMessagesEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
EndSessionConfig
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union
|
|
escalateSession |
Facultatif. Indique s'il faut escalader la session dans |
ModelSettings
| Représentation JSON |
|---|
{ "model": string, "thinkingLevel": enum ( |
| Champs | |
|---|---|
model |
Facultatif. Modèle LLM que l'agent doit utiliser. Si ce champ n'est pas défini, l'agent héritera du modèle de son agent parent. |
thinkingLevel |
Facultatif. Niveau de raisonnement du modèle. |
Champ d'union
|
|
temperature |
Facultatif. Si elle est définie, cette température sera utilisée pour le modèle LLM. La température contrôle le degré de hasard des réponses du modèle. Des températures plus basses produisent des réponses plus prévisibles. Les températures plus élevées produisent des réponses plus créatives. |
EvaluationMetricsThresholds
| Représentation JSON |
|---|
{ "goldenEvaluationMetricsThresholds": { object ( |
| Champs | |
|---|---|
goldenEvaluationMetricsThresholds |
Facultatif. Seuils des métriques d'évaluation de référence. |
hallucinationMetricBehavior |
Facultatif. Obsolète : utilisez |
goldenHallucinationMetricBehavior |
Facultatif. Comportement de la métrique d'hallucination pour les évaluations de référence. |
scenarioHallucinationMetricBehavior |
Facultatif. Comportement de la métrique d'hallucination pour les évaluations de scénarios. |
GoldenEvaluationMetricsThresholds
| Représentation JSON |
|---|
{ "turnLevelMetricsThresholds": { object ( |
| Champs | |
|---|---|
turnLevelMetricsThresholds |
Facultatif. Seuils des métriques au niveau du tour de parole. |
expectationLevelMetricsThresholds |
Facultatif. Seuils des métriques au niveau de l'attente. |
toolMatchingSettings |
Facultatif. Paramètres de correspondance de l'outil. Un appel d'outil supplémentaire est un appel d'outil présent dans l'exécution, mais qui ne correspond à aucun appel d'outil dans l'attente de référence. |
TurnLevelMetricsThresholds
| Représentation JSON |
|---|
{ "semanticSimilarityChannel": enum ( |
| Champs | |
|---|---|
semanticSimilarityChannel |
Facultatif. Canal de similarité sémantique à utiliser pour l'évaluation. |
Champ d'union
|
|
semanticSimilaritySuccessThreshold |
Facultatif. Seuil de réussite pour la similarité sémantique. Veuillez saisir un nombre entier compris entre 0 et 4. La valeur par défaut est >= 3. |
Champ d'union
|
|
overallToolInvocationCorrectnessThreshold |
Facultatif. Seuil de réussite pour l'exactitude globale de l'appel d'outil. La valeur doit être un nombre à virgule flottante compris entre 0 et 1. La valeur par défaut est 1.0. |
ExpectationLevelMetricsThresholds
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union
|
|
toolInvocationParameterCorrectnessThreshold |
Facultatif. Seuil de réussite pour l'exactitude des paramètres d'appel d'un outil individuel. La valeur doit être un nombre à virgule flottante compris entre 0 et 1. La valeur par défaut est 1.0. |
ToolMatchingSettings
| Représentation JSON |
|---|
{
"extraToolCallBehavior": enum ( |
| Champs | |
|---|---|
extraToolCallBehavior |
Facultatif. Comportement pour les appels d'outils supplémentaires. La valeur par défaut est "FAIL". |
VariableDeclaration
| Représentation JSON |
|---|
{
"name": string,
"description": string,
"schema": {
object ( |
| Champs | |
|---|---|
name |
Obligatoire. Nom de la variable. Le nom doit commencer par une lettre ou un trait de soulignement, et ne peut contenir que des lettres, des chiffres ou des traits de soulignement. |
description |
Obligatoire. Description de la variable. |
schema |
Obligatoire. Schéma de la variable. |
Schéma
| Représentation JSON |
|---|
{ "type": enum ( |
| Champs | |
|---|---|
type |
Obligatoire. Type des données. |
properties |
Facultatif. Propriétés de Type.OBJECT. Objet contenant une liste de paires |
required[] |
Facultatif. Propriétés obligatoires de Type.OBJECT. |
description |
Facultatif. Description des données. |
items |
Facultatif. Schéma des éléments de Type.ARRAY. |
nullable |
Facultatif. Indique si la valeur peut être nulle. |
uniqueItems |
Facultatif. Indiquez que les éléments du tableau doivent être uniques. S'applique uniquement à TYPE.ARRAY. |
prefixItems[] |
Facultatif. Schémas des éléments initiaux de Type.ARRAY. |
additionalProperties |
Facultatif. Peut être une valeur booléenne ou un objet. Contrôle la présence de propriétés supplémentaires. |
anyOf[] |
Facultatif. La valeur doit être validée par rapport à un ou plusieurs des sous-schémas de la liste. |
enum[] |
Facultatif. Valeurs possibles de l'élément de type primitif avec le format enum. Exemples : 1. Nous pouvons définir la direction comme suit : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. Nous pouvons définir le numéro d'appartement comme suit : {type:INTEGER, format:enum, enum:["101", "201", "301"]} |
default |
Facultatif. Valeur par défaut des données. |
ref |
Facultatif. Autorise les références indirectes entre les nœuds de schéma. La valeur doit être une référence valide à un enfant de la racine Par exemple, le schéma suivant définit une référence à un nœud de schéma nommé "Pet" : La valeur de la propriété "pet" est une référence au nœud de schéma nommé "Pet". Pour en savoir plus, consultez https://json-schema.org/understanding-json-schema/structuring. |
defs |
Facultatif. Mappage de définitions à utiliser par Objet contenant une liste de paires |
title |
Facultatif. Titre du schéma. |
minItems |
Facultatif. Nombre minimal d'éléments pour Type.ARRAY. |
maxItems |
Facultatif. Nombre maximal d'éléments pour Type.ARRAY. |
Champ d'union
|
|
minimum |
Facultatif. Valeur minimale pour Type.INTEGER et Type.NUMBER. |
Champ d'union
|
|
maximum |
Facultatif. Valeur maximale pour Type.INTEGER et Type.NUMBER. |
PropertiesEntry
| Représentation JSON |
|---|
{
"key": string,
"value": {
object ( |
| Champs | |
|---|---|
key |
|
value |
|
Valeur
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants : |
|
nullValue |
Représente un |
numberValue |
Représente un nombre JSON. Ne doit pas être |
stringValue |
Représente une chaîne JSON. |
boolValue |
Représente une valeur booléenne JSON (littéral |
structValue |
Représente un objet JSON. |
listValue |
Représente un tableau JSON. |
Struct
| Représentation JSON |
|---|
{ "fields": { string: value, ... } } |
| Champs | |
|---|---|
fields |
Mappage non ordonné de valeurs saisies de manière dynamique. Objet contenant une liste de paires |
FieldsEntry
| Représentation JSON |
|---|
{ "key": string, "value": value } |
| Champs | |
|---|---|
key |
|
value |
|
ListValue
| Représentation JSON |
|---|
{ "values": [ value ] } |
| Champs | |
|---|---|
values[] |
Champ répété de valeurs saisies de manière dynamique. |
DefsEntry
| Représentation JSON |
|---|
{
"key": string,
"value": {
object ( |
| Champs | |
|---|---|
key |
|
value |
|
DataStoreSettings
| Représentation JSON |
|---|
{
"engines": [
{
object ( |
| Champs | |
|---|---|
engines[] |
Uniquement en sortie. Moteurs de l'application. |
Moteur
| Représentation JSON |
|---|
{
"name": string,
"type": enum ( |
| Champs | |
|---|---|
name |
Uniquement en sortie. Nom de ressource du moteur. Format : |
type |
Uniquement en sortie. Type de moteur. |
ChannelProfile
| Représentation JSON |
|---|
{ "profileId": string, "channelType": enum ( |
| Champs | |
|---|---|
profileId |
Facultatif. Identifiant unique du profil de canal. |
channelType |
Facultatif. Type du profil de canal. |
personaProperty |
Facultatif. Propriété "persona" du profil de la chaîne. |
webWidgetConfig |
Facultatif. Configuration du widget Web. |
whatsappConfig |
Facultatif. Configuration spécifique aux déploiements WhatsApp. |
instagramConfig |
Facultatif. Configuration spécifique aux déploiements Instagram. |
Champ d'union
|
|
disableDtmf |
Facultatif. Indique si vous souhaitez désactiver le DTMF (Dual-Tone Multi-Frequency). |
Champ d'union
|
|
disableBargeInControl |
Facultatif. Indique si le contrôle de l'interruption par l'utilisateur doit être désactivé dans la conversation. - true : les interruptions par l'utilisateur sont désactivées pendant que l'agent parle. - false : l'agent conserve le contrôle automatique sur le moment où l'utilisateur peut l'interrompre. |
Champ d'union
|
|
noiseSuppressionLevel |
Facultatif. Niveau de suppression du bruit du profil de canal. Les valeurs disponibles sont "low", "moderate", "high" et "very_high". |
PersonaProperty
| Représentation JSON |
|---|
{
"persona": enum ( |
| Champs | |
|---|---|
persona |
Facultatif. Le persona de la chaîne. |
WebWidgetConfig
| Représentation JSON |
|---|
{ "modality": enum ( |
| Champs | |
|---|---|
modality |
Facultatif. Modalité du widget Web. |
theme |
Facultatif. Thème du widget Web. |
webWidgetTitle |
Facultatif. Titre du widget Web. |
securitySettings |
Facultatif. Paramètres de sécurité du widget Web. |
SecuritySettings
| Représentation JSON |
|---|
{ "enablePublicAccess": boolean, "enableOriginCheck": boolean, "allowedOrigins": [ string ], "enableRecaptcha": boolean } |
| Champs | |
|---|---|
enablePublicAccess |
Facultatif. Indique si l'accès public au widget Web est activé. Si la valeur est |
enableOriginCheck |
Facultatif. Indique si la vérification de l'origine du widget Web est activée. Si la valeur est |
allowedOrigins[] |
Facultatif. Origines autorisées à héberger le widget Web. Une origine est définie par la RFC 6454. Si ce champ est vide, toutes les origines sont autorisées. Vous ne pouvez pas indiquer plus de 100 origines. Exemple : "https://example.com" |
enableRecaptcha |
Facultatif. Indique si la validation reCAPTCHA pour le widget Web est activée. |
WhatsAppConfig
| Représentation JSON |
|---|
{ "wabaId": string, "phoneNumberId": string, "phoneNumber": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Champs | |
|---|---|
wabaId |
Obligatoire. ID de compte WhatsApp Business. |
phoneNumberId |
Obligatoire. ID du numéro de téléphone Meta. |
phoneNumber |
Facultatif. Numéro de téléphone au format E.164. |
displayName |
Uniquement en sortie. Nom de la page d'entreprise Meta récupéré. |
thumbnailUrl |
Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée. |
description |
Uniquement en sortie. Description de la page ou du profil Meta Business. |
InstagramConfig
| Représentation JSON |
|---|
{ "instagramAccountId": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| Champs | |
|---|---|
instagramAccountId |
Obligatoire. ID du compte Instagram. |
displayName |
Uniquement en sortie. Nom de la page d'entreprise Meta récupéré. |
thumbnailUrl |
Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée. |
description |
Uniquement en sortie. Description de la page ou du profil Meta Business. |
MetadataEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
Horodatage
| Représentation JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Champs | |
|---|---|
seconds |
Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z à 9999-12-31T23:59:59Z). |
nanos |
Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 (inclus). |
ClientCertificateSettings
| Représentation JSON |
|---|
{ "tlsCertificate": string, "privateKey": string, "passphrase": string } |
| Champs | |
|---|---|
tlsCertificate |
Obligatoire. Certificat TLS encodé au format PEM. Cette chaîne doit inclure les lignes d'en-tête de début et de pied de page de fin. |
privateKey |
Obligatoire. Nom de la ressource de version du secret Secret Manager stockant la clé privée encodée au format PEM. Format : |
passphrase |
Facultatif. Nom de la ressource de version de secret Secret Manager stockant la phrase secrète pour déchiffrer la clé privée. Doit être laissé non défini si la clé privée n'est pas chiffrée. Format : |
VpcScSettings
| Représentation JSON |
|---|
{ "allowedOrigins": [ string ] } |
| Champs | |
|---|---|
allowedOrigins[] |
Facultatif. Origines HTTP(S) autorisées que les outils OpenAPI de l'application peuvent appeler directement lorsque VPC Service Controls est activé. Ces chaînes doivent correspondre exactement à l'origine, y compris au port s'il est spécifié. Par exemple, "https://example.com" ou "https://example.com:443". Cette liste ne s'applique pas encore aux outils Python susceptibles d'effectuer des appels HTTP directs. |
DashboardSettings
| Représentation JSON |
|---|
{ "defaultDashboard": string } |
| Champs | |
|---|---|
defaultDashboard |
Facultatif. Nom de ressource du tableau de bord Contact Center Insights par défaut associé à l'application. Il s'agit du tableau de bord qui s'affiche lorsque les utilisateurs accèdent à la vue "Surveillance" de l'application. Format : |
PrebuiltAmbientNoise
Bruit ambiant prédéfini.
| Enums | |
|---|---|
PREBUILT_AMBIENT_NOISE_UNSPECIFIED |
Non spécifié. |
RETAIL_STORE |
Bruit ambiant d'un magasin. |
CONVENTION_HALL |
Bruit ambiant d'un hall de congrès. |
OUTDOOR |
Bruit ambiant d'une rue. |
WarningType
Type d'avertissement rencontré lors du traitement de l'échantillon vocal.
| Enums | |
|---|---|
WARNING_TYPE_UNSPECIFIED |
Type d'avertissement non spécifié. |
LOW_AUDIO_LEVEL |
Le niveau audio de l'échantillon vocal est trop faible (par exemple, amplitude RMS faible). |
VoiceInstructionMode
Mode d'instruction pour l'extrait de voix.
| Enums | |
|---|---|
VOICE_INSTRUCTION_MODE_UNSPECIFIED |
Mode d'instruction non spécifié. La valeur par défaut est NO_INSTRUCTION. |
NO_INSTRUCTION |
Aucune instruction vocale ne sera utilisée. |
GENERATE_INSTRUCTION |
L'instruction vocale sera générée automatiquement par l'IA à partir de l'échantillon audio. |
CUSTOM_INSTRUCTION |
Instruction vocale personnalisée fournie par l'utilisateur. |
ErrorHandlingStrategy
Définit la stratégie de gestion des erreurs.
| Enums | |
|---|---|
ERROR_HANDLING_STRATEGY_UNSPECIFIED |
Stratégie de gestion des exceptions non spécifiée. |
NONE |
Aucun traitement spécifique n'est activé. |
FALLBACK_RESPONSE |
Un message de remplacement sera renvoyé à l'utilisateur en cas d'erreurs système (par exemple, des erreurs LLM). |
END_SESSION |
Un signal EndSession sera émis en cas d'erreurs système (par exemple, des erreurs LLM). |
ThinkingLevel
Configuration du niveau de raisonnement pour le modèle.
| Enums | |
|---|---|
THINKING_LEVEL_UNSPECIFIED |
Le niveau de raisonnement n'est pas spécifié. |
DEFAULT |
Niveau de raisonnement par défaut. |
LOW |
Niveau de réflexion faible. |
MEDIUM |
Niveau de raisonnement intermédiaire. |
HIGH |
Niveau de raisonnement élevé. |
ToolExecutionMode
Définit le comportement d'exécution des outils si plusieurs outils sont sélectionnés par l'agent en même temps.
| Enums | |
|---|---|
TOOL_EXECUTION_MODE_UNSPECIFIED |
Mode d'exécution de l'outil non spécifié. La valeur par défaut est PARALLEL. |
PARALLEL |
Si plusieurs outils sont sélectionnés, ils seront exécutés en parallèle, avec le même ToolContext. |
SEQUENTIAL |
Si plusieurs outils sont sélectionnés, ils seront exécutés de manière séquentielle. L'outil suivant ne sera exécuté qu'une fois l'outil précédent terminé, et il pourra voir le ToolContext mis à jour de l'outil précédent. |
SemanticSimilarityChannel
Canal de similarité sémantique à utiliser.
| Enums | |
|---|---|
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED |
Métrique non spécifiée. La valeur par défaut est TEXT. |
TEXT |
Utilisez la similarité sémantique du texte. |
AUDIO |
Utilisez la similarité sémantique audio. |
ExtraToolCallBehavior
Définit le comportement lorsqu'un appel d'outil supplémentaire est rencontré. Un appel d'outil supplémentaire est un appel d'outil présent dans l'exécution, mais qui ne correspond à aucun appel d'outil dans l'attente de référence.
| Enums | |
|---|---|
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED |
Comportement non spécifié. La valeur par défaut est "FAIL". |
FAIL |
Échouer l'évaluation si un appel d'outil supplémentaire est rencontré. |
ALLOW |
Autorisez l'appel d'outil supplémentaire. |
HallucinationMetricBehavior
Comportement de la métrique d'hallucination. Quel que soit le comportement, la métrique sera toujours calculée. La différence est que, lorsqu'elle est désactivée, la métrique n'est pas utilisée pour calculer le score d'évaluation global.
| Enums | |
|---|---|
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED |
Comportement de la métrique d'hallucination non spécifié. |
DISABLED |
Désactivez la métrique d'hallucination. |
ENABLED |
Activer la métrique d'hallucination. |
Type
Types de données OpenAPI.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Type non spécifié |
STRING |
Type de chaîne. |
INTEGER |
Type entier. |
NUMBER |
Type de nombre. |
BOOLEAN |
Type booléen. |
OBJECT |
Type d'objet. |
ARRAY |
Type Array. |
NullValue
Représente un null JSON.
NullValue est une sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle pour l'union de types Value.
Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent un Value avec un null_value défini comme un null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.
| Enums | |
|---|---|
NULL_VALUE |
Valeur nulle. |
Type
Type de moteur. Consultez la documentation disponible sur https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType et https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Type de moteur non spécifié. |
ENGINE_TYPE_SEARCH |
Moteur SOLUTION_TYPE_SEARCH de l'application. Tous les datastores de connecteur ajoutés à l'application seront ajoutés à ce moteur. |
ENGINE_TYPE_CHAT |
Type de moteur de chat. Moteur SOLUTION_TYPE_CHAT de l'application. Tous les datastores de connecteur ajoutés à l'application seront ajoutés à ce moteur. |
ChannelType
Type du profil de canal.
| Enums | |
|---|---|
UNKNOWN |
Type de canal inconnu. |
WEB_UI |
Canal de l'UI Web. |
API |
Canal d'API. |
TWILIO |
Canal Twilio. |
GOOGLE_TELEPHONY_PLATFORM |
Canal Google Telephony Platform. |
CONTACT_CENTER_AS_A_SERVICE |
Canal Contact Center as a Service (CCaaS). |
CONTACT_CENTER_AS_A_SERVICE_CHAT |
Canal Contact Center as a Service (CCaaS Chat). |
FIVE9 |
Canal Five9. |
CONTACT_CENTER_INTEGRATION |
Canal d'intégration de centre de contact tiers. |
WHATSAPP |
Canal WhatsApp. |
INSTAGRAM |
Instagram. |
Persona
Le persona de la chaîne.
| Enums | |
|---|---|
UNKNOWN |
Persona INCONNU. |
CONCISE |
L'agent fournit des réponses concises et précises. |
CHATTY |
L'agent fournit du contexte, des explications et des détails supplémentaires |
Modalité
Modalité du widget Web.
| Enums | |
|---|---|
MODALITY_UNSPECIFIED |
Modalité inconnue. |
CHAT_AND_VOICE |
Le widget accepte les entrées de chat et vocales. |
VOICE_ONLY |
Le widget n'accepte que la saisie vocale. |
CHAT_ONLY |
Le widget n'accepte que les entrées de chat. |
CHAT_VOICE_AND_VIDEO |
Le widget accepte les entrées de chat, vocales et vidéo. |
Thème
Thème du widget Web.
| Enums | |
|---|---|
THEME_UNSPECIFIED |
Thème inconnu. |
LIGHT |
Thème clair. |
DARK |
le thème sombre. |
Annotations d'outils
Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.
En plus de la chaîne de titre, les indices booléens suivants sont définis comme suit :
readOnlyHint: si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".destructiveHint: si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".idempotentHint: si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".openWorldHint: si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.
Indication de destruction : ✅ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication en monde ouvert : ❌