MCP Tools Reference: ces.googleapis.com

Ferramenta: update_app

Atualiza o app especificado. Não se esqueça de sempre transmitir uma máscara de atualização na entrada.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta update_app MCP.

Solicitação curl 
                  
curl --location 'https://ces.[REGION].rep.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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para AgentService.UpdateApp.

UpdateAppRequest

Representação JSON 
{
  "app": {
    object (App)
  },
  "updateMask": string
}
Campos
app

object (App)

Obrigatório. O app a ser atualizado.
updateMask

string (FieldMask format)

Opcional. A máscara de campo é usada para controlar quais campos são atualizados. Se a máscara não estiver presente, todos os campos serão atualizados.

Uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

App

Representação JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "pinned": boolean,
  "rootAgent": string,
  "languageSettings": {
    object (LanguageSettings)
  },
  "timeZoneSettings": {
    object (TimeZoneSettings)
  },
  "audioProcessingConfig": {
    object (AudioProcessingConfig)
  },
  "loggingSettings": {
    object (LoggingSettings)
  },
  "errorHandlingSettings": {
    object (ErrorHandlingSettings)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "toolExecutionMode": enum (ToolExecutionMode),
  "evaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds)
  },
  "variableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "predefinedVariableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "globalInstruction": string,
  "guardrails": [
    string
  ],
  "dataStoreSettings": {
    object (DataStoreSettings)
  },
  "defaultChannelProfile": {
    object (ChannelProfile)
  },
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "deploymentCount": integer,
  "clientCertificateSettings": {
    object (ClientCertificateSettings)
  },
  "locked": boolean
}
Campos
name

string

Identificador. O identificador exclusivo do app. Formato: projects/{project}/locations/{location}/apps/{app}
displayName

string

Obrigatório. Nome de exibição do app.
description

string

Opcional. Descrição legível do app.
pinned

boolean

Opcional. Se o app está fixado na lista de apps.
rootAgent

string

Opcional. O agente raiz é o ponto de entrada do app. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
languageSettings

object (LanguageSettings)

Opcional. Configurações de idioma do app.
timeZoneSettings

object (TimeZoneSettings)

Opcional. Configurações de fuso horário do app.
audioProcessingConfig

object (AudioProcessingConfig)

Opcional. Configuração de processamento de áudio do app.
loggingSettings

object (LoggingSettings)

Opcional. Configurações de registro do app.
errorHandlingSettings

object (ErrorHandlingSettings)

Opcional. Configurações de tratamento de erros do app.
modelSettings

object (ModelSettings)

Opcional. As configurações padrão do modelo de LLM para o app. Recursos individuais (por exemplo, agentes, mecanismos de proteção) podem substituir essas configurações conforme necessário.
toolExecutionMode

enum (ToolExecutionMode)

Opcional. O modo de execução da ferramenta para o app. Se não for fornecido, o padrão será PARALLEL.
evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

Opcional. Os limites de avaliação do app.
variableDeclarations[]

object (VariableDeclaration)

Opcional. As declarações das variáveis.
predefinedVariableDeclarations[]

object (VariableDeclaration)

Apenas saída. As declarações de variáveis predefinidas para o app.
globalInstruction

string

Opcional. Instruções para todos os agentes no app. Use essa instrução para definir uma identidade ou personalidade estável em todos os agentes.
guardrails[]

string

Opcional. Lista de proteções para o app. Formato: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
dataStoreSettings

object (DataStoreSettings)

Opcional. As configurações do repositório de dados para o app.
defaultChannelProfile

object (ChannelProfile)

Opcional. O perfil de canal padrão usado pelo app.
metadata

map (key: string, value: string)

Opcional. Metadados sobre o app. Esse campo pode ser usado para armazenar informações adicionais relevantes para os detalhes ou usos pretendidos do app.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da criação do app.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora em que o app foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
etag

string

Apenas saída. Etag usada para garantir que o objeto não mudou durante uma operação de leitura-modificação-gravação. Se a ETag estiver vazia, a atualização vai substituir todas as mudanças simultâneas.
deploymentCount

integer

Apenas saída. Número de implantações no app.
clientCertificateSettings

object (ClientCertificateSettings)

Opcional. As configurações padrão de certificado do cliente para o app.
locked

boolean

Opcional. Indica se o app está bloqueado para mudanças. Se o app estiver bloqueado, as modificações nos recursos dele serão rejeitadas.

LanguageSettings

Representação JSON 
{
  "defaultLanguageCode": string,
  "supportedLanguageCodes": [
    string
  ],
  "enableMultilingualSupport": boolean,
  "fallbackAction": string
}
Campos
defaultLanguageCode

string

Opcional. O código de idioma padrão do app.
supportedLanguageCodes[]

string

Opcional. Lista de códigos de idiomas compatíveis com o app, além do default_language_code.
enableMultilingualSupport

boolean

Opcional. Ativa o suporte multilíngue. Se for verdadeiro, os agentes no app vão usar instruções pré-criadas para melhorar o processamento de entradas multilíngues.
fallbackAction

string

Opcional. A ação a ser realizada quando um agente recebe entrada em um idioma sem suporte.

Pode ser uma ação predefinida ou uma chamada de função personalizada. Os valores válidos são: - O nome completo do recurso de uma ferramenta, que aciona a execução de uma ferramenta específica. - Uma ação predefinida do sistema, como "escalar" ou "sair", que aciona um sinal EndSession com o metadata correspondente para encerrar a conversa.

TimeZoneSettings

Representação JSON 
{
  "timeZone": string
}
Campos
timeZone

string

Opcional. O fuso horário do app do banco de dados de fuso horário, por exemplo, America/Los_Angeles, Europe/Paris.

AudioProcessingConfig

Representação JSON 
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  }
}
Campos
synthesizeSpeechConfigs

map (key: string, value: object (SynthesizeSpeechConfig))

Opcional. Configuração de como a resposta do agente deve ser sintetizada, mapeando do código de idioma para SynthesizeSpeechConfig.

Se a configuração do código de idioma especificado não for encontrada, a configuração do código de idioma raiz será usada. Por exemplo, se o mapa contiver "en-us" e "en", e o código de idioma especificado for "en-gb", a configuração "en" será usada.

Observação: o código do idioma não diferencia maiúsculas de minúsculas.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
bargeInConfig

object (BargeInConfig)

Opcional. Configura o comportamento do agente para as atividades de interrupção do usuário.
inactivityTimeout

string (Duration format)

Opcional. A duração da inatividade do usuário (sem fala ou interação) antes que o agente peça para ele interagir novamente. Se não for definido, o agente não vai pedir que o usuário se envolva novamente.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
ambientSoundConfig

object (AmbientSoundConfig)

Opcional. Configuração para o som ambiente a ser reproduzido com a resposta sintetizada do agente, para aumentar a naturalidade da conversa.

SynthesizeSpeechConfigsEntry

Representação JSON 
{
  "key": string,
  "value": {
    object (SynthesizeSpeechConfig)
  }
}
Campos
key

string
value

object (SynthesizeSpeechConfig)

SynthesizeSpeechConfig

Representação JSON 
{
  "voice": string,
  "speakingRate": number
}
Campos
voice

string

Opcional. Nome da voz. Se não for definido, o serviço vai escolher uma voz com base nos outros parâmetros, como language_code.

Para conferir a lista de vozes disponíveis, consulte Vozes e idiomas compatíveis do Cloud Text-to-Speech.
speakingRate

number

Opcional. A taxa/velocidade de fala no intervalo [0,25, 2,0]. 1,0 é a velocidade nativa normal compatível com a voz específica. 2,0 é duas vezes mais rápido e 0,5 é metade da velocidade nativa. Valores fora do intervalo [0,25, 2,0] vão retornar um erro.

BargeInConfig

Representação JSON 
{
  "disableBargeIn": boolean,
  "bargeInAwareness": boolean
}
Campos
disableBargeIn
(deprecated)

boolean

Opcional. Desativa a interrupção do usuário enquanto o agente está falando. Se for verdadeiro, a entrada do usuário durante a reprodução da resposta do agente será ignorada.

Descontinuado: disable_barge_in foi descontinuado em favor de disable_barge_in_control em ChannelProfile.
bargeInAwareness

boolean

Opcional. Se ativado, o agente vai adaptar a próxima resposta com base na suposição de que o usuário não ouviu a mensagem completa anterior do agente. Isso não deve ser usado em cenários em que as respostas do agente são mostradas visualmente.

Duração

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Segundos assinados do período. Precisa estar entre -315.576.000.000 e +315.576.000.000 (inclusive). Observação: esses limites são calculados da seguinte forma: 60 s/min * 60 min/h * 24 h/dia * 365,25 dias/ano * 10.000 anos
nanos

integer

Frações assinadas de um segundo com resolução de nanossegundos do período. Durações menores que um segundo são representadas com um campo seconds 0 e um campo nanos positivo ou negativo. Para durações de um segundo ou mais, um valor diferente de zero para o campo nanos precisa ter o mesmo sinal do campo seconds. Precisa estar entre -999.999.999 e +999.999.999 (inclusive).

AmbientSoundConfig

Representação JSON 
{
  "volumeGainDb": number,

  // Union field source can be only one of the following:
  "prebuiltAmbientNoise": enum (PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of list of possible types for union field source.
}
Campos
volumeGainDb

number

Opcional. Ganho (em dB) do volume nativo normal suportado pelo ruído ambiente, no intervalo [-96.0, 16.0]. Se não for definido, ou ajustado para um valor de 0,0 (dB), será reproduzido na amplitude de sinal nativo normal. Um valor de -6,0 (dB) será reproduzido em aproximadamente metade da amplitude do sinal nativo normal. Um valor de +6,0 (dB) será reproduzido em aproximadamente o dobro da amplitude do sinal nativo normal. É altamente recomendável não exceder +10 (dB). Geralmente, não há aumento efetivo de volume para qualquer valor maior que isso.
Campo de união source. Ruído ambiente a ser reproduzido com a resposta sintetizada do agente para aumentar a naturalidade da conversa. source pode ser apenas de um dos tipos a seguir:
prebuiltAmbientNoise
(deprecated)

enum (PrebuiltAmbientNoise)

Opcional. Descontinuado: prebuilt_ambient_noise foi descontinuado em favor de prebuilt_ambient_sound.
gcsUri

string

Opcional. Ruído ambiente como um arquivo WAV de 16 kHz de canal único armazenado no Cloud Storage.

Observação: verifique se o agente de serviço do CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com tem permissão storage.objects.get para o objeto do Cloud Storage.
prebuiltAmbientSound

string

Opcional. Nome do som ambiente predefinido. Os valores válidos são: "coffee_shop", "keyboard", "keypad", "hum", "office_1", "office_2", "office_3", "room_1", "room_2", "room_3", "room_4", "room_5", "air_conditioner".

LoggingSettings

Representação JSON 
{
  "redactionConfig": {
    object (RedactionConfig)
  },
  "audioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "bigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "cloudLoggingSettings": {
    object (CloudLoggingSettings)
  },
  "conversationLoggingSettings": {
    object (ConversationLoggingSettings)
  },
  "evaluationAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "metricAnalysisSettings": {
    object (MetricAnalysisSettings)
  }
}
Campos
redactionConfig

object (RedactionConfig)

Opcional. Configuração de como os dados sensíveis devem ser encobridos.
audioRecordingConfig

object (AudioRecordingConfig)

Opcional. Configuração de como as interações de áudio devem ser gravadas.
bigqueryExportSettings

object (BigQueryExportSettings)

Opcional. Configurações para descrever os comportamentos de exportação do BigQuery para o app. Os dados de conversa serão exportados para tabelas do BigQuery se essa opção estiver ativada.
cloudLoggingSettings

object (CloudLoggingSettings)

Opcional. Configurações para descrever os comportamentos do Cloud Logging para o app.
conversationLoggingSettings

object (ConversationLoggingSettings)

Opcional. Configurações para descrever os comportamentos de registro de conversas do app.
evaluationAudioRecordingConfig

object (AudioRecordingConfig)

Opcional. Configuração de como as interações de áudio devem ser gravadas para a avaliação. Por padrão, a gravação de áudio não está ativada para sessões de avaliação.
metricAnalysisSettings

object (MetricAnalysisSettings)

Opcional. Configurações para descrever os comportamentos de coleta de dados de conversa para o pipeline de análise de LLM do app.

RedactionConfig

Representação JSON 
{
  "enableRedaction": boolean,
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
Campos
enableRedaction

boolean

Opcional. Se for verdadeiro, a edição será aplicada em vários cenários de geração de registros, incluindo histórico de conversas, Cloud Logging e gravação de áudio.
inspectTemplate

string

Opcional. Nome do modelo de inspeção do DLP para configurar a detecção de tipos de dados sensíveis.

Formato: projects/{project}/locations/{location}/inspectTemplates/{inspect_template}
deidentifyTemplate

string

Opcional. Nome do modelo de desidentificação do DLP para instruir sobre como desidentificar conteúdo.

Formato: projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}

AudioRecordingConfig

Representação JSON 
{
  "gcsBucket": string,
  "gcsPathPrefix": string
}
Campos
gcsBucket

string

Opcional. O bucket do Cloud Storage para armazenar as gravações de áudio da sessão. O URI precisa começar com "gs://".

Escolha um local de bucket que atenda aos seus requisitos de residência de dados.

Observação: se o bucket do Cloud Storage estiver em um projeto diferente do app, conceda a permissão storage.objects.create ao agente de serviço do CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com.
gcsPathPrefix

string

Opcional. O prefixo do caminho do Cloud Storage para gravações de áudio.

Esse prefixo pode incluir os seguintes marcadores de posição, que serão substituídos dinamicamente no momento da veiculação: - $project: ID do projeto - $location: local do app - $app: ID do app - $date: data da sessão no formato AAAA-MM-DD - $session: ID da sessão

Se o prefixo de caminho não for especificado, o prefixo padrão $project/$location/$app/$date/$session/ será usado.

BigQueryExportSettings

Representação JSON 
{
  "enabled": boolean,
  "project": string,
  "dataset": string
}
Campos
enabled

boolean

Opcional. Indica se a exportação do BigQuery está ativada.
project

string

Opcional. O ID do projeto do conjunto de dados do BigQuery para exportar os dados.

Observação: se o conjunto de dados do BigQuery estiver em um projeto diferente do app, conceda o papel roles/bigquery.admin ao agente de serviço do CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com.
dataset

string

Opcional. O conjunto de dados do BigQuery para exportar os dados.

CloudLoggingSettings

Representação JSON 
{
  "enableCloudLogging": boolean
}
Campos
enableCloudLogging

boolean

Opcional. Define se o Cloud Logging será ativado para as sessões.

ConversationLoggingSettings

Representação JSON 
{
  "disableConversationLogging": boolean
}
Campos
disableConversationLogging

boolean

Opcional. Se a geração de registros de conversa deve ser desativada para as sessões.

MetricAnalysisSettings

Representação JSON 
{
  "llmMetricsOptedOut": boolean
}
Campos
llmMetricsOptedOut

boolean

Opcional. Se os dados de conversa serão coletados para métricas de análise de LLM. Se for "true", os dados de conversa não serão coletados para métricas de análise de LLM. Caso contrário, eles serão coletados.

ErrorHandlingSettings

Representação JSON 
{
  "errorHandlingStrategy": enum (ErrorHandlingStrategy)
}
Campos
errorHandlingStrategy

enum (ErrorHandlingStrategy)

Opcional. A estratégia a ser usada para tratamento de erros.

ModelSettings

Representação JSON 
{
  "model": string,

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
Campos
model

string

Opcional. O modelo de LLM que o agente deve usar. Se não estiver definido, o agente vai herdar o modelo do agente principal.

Campo de união _temperature.

_temperature pode ser apenas de um dos tipos a seguir:
temperature

number

Opcional. Se definido, essa temperatura será usada para o modelo LLM. A temperatura controla a aleatoriedade das respostas do modelo. Temperaturas mais baixas produzem respostas mais previsíveis. Temperaturas mais altas produzem respostas mais criativas.

EvaluationMetricsThresholds

Representação JSON 
{
  "goldenEvaluationMetricsThresholds": {
    object (GoldenEvaluationMetricsThresholds)
  },
  "hallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "goldenHallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "scenarioHallucinationMetricBehavior": enum (HallucinationMetricBehavior)
}
Campos
goldenEvaluationMetricsThresholds

object (GoldenEvaluationMetricsThresholds)

Opcional. Os limites das métricas de avaliação de ouro.
hallucinationMetricBehavior
(deprecated)

enum (HallucinationMetricBehavior)

Opcional. Descontinuado: use golden_hallucination_metric_behavior. O comportamento da métrica de alucinação é usado atualmente para avaliações de ouro.
goldenHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

Opcional. O comportamento da métrica de alucinação para avaliações de ouro.
scenarioHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

Opcional. O comportamento da métrica de alucinação para avaliações de cenário.

GoldenEvaluationMetricsThresholds

Representação JSON 
{
  "turnLevelMetricsThresholds": {
    object (TurnLevelMetricsThresholds)
  },
  "expectationLevelMetricsThresholds": {
    object (ExpectationLevelMetricsThresholds)
  },
  "toolMatchingSettings": {
    object (ToolMatchingSettings)
  }
}
Campos
turnLevelMetricsThresholds

object (TurnLevelMetricsThresholds)

Opcional. Os limites das métricas no nível da rodada.
expectationLevelMetricsThresholds

object (ExpectationLevelMetricsThresholds)

Opcional. Os limites das métricas de nível de expectativa.
toolMatchingSettings

object (ToolMatchingSettings)

Opcional. As configurações de correspondência de ferramentas. Uma chamada de ferramenta extra é uma chamada de ferramenta presente na execução, mas que não corresponde a nenhuma chamada de ferramenta na expectativa de ouro.

TurnLevelMetricsThresholds

Representação JSON 
{
  "semanticSimilarityChannel": enum (SemanticSimilarityChannel),

  // Union field _semantic_similarity_success_threshold can be only one of the
  // following:
  "semanticSimilaritySuccessThreshold": integer
  // End of list of possible types for union field
  // _semantic_similarity_success_threshold.

  // Union field _overall_tool_invocation_correctness_threshold can be only one
  // of the following:
  "overallToolInvocationCorrectnessThreshold": number
  // End of list of possible types for union field
  // _overall_tool_invocation_correctness_threshold.
}
Campos
semanticSimilarityChannel

enum (SemanticSimilarityChannel)

Opcional. O canal de similaridade semântica a ser usado para avaliação.

Campo de união _semantic_similarity_success_threshold.

_semantic_similarity_success_threshold pode ser apenas de um dos tipos a seguir:
semanticSimilaritySuccessThreshold

integer

Opcional. O limite de sucesso para similaridade semântica. O valor precisa ser um número inteiro entre 0 e 4. O padrão é ">= 3".

Campo de união _overall_tool_invocation_correctness_threshold.

_overall_tool_invocation_correctness_threshold pode ser apenas de um dos tipos a seguir:
overallToolInvocationCorrectnessThreshold

number

Opcional. O limite de sucesso para a correção geral da invocação da ferramenta. Precisa ser um número de ponto flutuante entre 0 e 1. O padrão é 1,0.

ExpectationLevelMetricsThresholds

Representação JSON 
{

  // Union field _tool_invocation_parameter_correctness_threshold can be only one
  // of the following:
  "toolInvocationParameterCorrectnessThreshold": number
  // End of list of possible types for union field
  // _tool_invocation_parameter_correctness_threshold.
}
Campos

Campo de união _tool_invocation_parameter_correctness_threshold.

_tool_invocation_parameter_correctness_threshold pode ser apenas de um dos tipos a seguir:
toolInvocationParameterCorrectnessThreshold

number

Opcional. O limite de sucesso para a correção de parâmetros de invocação de ferramentas individuais. Precisa ser um número de ponto flutuante entre 0 e 1. O padrão é 1,0.

ToolMatchingSettings

Representação JSON 
{
  "extraToolCallBehavior": enum (ExtraToolCallBehavior)
}
Campos
extraToolCallBehavior

enum (ExtraToolCallBehavior)

Opcional. Comportamento para chamadas de função extras. O padrão é FAIL.

VariableDeclaration

Representação JSON 
{
  "name": string,
  "description": string,
  "schema": {
    object (Schema)
  }
}
Campos
name

string

Obrigatório. O nome da variável. O nome precisa começar com uma letra ou um sublinhado e conter apenas letras, números ou sublinhados.
description

string

Obrigatório. A descrição da variável.
schema

object (Schema)

Obrigatório. O esquema da variável.

Esquema

Representação JSON 
{
  "type": enum (Type),
  "properties": {
    string: {
      object (Schema)
    },
    ...
  },
  "required": [
    string
  ],
  "description": string,
  "items": {
    object (Schema)
  },
  "nullable": boolean,
  "uniqueItems": boolean,
  "prefixItems": [
    {
      object (Schema)
    }
  ],
  "additionalProperties": {
    object (Schema)
  },
  "anyOf": [
    {
      object (Schema)
    }
  ],
  "enum": [
    string
  ],
  "default": value,
  "ref": string,
  "defs": {
    string: {
      object (Schema)
    },
    ...
  },
  "title": string,
  "minItems": string,
  "maxItems": string,

  // Union field _minimum can be only one of the following:
  "minimum": number
  // End of list of possible types for union field _minimum.

  // Union field _maximum can be only one of the following:
  "maximum": number
  // End of list of possible types for union field _maximum.
}
Campos
type

enum (Type)

Obrigatório. O tipo dos dados.
properties

map (key: string, value: object (Schema))

Opcional. Propriedades de Type.OBJECT.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
required[]

string

Opcional. Propriedades obrigatórias de Type.OBJECT.
description

string

Opcional. A descrição dos dados.
items

object (Schema)

Opcional. Esquema dos elementos de Type.ARRAY.
nullable

boolean

Opcional. Indica se o valor pode ser nulo.
uniqueItems

boolean

Opcional. Indica que os itens na matriz precisam ser exclusivos. Aplicável apenas a TYPE.ARRAY.
prefixItems[]

object (Schema)

Opcional. Esquemas dos elementos iniciais de Type.ARRAY.
additionalProperties

object (Schema)

Opcional. Pode ser um booleano ou um objeto e controla a presença de propriedades adicionais.
anyOf[]

object (Schema)

Opcional. O valor precisa ser validado em relação a qualquer um (um ou mais) dos subesquemas na lista.
enum[]

string

Opcional. Valores possíveis do elemento de tipo primitivo com formato de enumeração. Exemplos: 1. Podemos definir a direção como : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. Podemos definir o número do apartamento como : {type:INTEGER, format:enum, enum:["101", "201", "301"]}
default

value (Value format)

Opcional. Valor padrão dos dados.
ref

string

Opcional. Permite referências indiretas entre nós de esquema. O valor precisa ser uma referência válida a um filho do defs raiz.

Por exemplo, o esquema a seguir define uma referência a um nó de esquema chamado "Pet":

type: object
properties:
  pet:
    ref: #/defs/Pet
defs:
  Pet:
    type: object
    properties:
      name:
        type: string

O valor da propriedade "pet" é uma referência ao nó de esquema chamado "Pet". Confira detalhes em https://json-schema.org/understanding-json-schema/structuring (em inglês).
defs

map (key: string, value: object (Schema))

Opcional. Um mapa de definições para uso por ref. Permitido apenas na raiz do esquema.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

string

Opcional. O título do esquema.
minItems

string (int64 format)

Opcional. Número mínimo de elementos para Type.ARRAY.
maxItems

string (int64 format)

Opcional. Número máximo de elementos para Type.ARRAY.

Campo de união _minimum.

_minimum pode ser apenas de um dos tipos a seguir:
minimum

number

Opcional. Valor mínimo para Type.INTEGER e Type.NUMBER.

Campo de união _maximum.

_maximum pode ser apenas de um dos tipos a seguir:
maximum

number

Opcional. Valor máximo para Type.INTEGER e Type.NUMBER.

PropertiesEntry

Representação JSON 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
Campos
key

string
value

object (Schema)

Valor

Representação JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Campos
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir:
nullValue

null

Representa um valor nulo.
numberValue

number

Representa um valor double.
stringValue

string

Representa um valor de string.
boolValue

boolean

Representa um valor booleano.
structValue

object (Struct format)

Representa um valor estruturado.
listValue

array (ListValue format)

Representa um Value repetido.

Struct

Representação JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

map (key: string, value: value (Value format))

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

ListValue

Representação JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Campo repetido de valores digitados dinamicamente.

DefsEntry

Representação JSON 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
Campos
key

string
value

object (Schema)

DataStoreSettings

Representação JSON 
{
  "engines": [
    {
      object (Engine)
    }
  ]
}
Campos
engines[]

object (Engine)

Apenas saída. Os mecanismos do app.

Mecanismo

Representação JSON 
{
  "name": string,
  "type": enum (Type)
}
Campos
name

string

Apenas saída. O nome do recurso do mecanismo. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}
type

enum (Type)

Apenas saída. O tipo de motor.

ChannelProfile

Representação JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
Campos
profileId

string

Opcional. O identificador exclusivo do perfil do canal.
channelType

enum (ChannelType)

Opcional. O tipo do perfil do canal.
personaProperty

object (PersonaProperty)

Opcional. A propriedade de persona do perfil do canal.
disableDtmf

boolean

Opcional. Indica se o DTMF (multifrequência de dois tons) será desativado.
disableBargeInControl

boolean

Opcional. Se o controle de interrupção do usuário na conversa deve ser desativado. - true: as interrupções do usuário são desativadas enquanto o agente está falando. - false: o agente mantém o controle automático sobre quando o usuário pode interromper.
webWidgetConfig

object (WebWidgetConfig)

Opcional. A configuração do widget da Web.
noiseSuppressionLevel

string

Opcional. O nível de supressão de ruído do perfil do canal. Os valores disponíveis são "low", "moderate", "high", "very_high".

PersonaProperty

Representação JSON 
{
  "persona": enum (Persona)
}
Campos
persona

enum (Persona)

Opcional. A persona do canal.

WebWidgetConfig

Representação JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Campos
modality

enum (Modality)

Opcional. A modalidade do widget da Web.
theme

enum (Theme)

Opcional. O tema do widget da Web.
webWidgetTitle

string

Opcional. O título do widget da Web.
securitySettings

object (SecuritySettings)

Opcional. As configurações de segurança do widget da Web.

SecuritySettings

Representação JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Campos
enablePublicAccess

boolean

Opcional. Indica se o acesso público ao widget da Web está ativado. Se for true, o widget da Web será acessível publicamente. Se false, o widget da Web precisará ser integrado ao seu próprio sistema de autenticação e autorização para retornar credenciais válidas de acesso ao agente da CES.
enableOriginCheck

boolean

Opcional. Indica se a verificação de origem do widget da Web está ativada. Se true, o widget da Web vai verificar a origem do site que o carrega e permitir que ele seja carregado apenas na mesma origem ou em qualquer uma das origens permitidas.
allowedOrigins[]

string

Opcional. As origens que podem hospedar o widget da Web. Uma origem é definida pela RFC 6454. Se estiver vazio, todas as origens serão permitidas. São permitidas no máximo 100 origens. Exemplo: "https://example.com"
enableRecaptcha

boolean

Opcional. Indica se a verificação do reCAPTCHA para o widget da Web está ativada.

MetadataEntry

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

ClientCertificateSettings

Representação JSON 
{
  "tlsCertificate": string,
  "privateKey": string,
  "passphrase": string
}
Campos
tlsCertificate

string

Obrigatório. O certificado TLS codificado no formato PEM. Essa string precisa incluir as linhas de cabeçalho de início e rodapé de fim.
privateKey

string

Obrigatório. O nome do recurso de versão do secret do Secret Manager que armazena a chave privada codificada no formato PEM. Formato: projects/{project}/secrets/{secret}/versions/{version}
passphrase

string

Opcional. O nome do recurso da versão do secret do Secret Manager que armazena a senha longa para descriptografar a chave privada. Deve ser deixado sem definição se a chave privada não estiver criptografada. Formato: projects/{project}/secrets/{secret}/versions/{version}

FieldMask

Representação JSON 
{
  "paths": [
    string
  ]
}
Campos
paths[]

string

O conjunto de caminhos de máscara de campo.

Esquema de saída

Um app serve como um contêiner de nível superior para um grupo de agentes, incluindo o agente raiz e os subagentes, além das configurações associadas. Esses agentes trabalham juntos para alcançar metas específicas no contexto do app.

App

Representação JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "pinned": boolean,
  "rootAgent": string,
  "languageSettings": {
    object (LanguageSettings)
  },
  "timeZoneSettings": {
    object (TimeZoneSettings)
  },
  "audioProcessingConfig": {
    object (AudioProcessingConfig)
  },
  "loggingSettings": {
    object (LoggingSettings)
  },
  "errorHandlingSettings": {
    object (ErrorHandlingSettings)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "toolExecutionMode": enum (ToolExecutionMode),
  "evaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds)
  },
  "variableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "predefinedVariableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "globalInstruction": string,
  "guardrails": [
    string
  ],
  "dataStoreSettings": {
    object (DataStoreSettings)
  },
  "defaultChannelProfile": {
    object (ChannelProfile)
  },
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "deploymentCount": integer,
  "clientCertificateSettings": {
    object (ClientCertificateSettings)
  },
  "locked": boolean
}
Campos
name

string

Identificador. O identificador exclusivo do app. Formato: projects/{project}/locations/{location}/apps/{app}
displayName

string

Obrigatório. Nome de exibição do app.
description

string

Opcional. Descrição legível do app.
pinned

boolean

Opcional. Se o app está fixado na lista de apps.
rootAgent

string

Opcional. O agente raiz é o ponto de entrada do app. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
languageSettings

object (LanguageSettings)

Opcional. Configurações de idioma do app.
timeZoneSettings

object (TimeZoneSettings)

Opcional. Configurações de fuso horário do app.
audioProcessingConfig

object (AudioProcessingConfig)

Opcional. Configuração de processamento de áudio do app.
loggingSettings

object (LoggingSettings)

Opcional. Configurações de registro do app.
errorHandlingSettings

object (ErrorHandlingSettings)

Opcional. Configurações de tratamento de erros do app.
modelSettings

object (ModelSettings)

Opcional. As configurações padrão do modelo de LLM para o app. Recursos individuais (por exemplo, agentes, mecanismos de proteção) podem substituir essas configurações conforme necessário.
toolExecutionMode

enum (ToolExecutionMode)

Opcional. O modo de execução da ferramenta para o app. Se não for fornecido, o padrão será PARALLEL.
evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

Opcional. Os limites de avaliação do app.
variableDeclarations[]

object (VariableDeclaration)

Opcional. As declarações das variáveis.
predefinedVariableDeclarations[]

object (VariableDeclaration)

Apenas saída. As declarações de variáveis predefinidas para o app.
globalInstruction

string

Opcional. Instruções para todos os agentes no app. Use essa instrução para definir uma identidade ou personalidade estável em todos os agentes.
guardrails[]

string

Opcional. Lista de proteções para o app. Formato: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
dataStoreSettings

object (DataStoreSettings)

Opcional. As configurações do repositório de dados para o app.
defaultChannelProfile

object (ChannelProfile)

Opcional. O perfil de canal padrão usado pelo app.
metadata

map (key: string, value: string)

Opcional. Metadados sobre o app. Esse campo pode ser usado para armazenar informações adicionais relevantes para os detalhes ou usos pretendidos do app.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da criação do app.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora em que o app foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
etag

string

Apenas saída. Etag usada para garantir que o objeto não mudou durante uma operação de leitura-modificação-gravação. Se a ETag estiver vazia, a atualização vai substituir todas as mudanças simultâneas.
deploymentCount

integer

Apenas saída. Número de implantações no app.
clientCertificateSettings

object (ClientCertificateSettings)

Opcional. As configurações padrão de certificado do cliente para o app.
locked

boolean

Opcional. Indica se o app está bloqueado para mudanças. Se o app estiver bloqueado, as modificações nos recursos dele serão rejeitadas.

LanguageSettings

Representação JSON 
{
  "defaultLanguageCode": string,
  "supportedLanguageCodes": [
    string
  ],
  "enableMultilingualSupport": boolean,
  "fallbackAction": string
}
Campos
defaultLanguageCode

string

Opcional. O código de idioma padrão do app.
supportedLanguageCodes[]

string

Opcional. Lista de códigos de idiomas compatíveis com o app, além do default_language_code.
enableMultilingualSupport

boolean

Opcional. Ativa o suporte multilíngue. Se for verdadeiro, os agentes no app vão usar instruções pré-criadas para melhorar o processamento de entradas multilíngues.
fallbackAction

string

Opcional. A ação a ser realizada quando um agente recebe entrada em um idioma sem suporte.

Pode ser uma ação predefinida ou uma chamada de função personalizada. Os valores válidos são: - O nome completo do recurso de uma ferramenta, que aciona a execução de uma ferramenta específica. - Uma ação predefinida do sistema, como "escalar" ou "sair", que aciona um sinal EndSession com o metadata correspondente para encerrar a conversa.

TimeZoneSettings

Representação JSON 
{
  "timeZone": string
}
Campos
timeZone

string

Opcional. O fuso horário do app do banco de dados de fuso horário, por exemplo, America/Los_Angeles, Europe/Paris.

AudioProcessingConfig

Representação JSON 
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  }
}
Campos
synthesizeSpeechConfigs

map (key: string, value: object (SynthesizeSpeechConfig))

Opcional. Configuração de como a resposta do agente deve ser sintetizada, mapeando do código de idioma para SynthesizeSpeechConfig.

Se a configuração do código de idioma especificado não for encontrada, a configuração do código de idioma raiz será usada. Por exemplo, se o mapa contiver "en-us" e "en", e o código de idioma especificado for "en-gb", a configuração "en" será usada.

Observação: o código do idioma não diferencia maiúsculas de minúsculas.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
bargeInConfig

object (BargeInConfig)

Opcional. Configura o comportamento do agente para as atividades de interrupção do usuário.
inactivityTimeout

string (Duration format)

Opcional. A duração da inatividade do usuário (sem fala ou interação) antes que o agente peça para ele interagir novamente. Se não for definido, o agente não vai pedir que o usuário se envolva novamente.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
ambientSoundConfig

object (AmbientSoundConfig)

Opcional. Configuração para o som ambiente a ser reproduzido com a resposta sintetizada do agente, para aumentar a naturalidade da conversa.

SynthesizeSpeechConfigsEntry

Representação JSON 
{
  "key": string,
  "value": {
    object (SynthesizeSpeechConfig)
  }
}
Campos
key

string
value

object (SynthesizeSpeechConfig)

SynthesizeSpeechConfig

Representação JSON 
{
  "voice": string,
  "speakingRate": number
}
Campos
voice

string

Opcional. Nome da voz. Se não for definido, o serviço vai escolher uma voz com base nos outros parâmetros, como language_code.

Para conferir a lista de vozes disponíveis, consulte Vozes e idiomas compatíveis do Cloud Text-to-Speech.
speakingRate

number

Opcional. A taxa/velocidade de fala no intervalo [0,25, 2,0]. 1,0 é a velocidade nativa normal compatível com a voz específica. 2,0 é duas vezes mais rápido e 0,5 é metade da velocidade nativa. Valores fora do intervalo [0,25, 2,0] vão retornar um erro.

BargeInConfig

Representação JSON 
{
  "disableBargeIn": boolean,
  "bargeInAwareness": boolean
}
Campos
disableBargeIn
(deprecated)

boolean

Opcional. Desativa a interrupção do usuário enquanto o agente está falando. Se for verdadeiro, a entrada do usuário durante a reprodução da resposta do agente será ignorada.

Descontinuado: disable_barge_in foi descontinuado em favor de disable_barge_in_control em ChannelProfile.
bargeInAwareness

boolean

Opcional. Se ativado, o agente vai adaptar a próxima resposta com base na suposição de que o usuário não ouviu a mensagem completa anterior do agente. Isso não deve ser usado em cenários em que as respostas do agente são mostradas visualmente.

Duração

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Segundos assinados do período. Precisa estar entre -315.576.000.000 e +315.576.000.000 (inclusive). Observação: esses limites são calculados da seguinte forma: 60 s/min * 60 min/h * 24 h/dia * 365,25 dias/ano * 10.000 anos
nanos

integer

Frações assinadas de um segundo com resolução de nanossegundos do período. Durações menores que um segundo são representadas com um campo seconds 0 e um campo nanos positivo ou negativo. Para durações de um segundo ou mais, um valor diferente de zero para o campo nanos precisa ter o mesmo sinal do campo seconds. Precisa estar entre -999.999.999 e +999.999.999 (inclusive).

AmbientSoundConfig

Representação JSON 
{
  "volumeGainDb": number,

  // Union field source can be only one of the following:
  "prebuiltAmbientNoise": enum (PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of list of possible types for union field source.
}
Campos
volumeGainDb

number

Opcional. Ganho (em dB) do volume nativo normal suportado pelo ruído ambiente, no intervalo [-96.0, 16.0]. Se não for definido, ou ajustado para um valor de 0,0 (dB), será reproduzido na amplitude de sinal nativo normal. Um valor de -6,0 (dB) será reproduzido em aproximadamente metade da amplitude do sinal nativo normal. Um valor de +6,0 (dB) será reproduzido em aproximadamente o dobro da amplitude do sinal nativo normal. É altamente recomendável não exceder +10 (dB). Geralmente, não há aumento efetivo de volume para qualquer valor maior que isso.
Campo de união source. Ruído ambiente a ser reproduzido com a resposta sintetizada do agente para aumentar a naturalidade da conversa. source pode ser apenas de um dos tipos a seguir:
prebuiltAmbientNoise
(deprecated)

enum (PrebuiltAmbientNoise)

Opcional. Descontinuado: prebuilt_ambient_noise foi descontinuado em favor de prebuilt_ambient_sound.
gcsUri

string

Opcional. Ruído ambiente como um arquivo WAV de 16 kHz de canal único armazenado no Cloud Storage.

Observação: verifique se o agente de serviço do CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com tem permissão storage.objects.get para o objeto do Cloud Storage.
prebuiltAmbientSound

string

Opcional. Nome do som ambiente predefinido. Os valores válidos são: "coffee_shop", "keyboard", "keypad", "hum", "office_1", "office_2", "office_3", "room_1", "room_2", "room_3", "room_4", "room_5", "air_conditioner".

LoggingSettings

Representação JSON 
{
  "redactionConfig": {
    object (RedactionConfig)
  },
  "audioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "bigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "cloudLoggingSettings": {
    object (CloudLoggingSettings)
  },
  "conversationLoggingSettings": {
    object (ConversationLoggingSettings)
  },
  "evaluationAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "metricAnalysisSettings": {
    object (MetricAnalysisSettings)
  }
}
Campos
redactionConfig

object (RedactionConfig)

Opcional. Configuração de como os dados sensíveis devem ser encobridos.
audioRecordingConfig

object (AudioRecordingConfig)

Opcional. Configuração de como as interações de áudio devem ser gravadas.
bigqueryExportSettings

object (BigQueryExportSettings)

Opcional. Configurações para descrever os comportamentos de exportação do BigQuery para o app. Os dados de conversa serão exportados para tabelas do BigQuery se essa opção estiver ativada.
cloudLoggingSettings

object (CloudLoggingSettings)

Opcional. Configurações para descrever os comportamentos do Cloud Logging para o app.
conversationLoggingSettings

object (ConversationLoggingSettings)

Opcional. Configurações para descrever os comportamentos de registro de conversas do app.
evaluationAudioRecordingConfig

object (AudioRecordingConfig)

Opcional. Configuração de como as interações de áudio devem ser gravadas para a avaliação. Por padrão, a gravação de áudio não está ativada para sessões de avaliação.
metricAnalysisSettings

object (MetricAnalysisSettings)

Opcional. Configurações para descrever os comportamentos de coleta de dados de conversa para o pipeline de análise de LLM do app.

RedactionConfig

Representação JSON 
{
  "enableRedaction": boolean,
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
Campos
enableRedaction

boolean

Opcional. Se for verdadeiro, a edição será aplicada em vários cenários de geração de registros, incluindo histórico de conversas, Cloud Logging e gravação de áudio.
inspectTemplate

string

Opcional. Nome do modelo de inspeção do DLP para configurar a detecção de tipos de dados sensíveis.

Formato: projects/{project}/locations/{location}/inspectTemplates/{inspect_template}
deidentifyTemplate

string

Opcional. Nome do modelo de desidentificação do DLP para instruir sobre como desidentificar conteúdo.

Formato: projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}

AudioRecordingConfig

Representação JSON 
{
  "gcsBucket": string,
  "gcsPathPrefix": string
}
Campos
gcsBucket

string

Opcional. O bucket do Cloud Storage para armazenar as gravações de áudio da sessão. O URI precisa começar com "gs://".

Escolha um local de bucket que atenda aos seus requisitos de residência de dados.

Observação: se o bucket do Cloud Storage estiver em um projeto diferente do app, conceda a permissão storage.objects.create ao agente de serviço do CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com.
gcsPathPrefix

string

Opcional. O prefixo do caminho do Cloud Storage para gravações de áudio.

Esse prefixo pode incluir os seguintes marcadores de posição, que serão substituídos dinamicamente no momento da veiculação: - $project: ID do projeto - $location: local do app - $app: ID do app - $date: data da sessão no formato AAAA-MM-DD - $session: ID da sessão

Se o prefixo de caminho não for especificado, o prefixo padrão $project/$location/$app/$date/$session/ será usado.

BigQueryExportSettings

Representação JSON 
{
  "enabled": boolean,
  "project": string,
  "dataset": string
}
Campos
enabled

boolean

Opcional. Indica se a exportação do BigQuery está ativada.
project

string

Opcional. O ID do projeto do conjunto de dados do BigQuery para exportar os dados.

Observação: se o conjunto de dados do BigQuery estiver em um projeto diferente do app, conceda o papel roles/bigquery.admin ao agente de serviço do CES service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com.
dataset

string

Opcional. O conjunto de dados do BigQuery para exportar os dados.

CloudLoggingSettings

Representação JSON 
{
  "enableCloudLogging": boolean
}
Campos
enableCloudLogging

boolean

Opcional. Define se o Cloud Logging será ativado para as sessões.

ConversationLoggingSettings

Representação JSON 
{
  "disableConversationLogging": boolean
}
Campos
disableConversationLogging

boolean

Opcional. Se a geração de registros de conversa deve ser desativada para as sessões.

MetricAnalysisSettings

Representação JSON 
{
  "llmMetricsOptedOut": boolean
}
Campos
llmMetricsOptedOut

boolean

Opcional. Se os dados de conversa serão coletados para métricas de análise de LLM. Se for "true", os dados de conversa não serão coletados para métricas de análise de LLM. Caso contrário, eles serão coletados.

ErrorHandlingSettings

Representação JSON 
{
  "errorHandlingStrategy": enum (ErrorHandlingStrategy)
}
Campos
errorHandlingStrategy

enum (ErrorHandlingStrategy)

Opcional. A estratégia a ser usada para tratamento de erros.

ModelSettings

Representação JSON 
{
  "model": string,

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
Campos
model

string

Opcional. O modelo de LLM que o agente deve usar. Se não estiver definido, o agente vai herdar o modelo do agente principal.

Campo de união _temperature.

_temperature pode ser apenas de um dos tipos a seguir:
temperature

number

Opcional. Se definido, essa temperatura será usada para o modelo LLM. A temperatura controla a aleatoriedade das respostas do modelo. Temperaturas mais baixas produzem respostas mais previsíveis. Temperaturas mais altas produzem respostas mais criativas.

EvaluationMetricsThresholds

Representação JSON 
{
  "goldenEvaluationMetricsThresholds": {
    object (GoldenEvaluationMetricsThresholds)
  },
  "hallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "goldenHallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "scenarioHallucinationMetricBehavior": enum (HallucinationMetricBehavior)
}
Campos
goldenEvaluationMetricsThresholds

object (GoldenEvaluationMetricsThresholds)

Opcional. Os limites das métricas de avaliação de ouro.
hallucinationMetricBehavior
(deprecated)

enum (HallucinationMetricBehavior)

Opcional. Descontinuado: use golden_hallucination_metric_behavior. O comportamento da métrica de alucinação é usado atualmente para avaliações de ouro.
goldenHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

Opcional. O comportamento da métrica de alucinação para avaliações de ouro.
scenarioHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

Opcional. O comportamento da métrica de alucinação para avaliações de cenário.

GoldenEvaluationMetricsThresholds

Representação JSON 
{
  "turnLevelMetricsThresholds": {
    object (TurnLevelMetricsThresholds)
  },
  "expectationLevelMetricsThresholds": {
    object (ExpectationLevelMetricsThresholds)
  },
  "toolMatchingSettings": {
    object (ToolMatchingSettings)
  }
}
Campos
turnLevelMetricsThresholds

object (TurnLevelMetricsThresholds)

Opcional. Os limites das métricas no nível da rodada.
expectationLevelMetricsThresholds

object (ExpectationLevelMetricsThresholds)

Opcional. Os limites das métricas de nível de expectativa.
toolMatchingSettings

object (ToolMatchingSettings)

Opcional. As configurações de correspondência de ferramentas. Uma chamada de ferramenta extra é uma chamada de ferramenta presente na execução, mas que não corresponde a nenhuma chamada de ferramenta na expectativa de ouro.

TurnLevelMetricsThresholds

Representação JSON 
{
  "semanticSimilarityChannel": enum (SemanticSimilarityChannel),

  // Union field _semantic_similarity_success_threshold can be only one of the
  // following:
  "semanticSimilaritySuccessThreshold": integer
  // End of list of possible types for union field
  // _semantic_similarity_success_threshold.

  // Union field _overall_tool_invocation_correctness_threshold can be only one
  // of the following:
  "overallToolInvocationCorrectnessThreshold": number
  // End of list of possible types for union field
  // _overall_tool_invocation_correctness_threshold.
}
Campos
semanticSimilarityChannel

enum (SemanticSimilarityChannel)

Opcional. O canal de similaridade semântica a ser usado para avaliação.

Campo de união _semantic_similarity_success_threshold.

_semantic_similarity_success_threshold pode ser apenas de um dos tipos a seguir:
semanticSimilaritySuccessThreshold

integer

Opcional. O limite de sucesso para similaridade semântica. O valor precisa ser um número inteiro entre 0 e 4. O padrão é ">= 3".

Campo de união _overall_tool_invocation_correctness_threshold.

_overall_tool_invocation_correctness_threshold pode ser apenas de um dos tipos a seguir:
overallToolInvocationCorrectnessThreshold

number

Opcional. O limite de sucesso para a correção geral da invocação da ferramenta. Precisa ser um número de ponto flutuante entre 0 e 1. O padrão é 1,0.

ExpectationLevelMetricsThresholds

Representação JSON 
{

  // Union field _tool_invocation_parameter_correctness_threshold can be only one
  // of the following:
  "toolInvocationParameterCorrectnessThreshold": number
  // End of list of possible types for union field
  // _tool_invocation_parameter_correctness_threshold.
}
Campos

Campo de união _tool_invocation_parameter_correctness_threshold.

_tool_invocation_parameter_correctness_threshold pode ser apenas de um dos tipos a seguir:
toolInvocationParameterCorrectnessThreshold

number

Opcional. O limite de sucesso para a correção de parâmetros de invocação de ferramentas individuais. Precisa ser um número de ponto flutuante entre 0 e 1. O padrão é 1,0.

ToolMatchingSettings

Representação JSON 
{
  "extraToolCallBehavior": enum (ExtraToolCallBehavior)
}
Campos
extraToolCallBehavior

enum (ExtraToolCallBehavior)

Opcional. Comportamento para chamadas de função extras. O padrão é FAIL.

VariableDeclaration

Representação JSON 
{
  "name": string,
  "description": string,
  "schema": {
    object (Schema)
  }
}
Campos
name

string

Obrigatório. O nome da variável. O nome precisa começar com uma letra ou um sublinhado e conter apenas letras, números ou sublinhados.
description

string

Obrigatório. A descrição da variável.
schema

object (Schema)

Obrigatório. O esquema da variável.

Esquema

Representação JSON 
{
  "type": enum (Type),
  "properties": {
    string: {
      object (Schema)
    },
    ...
  },
  "required": [
    string
  ],
  "description": string,
  "items": {
    object (Schema)
  },
  "nullable": boolean,
  "uniqueItems": boolean,
  "prefixItems": [
    {
      object (Schema)
    }
  ],
  "additionalProperties": {
    object (Schema)
  },
  "anyOf": [
    {
      object (Schema)
    }
  ],
  "enum": [
    string
  ],
  "default": value,
  "ref": string,
  "defs": {
    string: {
      object (Schema)
    },
    ...
  },
  "title": string,
  "minItems": string,
  "maxItems": string,

  // Union field _minimum can be only one of the following:
  "minimum": number
  // End of list of possible types for union field _minimum.

  // Union field _maximum can be only one of the following:
  "maximum": number
  // End of list of possible types for union field _maximum.
}
Campos
type

enum (Type)

Obrigatório. O tipo dos dados.
properties

map (key: string, value: object (Schema))

Opcional. Propriedades de Type.OBJECT.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
required[]

string

Opcional. Propriedades obrigatórias de Type.OBJECT.
description

string

Opcional. A descrição dos dados.
items

object (Schema)

Opcional. Esquema dos elementos de Type.ARRAY.
nullable

boolean

Opcional. Indica se o valor pode ser nulo.
uniqueItems

boolean

Opcional. Indica que os itens na matriz precisam ser exclusivos. Aplicável apenas a TYPE.ARRAY.
prefixItems[]

object (Schema)

Opcional. Esquemas dos elementos iniciais de Type.ARRAY.
additionalProperties

object (Schema)

Opcional. Pode ser um booleano ou um objeto e controla a presença de propriedades adicionais.
anyOf[]

object (Schema)

Opcional. O valor precisa ser validado em relação a qualquer um (um ou mais) dos subesquemas na lista.
enum[]

string

Opcional. Valores possíveis do elemento de tipo primitivo com formato de enumeração. Exemplos: 1. Podemos definir a direção como : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. Podemos definir o número do apartamento como : {type:INTEGER, format:enum, enum:["101", "201", "301"]}
default

value (Value format)

Opcional. Valor padrão dos dados.
ref

string

Opcional. Permite referências indiretas entre nós de esquema. O valor precisa ser uma referência válida a um filho do defs raiz.

Por exemplo, o esquema a seguir define uma referência a um nó de esquema chamado "Pet":

type: object
properties:
  pet:
    ref: #/defs/Pet
defs:
  Pet:
    type: object
    properties:
      name:
        type: string

O valor da propriedade "pet" é uma referência ao nó de esquema chamado "Pet". Confira detalhes em https://json-schema.org/understanding-json-schema/structuring (em inglês).
defs

map (key: string, value: object (Schema))

Opcional. Um mapa de definições para uso por ref. Permitido apenas na raiz do esquema.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
title

string

Opcional. O título do esquema.
minItems

string (int64 format)

Opcional. Número mínimo de elementos para Type.ARRAY.
maxItems

string (int64 format)

Opcional. Número máximo de elementos para Type.ARRAY.

Campo de união _minimum.

_minimum pode ser apenas de um dos tipos a seguir:
minimum

number

Opcional. Valor mínimo para Type.INTEGER e Type.NUMBER.

Campo de união _maximum.

_maximum pode ser apenas de um dos tipos a seguir:
maximum

number

Opcional. Valor máximo para Type.INTEGER e Type.NUMBER.

PropertiesEntry

Representação JSON 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
Campos
key

string
value

object (Schema)

Valor

Representação JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Campos
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir:
nullValue

null

Representa um valor nulo.
numberValue

number

Representa um valor double.
stringValue

string

Representa um valor de string.
boolValue

boolean

Representa um valor booleano.
structValue

object (Struct format)

Representa um valor estruturado.
listValue

array (ListValue format)

Representa um Value repetido.

Struct

Representação JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

map (key: string, value: value (Value format))

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

ListValue

Representação JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Campo repetido de valores digitados dinamicamente.

DefsEntry

Representação JSON 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
Campos
key

string
value

object (Schema)

DataStoreSettings

Representação JSON 
{
  "engines": [
    {
      object (Engine)
    }
  ]
}
Campos
engines[]

object (Engine)

Apenas saída. Os mecanismos do app.

Mecanismo

Representação JSON 
{
  "name": string,
  "type": enum (Type)
}
Campos
name

string

Apenas saída. O nome do recurso do mecanismo. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}
type

enum (Type)

Apenas saída. O tipo de motor.

ChannelProfile

Representação JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
Campos
profileId

string

Opcional. O identificador exclusivo do perfil do canal.
channelType

enum (ChannelType)

Opcional. O tipo do perfil do canal.
personaProperty

object (PersonaProperty)

Opcional. A propriedade de persona do perfil do canal.
disableDtmf

boolean

Opcional. Indica se o DTMF (multifrequência de dois tons) será desativado.
disableBargeInControl

boolean

Opcional. Se o controle de interrupção do usuário na conversa deve ser desativado. - true: as interrupções do usuário são desativadas enquanto o agente está falando. - false: o agente mantém o controle automático sobre quando o usuário pode interromper.
webWidgetConfig

object (WebWidgetConfig)

Opcional. A configuração do widget da Web.
noiseSuppressionLevel

string

Opcional. O nível de supressão de ruído do perfil do canal. Os valores disponíveis são "low", "moderate", "high", "very_high".

PersonaProperty

Representação JSON 
{
  "persona": enum (Persona)
}
Campos
persona

enum (Persona)

Opcional. A persona do canal.

WebWidgetConfig

Representação JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Campos
modality

enum (Modality)

Opcional. A modalidade do widget da Web.
theme

enum (Theme)

Opcional. O tema do widget da Web.
webWidgetTitle

string

Opcional. O título do widget da Web.
securitySettings

object (SecuritySettings)

Opcional. As configurações de segurança do widget da Web.

SecuritySettings

Representação JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Campos
enablePublicAccess

boolean

Opcional. Indica se o acesso público ao widget da Web está ativado. Se for true, o widget da Web será acessível publicamente. Se false, o widget da Web precisará ser integrado ao seu próprio sistema de autenticação e autorização para retornar credenciais válidas de acesso ao agente da CES.
enableOriginCheck

boolean

Opcional. Indica se a verificação de origem do widget da Web está ativada. Se true, o widget da Web vai verificar a origem do site que o carrega e permitir que ele seja carregado apenas na mesma origem ou em qualquer uma das origens permitidas.
allowedOrigins[]

string

Opcional. As origens que podem hospedar o widget da Web. Uma origem é definida pela RFC 6454. Se estiver vazio, todas as origens serão permitidas. São permitidas no máximo 100 origens. Exemplo: "https://example.com"
enableRecaptcha

boolean

Opcional. Indica se a verificação do reCAPTCHA para o widget da Web está ativada.

MetadataEntry

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

ClientCertificateSettings

Representação JSON 
{
  "tlsCertificate": string,
  "privateKey": string,
  "passphrase": string
}
Campos
tlsCertificate

string

Obrigatório. O certificado TLS codificado no formato PEM. Essa string precisa incluir as linhas de cabeçalho de início e rodapé de fim.
privateKey

string

Obrigatório. O nome do recurso de versão do secret do Secret Manager que armazena a chave privada codificada no formato PEM. Formato: projects/{project}/secrets/{secret}/versions/{version}
passphrase

string

Opcional. O nome do recurso da versão do secret do Secret Manager que armazena a senha longa para descriptografar a chave privada. Deve ser deixado sem definição se a chave privada não estiver criptografada. Formato: projects/{project}/secrets/{secret}/versions/{version}

Anotações de ferramentas

Dica destrutiva: ✅ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌