Definições do agente

Os agentes têm muitas definições que afetam o comportamento. Cada consola oferece definições diferentes.

Definições do agente da consola de agentes conversacionais

Para aceder às definições do agente:

Consola

  1. Abra a consola de agentes conversacionais.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Clique no ícone de definições no canto superior direito.
  5. Atualize as definições conforme pretendido.
  6. Clique em Guardar.

API

Consulte os métodos get e patch/update para o tipo Agent.

Selecione um protocolo e uma versão para a referência do agente:

Protocolo V3 V3beta1
REST Recurso do agente Recurso do agente
RPC Interface do agente Interface do agente
C++ AgentsClient Não disponível
C# AgentsClient Não disponível
Ir AgentsClient Não disponível
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP Não disponível Não disponível
Python AgentsClient AgentsClient
Ruby Não disponível Não disponível

As subsecções seguintes descrevem as diferentes categorias de definições do agente.

Definições gerais

As seguintes definições gerais estão disponíveis para os agentes:

  • Nome a apresentar

    Um nome legível para o seu agente.

  • Fuso horário

    O fuso horário predefinido do seu agente.

  • Início da conversa

    Esta definição determina se o seu agente inicia a conversa com um guião gerativo ou um fluxo determinístico.

  • Localização do agente

    A região do agente que selecionou quando criou o agente.

  • Bloqueio do agente

    • Bloquear o agente

      Indica se o agente está bloqueado. Não é possível editar um agente bloqueado.

  • Definições de registo

    • Ative o Cloud Logging

      Indica se o registo na nuvem está ativado para o agente.

    • Ative o histórico de conversas

      Indica se quer que a Google recolha e armazene consultas de utilizadores finais ocultadas para melhoria da qualidade.

    • Ative a ocultação da entrada do utilizador final com base no consentimento

      Se esta definição estiver ativada, permite-lhe usar um parâmetro de sessão especial para controlar se a entrada e os parâmetros do utilizador final são ocultados do histórico de conversas e do Cloud Logging. Por predefinição, o parâmetro de sessão é true. Se esta definição estiver desativada, não ocorre nenhuma ocultação.

      O consentimento do utilizador é recolhido através de um parâmetro de sessão booleano: $session.params.conversation-redaction. Se esta definição estiver ativada e o parâmetro de sessão estiver definido como false, não ocorre nenhuma ocultação (outras estratégias de ocultação continuam a aplicar-se). Se esta definição estiver ativada e o parâmetro de sessão estiver definido como true, ocorre a ocultação.

      Um exemplo de fluxo de pedido de consentimento pode ser: primeiro, perguntar ao utilizador se quer manter a entrada do utilizador final e fazer corresponder a resposta a duas intenções, uma é "intenção sim" e a outra é "intenção não". Em seguida, defina o parâmetro de sessão como false (sem ocultação) nas predefinições de parâmetros do caminho "yes intent" no preenchimento e como true (ocultação) na predefinição de parâmetros do caminho "no intent".

  • BigQuery Export

    • Ative o BigQuery Export

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

    • Conjunto de dados do BigQuery

      O nome do conjunto de dados do BigQuery.

    • Tabela do BigQuery

      O nome da tabela do BigQuery.

  • Sugestões de intenções

    Pode ativar as sugestões de intenções.

  • Feedback dos utilizadores

    Pode ativar esta definição para enviar feedback sobre a qualidade das respostas do agente, incluindo um gosto/não gosto.

  • Integração do Git

    Use esta definição para adicionar uma integração do Git.

Definições de IA generativa

Estão disponíveis as seguintes definições de IA generativa:

  • Geral

    • Seleção do modelo generativo

      Selecione o modelo usado pelas funcionalidades generativas. Para mais informações, consulte o artigo Versões do modelo.

    • Limites de tokens

      • Limite de tokens de entrada

        Selecione o limite de tokens de entrada para o modelo generativo. Este é o tamanho máximo de tokens para a entrada enviada ao modelo. Consoante o modelo, um token pode ter entre um caráter e uma palavra. Os limites de tokens mais pequenos têm uma latência mais baixa, mas o tamanho da entrada do modelo é limitado. Os limites de tokens maiores têm uma latência mais elevada, mas o tamanho da entrada do modelo pode ser maior.

      • Limite de tokens de saída

        Selecione o limite de tokens de saída para o modelo generativo. Este é o tamanho máximo de tokens para a saída recebida do modelo. Consoante o modelo, um token pode ter entre um caráter e uma palavra. Os limites de tokens mais pequenos têm uma latência mais baixa, mas o tamanho da saída do modelo é limitado. Os limites de tokens mais elevados têm uma latência mais elevada, mas o tamanho da saída do modelo pode ser maior.

    • Temperatura

      A temperatura de um MDI/CE permite-lhe controlar o nível de criatividade das respostas. Um valor baixo oferece respostas mais previsíveis. Um valor elevado oferece respostas mais criativas ou aleatórias.

    • Limites de tokens de contexto

      A definição seleciona algumas interações anteriores do comando do MDG para evitar que o tamanho do comando aumente com cada interação sequencial processada pelo agente. Esta funcionalidade oferece uma forma de mitigar o crescimento indesejado do tamanho dos comandos.

      Normalmente, sem o corte, cada interação subsequente é anexada ao "histórico de conversas" do comando do MDG, independentemente de ser relevante para a interação atual. Isto pode, em última análise, fazer com que o comando aumente de tamanho a cada curva. À medida que o histórico de conversas ocupa mais espaço no comando, menos espaço fica disponível para exemplos de poucos disparos (por isso, estes podem ser ignorados). Eventualmente, o comando também pode ultrapassar os limites de tokens atuais. Pode aumentar os tamanhos dos tokens para acomodar esta situação, mas tenha em atenção que os tamanhos dos comandos aumentados também contribuem para a latência de resposta do MDG.

      A truncagem de contexto permite-lhe definir uma percentagem do orçamento de tokens a reservar para o histórico de conversas, como máximo. As interações da conversa são preservadas por ordem do mais recente para o menos recente. Esta definição pode ajudar a evitar que os limites de tokens sejam excedidos. Independentemente da definição que escolher, são preservadas, no mínimo, duas interações de conversa, da mais recente para a menos recente.

      Primeiro, tem de definir um limite de tokens antes de poder modificar esta definição.

      A truncagem do contexto pode fazer com que alguns parâmetros sejam perdidos inadvertidamente se fizerem parte de turnos eliminados. Avalie cuidadosamente as interações do manual de soluções depois de ativar esta opção.

      O orçamento de entrada de tokens também é usado pelo seguinte:

      • Instruções e exemplos do sistema: adicionados automaticamente ao comando. Não é possível modificar este comportamento.
      • Instruções e objetivos do manual: todas as instruções e objetivos que escrever são adicionados ao comando na íntegra.
      • Exemplos de poucos lançamentos do manual de soluções: são adicionados por ordem (por predefinição) ou por um algoritmo à sua escolha (como a ordenação por melhor correspondência de expressão regular). Os exemplos são selecionados para se ajustarem ao orçamento de tokens de entrada depois de todos os outros itens serem incluídos.
      • Histórico de conversas composto por expressões do utilizador e do agente, contexto de transição do fluxo e do manual de soluções, chamadas de ferramentas e resultados na mesma sessão de todas as fases anteriores processadas sequencialmente pelo manual de soluções atual.
    • Expressões proibidas

      Lista de expressões proibidas para a IA generativa. Se uma expressão proibida aparecer no comando ou na resposta gerada, a geração falha. Tenha em atenção que a lista de expressões proibidas tem consequências em todas as consultas e chamadas de MDIs e aumenta a latência.

    • Filtros de segurança

      Configure os níveis de sensibilidade dos filtros de segurança relativamente a diferentes categorias de IA responsável (RAI). O conteúdo é avaliado com base nas seguintes quatro categorias:

      Categoria Descrição
      Incitamento ao ódio Comentários negativos ou prejudiciais que visam a identidade e/ou atributos protegidos.
      Conteúdo perigoso Promove ou permite o acesso a bens, serviços e/ou atividades prejudiciais
      Conteúdo sexualmente explícito Contém referências a atos sexuais e/ou outro conteúdo lascivo
      Assédio Comentários maliciosos, intimidantes, de bullying e/ou abusivos dirigidos a outro indivíduo

      O conteúdo é bloqueado com base na probabilidade de ser prejudicial. Pode personalizar o nível de sensibilidade escolhendo uma das opções Não bloquear, Bloquear alguns, Bloquear alguns e Bloquear a maioria para cada categoria.

      Para mais informações, consulte o artigo sobre como configurar atributos de segurança.

    • Segurança dos comandos

      Pode selecionar a definição ativar verificação de segurança de comandos para ativar as verificações de segurança de comandos. Quando ativado, o agente rejeita consultas de utilizadores que acionam o filtro de segurança, incluindo ataques de injeção de comandos. Estes ataques podem ser usados para revelar partes do comando do agente ou para fornecer respostas que o agente não deve fornecer. Isto é conseguido através do envio de um comando de MDG adicional que verifica se a consulta do utilizador é possivelmente maliciosa. Quando estiver ativado, pode fornecer as seguintes opções:

      • Definições de segurança dos comandos: Pode selecionar Predefinição para as definições de segurança predefinidas ou Personalizar para esclarecer que consultas do utilizador devem ser consideradas seguras ou não seguras.
      • Selecionar modelo generativo: Isto controla o MDG usado para a classificação. Se selecionar Predefinição (recomendado), é escolhido um modelo predefinido para si, que pode mudar automaticamente à medida que são disponibilizados modelos mais recentes e melhorados.
      • Comando de segurança: Pode selecionar Predefinição para um comando de segurança predefinido ou Personalizar para fornecer instruções que ajudam na classificação de consultas de utilizadores maliciosas. Se selecionar Predefinição, o comando pode ser atualizado automaticamente para melhorias.
      • Limite de entrada: O comprimento mínimo de carateres para uma consulta do utilizador antes de serem aplicadas verificações de segurança. As consultas pequenas são mais ambíguas e podem ser classificadas incorretamente. Todas as consultas inferiores ao limite de entrada são tratadas como inerentemente seguras.
    • Alternativa generativa

  • Armazenamento de dados

    Consulte o artigo Definições do agente de armazenamento de dados.

Fluxos determinísticos

Estas definições aplicam-se a todos os fluxos neste agente, exceto às definições de ML, que são aplicadas por fluxo. Para editar outras definições específicas do fluxo, navegue para o fluxo na consola e edite as definições aí.

  • Preparação de intenções

    Os fluxos usam algoritmos de aprendizagem automática (AA) para compreender as entradas do utilizador final, associá-las a intenções e extrair dados estruturados. Os fluxos aprendem com as expressões de preparação que fornece e os modelos de linguagem incorporados nos fluxos. Com base nestes dados, cria um modelo para tomar decisões sobre que intenção deve ser associada a uma entrada do utilizador final. Pode aplicar definições de ML únicas a cada fluxo de um agente.

    Estão disponíveis as seguintes definições de preparação de intenções:

    • Correção ortográfica

      Se esta opção estiver ativada e a entrada do utilizador final tiver um erro de ortografia ou gramática, é estabelecida uma correspondência com uma intenção como se estivesse escrita corretamente. A resposta detectIntent contém a entrada do utilizador final corrigida. Por exemplo, se um utilizador final introduzir "Quero uma maçã", o texto é processado como se o utilizador final tivesse introduzido "Quero uma maçã". Isto também se aplica a correspondências que envolvem entidades do sistema e personalizadas.

      A correção ortográfica está disponível em alemão, espanhol, francês, inglês e italiano. Está disponível em todas as regiões de agentes conversacionais (Dialogflow CX).

      Avisos e práticas recomendadas:

      • A correção ortográfica não consegue corrigir erros de ASR (reconhecimento de voz automático), pelo que não recomendamos a sua ativação para agentes que usam entradas de ASR.
      • É possível que a entrada corrigida corresponda à intenção errada. Pode corrigir este problema adicionando expressões com erros comuns a exemplos negativos.
      • A correção ortográfica aumenta ligeiramente o tempo de resposta do agente.
      • Se um agente for definido com jargão específico do domínio, as correções podem ser indesejáveis.
    • Definições de ML específicas do fluxo

      • Tipo de NLU

        Pode ser uma das seguintes opções:

      • Formação automática

        Se estiver ativado, o fluxo é preparado sempre que é atualizado com a consola. Para fluxos grandes, isto pode causar atrasos na IU da consola, pelo que deve desativar esta definição e formar manualmente conforme necessário para fluxos grandes.

      • Limite de classificação

        Para filtrar resultados falsos positivos e continuar a ter variedade nas entradas de linguagem natural correspondentes para o seu agente, pode ajustar o limite de classificação de aprendizagem automática. Esta definição controla a confiança mínima de deteção de intenções necessária para uma correspondência de intenções.

        Se a pontuação de confiança de uma correspondência de intenção for inferior ao valor do limite, é invocado um evento de não correspondência.

        Pode definir um valor de limite de classificação separado para cada fluxo em cada idioma ativado para o agente. Isto destina-se a acomodar diferentes idiomas com o melhor desempenho em diferentes limites de classificação. Para mais informações sobre como criar um agente multilingue, consulte a documentação sobre agentes multilingues.

      • Estado da preparação

        Indica se o fluxo foi preparado desde a última atualização dos dados do fluxo.

      • Comboio

        Use este botão para formar manualmente o fluxo.

    • Idioma

      Os idiomas suportados pelo seu agente. Depois de criar um agente, não é possível alterar o idioma predefinido. No entanto, pode fazer o seguinte:

      1. Exporte o seu agente para o formato JSON.
      2. Extraia o ficheiro transferido.
      3. Encontre o ficheiro agent.json.
      4. Atualize os campos defaultLanguageCode e supportedLanguageCodes para os valores pretendidos.
      5. Restaurar o agente para o mesmo agente ou um agente diferente do passo 1.
      6. Atualize as expressões de preparação e os valores de entidades específicos do idioma, conforme necessário.

      Também pode ativar a deteção automática e a mudança de idioma.

Conetividade

  • Modelo de payload personalizado

    Nesta secção, pode criar descrições e payloads para modelos de payloads personalizados.

  • Definição de parâmetros

    Indique claramente que parâmetros dos parâmetros de sessão serão enviados para o webhook e que parâmetros de sessão podem ser definidos pela resposta do webhook.

  • Definições de certificado de cliente

    Usado para carregar certificados SSL.

Voz e IVR

  • Opções de voz

    • Conversão de texto em voz

      • Seleção da voz

        Pode selecionar o idioma e a voz usados para a síntese de voz.

        Pode ativar a voz personalizada para o seu agente selecionando a opção de voz personalizada na caixa de menu pendente de seleção de voz e especificando o nome da voz personalizada no campo correspondente. O nome da voz personalizada tem de seguir o seguinte padrão: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME.

        Também pode usar a clonagem de voz.

        • Se estiver a usar o gateway de telefonia, certifique-se de que a conta de serviço do agente do serviço Dialogflow service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com tem a autorização "AutoML Predictor" no seu projeto de voz personalizado.
        • Para chamadas API normais, certifique-se de que a conta de serviço usada para chamar os agentes conversacionais (Dialogflow CX) tem a função "AutoML Predictor" concedida no seu projeto de voz personalizado.
      • Tom de voz

        Controla a altura relativa da voz.

      • Velocidade da fala

        Controla a velocidade de fala da voz.

      • Pronúncia

        Use estas definições para fornecer ao agente a pronúncia de determinadas expressões, através da codificação fonética X-SAMPA.

    • Conversão de voz em texto

  • Call companion

    Consulte o artigo A app Telefone no seu Pixel.

Definições da IU

Pode usar estas definições para personalizar as interfaces do utilizador do Messenger e da app Chamadas.

Segurança

Consulte as Definições de segurança e Controlo de acesso.

Definições do agente da consola do Dialogflow CX

Para aceder às definições do agente:

Consola

  1. Abra a consola.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Clique em Definições do agente.
  5. Atualize as definições conforme pretendido.
  6. Clique em Guardar.

API

Consulte os métodos get e patch/update para o tipo Agent.

Selecione um protocolo e uma versão para a referência do agente:

Protocolo V3 V3beta1
REST Recurso do agente Recurso do agente
RPC Interface do agente Interface do agente
C++ AgentsClient Não disponível
C# AgentsClient Não disponível
Ir AgentsClient Não disponível
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP Não disponível Não disponível
Python AgentsClient AgentsClient
Ruby Não disponível Não disponível

Definições gerais

As seguintes definições gerais estão disponíveis para os agentes:

  • Nome a apresentar

    Um nome legível para o seu agente.

  • Fuso horário

    O fuso horário predefinido do seu agente.

  • Idioma predefinido

    O idioma predefinido suportado pelo seu agente. Depois de criar um agente, não é possível alterar o idioma predefinido. No entanto, pode fazer o seguinte:

    1. Exporte o seu agente para o formato JSON.
    2. Descomprima o ficheiro transferido.
    3. Encontre o ficheiro agent.json.
    4. Atualize os campos defaultLanguageCode e supportedLanguageCodes para os valores pretendidos.
    5. Restaurar o agente para o mesmo agente ou um agente diferente do passo 1.
    6. Atualize as expressões de preparação e os valores de entidades específicos do idioma, conforme necessário.
  • Bloqueio do agente

    • Bloquear o agente

      Indica se o agente está bloqueado. Não é possível editar um agente bloqueado.

  • Definições de registo

    • Ative o Cloud Logging

      Indica se o registo na nuvem está ativado para o agente.

    • Ative o registo de interações

      Indica se quer que a Google recolha e armazene consultas de utilizadores finais ocultadas para melhoria da qualidade.

    • Ative a ocultação da entrada do utilizador final com base no consentimento

      Se esta definição estiver ativada, permite-lhe usar um parâmetro de sessão especial para controlar se a entrada e os parâmetros do utilizador final são ocultados do histórico de conversas e do Registo na nuvem. Por predefinição, o parâmetro de sessão é true. Se esta definição estiver desativada, não ocorre nenhuma ocultação.

      O consentimento do utilizador é recolhido através de um parâmetro de sessão booleano: $session.params.conversation-redaction. Se esta definição estiver ativada e o parâmetro de sessão estiver definido como false, não ocorre nenhuma ocultação (outras estratégias de ocultação continuam a aplicar-se). Se esta definição estiver ativada e o parâmetro de sessão estiver definido como true, ocorre a ocultação.

      Um exemplo de fluxo de pedido de consentimento pode ser: primeiro, perguntar ao utilizador se quer manter a entrada do utilizador final e fazer corresponder a resposta a duas intenções, uma é "intenção sim" e a outra é "intenção não". Em seguida, defina o parâmetro de sessão como false (sem ocultação) nas predefinições de parâmetros do caminho "yes intent" no preenchimento e como true (ocultação) na predefinição de parâmetros do caminho "no intent".

  • BigQuery Export

    • Ative o BigQuery Export

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

    • Conjunto de dados do BigQuery

      O nome do conjunto de dados do BigQuery.

    • Tabela do BigQuery

      O nome da tabela do BigQuery.

  • Sugestões de intenções

    Pode ativar as sugestões de intenções.

  • Modelo de payload personalizado

    Nesta secção, pode criar descrições e payloads para modelos de payloads personalizados.

Definições de AA

Os agentes conversacionais (Dialogflow CX) usam algoritmos de aprendizagem automática para compreender as entradas do utilizador final, associá-las a intenções e extrair dados estruturados. Os agentes de conversação (Dialogflow CX) aprendem com as expressões de preparação que fornece e os modelos de linguagem incorporados nos agentes de conversação (Dialogflow CX). Com base nestes dados, cria um modelo para tomar decisões sobre que intenção deve ser associada a uma entrada do utilizador final. Pode aplicar definições de ML únicas para cada fluxo de um agente e o modelo criado pelos agentes conversacionais (Dialogflow CX) é único para cada fluxo.

Estão disponíveis as seguintes definições de ML ao nível do agente:

  • Permita que a AA corrija a ortografia

    Se esta opção estiver ativada e a entrada do utilizador final tiver um erro de ortografia ou gramática, é estabelecida uma correspondência com uma intenção como se estivesse escrita corretamente. A resposta detectIntent contém a entrada do utilizador final corrigida. Por exemplo, se um utilizador final introduzir "Quero uma maçã", o texto é processado como se o utilizador final tivesse introduzido "Quero uma maçã". Isto também se aplica a correspondências que envolvem entidades do sistema e personalizadas.

    A correção ortográfica está disponível em alemão, espanhol, francês, inglês e italiano. Está disponível em todas as regiões de agentes conversacionais (Dialogflow CX).

    Avisos e práticas recomendadas:

    • A correção ortográfica não consegue corrigir erros de ASR (reconhecimento de voz automático), pelo que não recomendamos a sua ativação para agentes que usam entradas de ASR.
    • É possível que a entrada corrigida corresponda à intenção errada. Pode corrigir este problema adicionando expressões com erros comuns a exemplos negativos.
    • A correção ortográfica aumenta ligeiramente o tempo de resposta do agente.
    • Se um agente for definido com jargão específico do domínio, as correções podem ser indesejáveis.

Estão disponíveis as seguintes definições de ML específicas do fluxo:

  • Tipo de NLU

    Pode ser uma das seguintes opções:

  • Preparação automática

    Se estiver ativado, o fluxo é preparado sempre que é atualizado com a consola. Para fluxos grandes, isto pode causar atrasos na IU da consola, pelo que deve desativar esta definição e formar manualmente conforme necessário para fluxos grandes.

  • Limite de classificação

    Para filtrar resultados falsos positivos e continuar a ter variedade nas entradas de linguagem natural correspondentes para o seu agente, pode ajustar o limite de classificação de aprendizagem automática. Esta definição controla a confiança mínima de deteção de intenções necessária para uma correspondência de intenções.

    Se a pontuação de confiança de uma correspondência de intenção for inferior ao valor do limite, é invocado um evento de não correspondência.

    Pode definir um valor de limite de classificação separado para cada fluxo em cada idioma ativado para o agente. Isto destina-se a acomodar diferentes idiomas com o melhor desempenho em diferentes limites de classificação. Para mais informações sobre como criar um agente multilingue, consulte a documentação sobre agentes multilingues.

  • Estado da formação

    Indica se o fluxo foi preparado desde a última atualização dos dados do fluxo.

  • Treinar PNL

    Use este botão para formar manualmente o fluxo.

Definições de IA generativa

Estão disponíveis as seguintes definições de IA generativa:

  • Geral

    • Expressões proibidas

      Lista de expressões proibidas para a IA generativa. Se uma expressão proibida aparecer no comando ou na resposta gerada, a geração falha.

    • Filtros de segurança

      Configure os níveis de sensibilidade dos filtros de segurança relativamente a diferentes categorias de IA responsável (RAI). O conteúdo é avaliado com base nas seguintes quatro categorias:

      Categoria Descrição
      Incitamento ao ódio Comentários negativos ou prejudiciais que visam a identidade e/ou atributos protegidos.
      Conteúdo perigoso Promove ou permite o acesso a bens, serviços e atividades prejudiciais
      Conteúdo sexualmente explícito Contém referências a atos sexuais ou outro conteúdo lascivo
      Assédio Comentários maliciosos, intimidantes, de bullying ou abusivos dirigidos a outro indivíduo

      O conteúdo é bloqueado com base na probabilidade de ser prejudicial. Pode personalizar o nível de sensibilidade escolhendo uma das opções Não bloquear, Bloquear poucos, Bloquear alguns e Bloquear a maioria para cada categoria.

      Para mais informações, consulte o artigo sobre como configurar atributos de segurança.

    • Segurança dos comandos

      Pode selecionar a definição ativar verificação de segurança de comandos para ativar as verificações de segurança de comandos. Quando ativado, o agente tenta impedir ataques de injeção de comandos. Estes ataques podem ser usados para revelar partes do comando do agente ou para fornecer respostas que o agente não deve fornecer. Isto é conseguido através do envio de um comando de MDG adicional que verifica se a consulta do utilizador é possivelmente maliciosa.

  • Agente generativo

    • Seleção do modelo generativo

      Selecione o modelo usado pelas funcionalidades generativas. Para mais informações, consulte o artigo Versões do modelo.

    • Redução do contexto do guia interativo

      A truncagem do contexto do guia interativo elimina algumas interações anteriores do comando do guia interativo para evitar que o tamanho do comando aumente com cada interação sequencial processada pelo guia interativo. Esta funcionalidade oferece uma forma de mitigar o crescimento indesejado do tamanho dos comandos.

      Normalmente, sem o corte, cada interação subsequente é anexada ao "histórico de conversas" do comando do MDG, independentemente de ser relevante para a interação atual. Isto pode, em última análise, fazer com que o comando aumente de tamanho a cada curva. À medida que o histórico de conversas ocupa mais espaço no comando, menos espaço fica disponível para exemplos de poucos disparos (por isso, estes podem ser ignorados). Eventualmente, o comando também pode ultrapassar os limites de tokens atuais. Pode aumentar os tamanhos dos tokens para acomodar esta situação, mas tenha em atenção que os tamanhos dos comandos aumentados também contribuem para a latência de resposta do MDG.

      A truncagem do contexto do livro de regras permite-lhe definir uma percentagem do orçamento de tokens a reservar para o histórico de conversas, como máximo. As interações da conversa são preservadas por ordem do mais recente para o menos recente. Esta definição pode ajudar a evitar que os limites de tokens sejam excedidos. Independentemente da definição que escolher, são preservadas, no mínimo, duas interações de conversa, da mais recente para a menos recente.

      Primeiro, tem de definir um limite de tokens antes de poder modificar esta definição.

      Importante: a truncagem do contexto pode fazer com que alguns parâmetros sejam perdidos inadvertidamente se fizerem parte de turnos eliminados. Avalie cuidadosamente as interações do manual de soluções depois de ativar esta opção.

      O orçamento de entrada de tokens também é usado pelo seguinte:

      • Instruções e exemplos do sistema: adicionados automaticamente ao comando. Não é possível modificar este comportamento.
      • Instruções e objetivos do manual: todas as instruções e objetivos que escrever são adicionados ao comando na íntegra.
      • Exemplos de poucos lançamentos do manual de soluções: são adicionados por ordem (por predefinição) ou por um algoritmo à sua escolha (como a ordenação por melhor correspondência de expressão regular). Os exemplos são selecionados para se ajustarem ao orçamento de tokens de entrada depois de todos os outros itens serem incluídos.
      • Histórico de conversas composto por expressões do utilizador e do agente, contexto de transição do fluxo e do manual de soluções, chamadas de ferramentas e resultados na mesma sessão de todas as fases anteriores processadas sequencialmente pelo manual de soluções atual.
  • Alternativa generativa

  • Armazenamento de dados

    Consulte o artigo Definições do agente de armazenamento de dados.

Definições de voz e IVR

Estão disponíveis as seguintes definições de voz e IVR:

  • Conversão de texto em voz

    • Seleção da voz

      Pode selecionar o idioma e a voz usados para a síntese de voz.

      Pode ativar a voz personalizada para o seu agente selecionando a opção de voz personalizada na caixa de menu pendente de seleção de voz e especificando o nome da voz personalizada no campo correspondente. O nome da voz personalizada tem de seguir o seguinte padrão: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME.

      • Se estiver a usar o gateway de telefonia, certifique-se de que a conta de serviço do agente do serviço Dialogflow service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com tem a autorização "AutoML Predictor" no seu projeto de voz personalizado.
      • Para chamadas API normais, certifique-se de que a conta de serviço usada para chamar os agentes conversacionais (Dialogflow CX) tem a função "AutoML Predictor" concedida no seu projeto de voz personalizado.
  • Conversão de voz em texto

DTMF

Consulte DTMF para integrações de telefonia para mais informações.

Multimodal

Consulte o artigo A app Telefone no seu Pixel.

Partilhe as definições

Consulte Controlo de acesso.

Definições de idiomas

Adicione compatibilidade com idiomas adicionais ao seu agente. Para ver a lista completa de idiomas, consulte a referência de idiomas.

Deteção automática de idioma

Quando configura a deteção automática de idiomas, o seu agente de chat deteta automaticamente o idioma do utilizador final e muda para esse idioma. Consulte a documentação sobre a deteção automática de idiomas para ver detalhes.

Definições de segurança

Consulte as Definições de segurança.

Definições avançadas

Atualmente, a única definição avançada é para a análise de sentimentos.

Definições da consola do Vertex AI Agent Builder

Esta secção descreve as definições disponíveis para apps de agente.

Geral

As seguintes definições gerais estão disponíveis para apps de agente:

  • Nome a apresentar

    Um nome legível para a sua app de agente.

  • Localização

    A região da app de agente.

  • Bloqueio de apps

    Se estiver ativada, não são permitidas alterações à app de agente.

Registo

As seguintes definições de registo estão disponíveis para apps de agente:

  • Ative o Cloud Logging

    Se estiver ativada, os registos são enviados para o Cloud Logging.

  • Ative o histórico de conversas

    Se estiver ativado, o histórico de conversas fica disponível. Indica se quer que a Google recolha e armazene consultas de utilizadores finais ocultadas para melhoria da qualidade. Esta definição não afeta a utilização do histórico de conversas para gerar respostas do agente.

  • Ative o BigQuery Export

    Se estiver ativada, o histórico de conversas é exportado para o BigQuery. A definição Ativar histórico de conversas também tem de estar ativada.

IAgen

As seguintes definições de IA generativa estão disponíveis para apps de agente:

  • Seleção do modelo generativo

    Selecione o modelo generativo que os agentes devem usar por predefinição.

  • Limite de tokens de entrada

    Selecione o limite de tokens de entrada para o modelo generativo. Este é o tamanho máximo de tokens para a entrada enviada ao modelo. Consoante o modelo, um token pode ter entre um caráter e uma palavra. Os limites de tokens mais pequenos têm uma latência mais baixa, mas o tamanho da entrada do modelo é limitado. Os limites de tokens maiores têm uma latência mais elevada, mas o tamanho da entrada do modelo pode ser maior.

  • Limite de tokens de saída

    Selecione o limite de tokens de saída para o modelo generativo. Este é o tamanho máximo de tokens para a saída recebida do modelo. Consoante o modelo, um token pode ter entre um caráter e uma palavra. Os limites de tokens mais pequenos têm uma latência mais baixa, mas o tamanho da saída do modelo é limitado. Os limites de tokens mais elevados têm uma latência mais elevada, mas o tamanho da saída do modelo pode ser maior.

  • Temperatura

    A temperatura de um MDI/CE permite-lhe controlar o nível de criatividade das respostas. Um valor baixo oferece respostas mais previsíveis. Um valor elevado oferece respostas mais criativas ou aleatórias.

  • Expressões proibidas

    Lista de expressões proibidas para a IA generativa. Se uma expressão proibida aparecer no comando ou na resposta gerada, o agente devolve uma resposta alternativa.

  • Filtros de segurança

    Configure os níveis de sensibilidade dos filtros de segurança relativamente a diferentes categorias de IA responsável (RAI). O conteúdo é avaliado com base nas seguintes quatro categorias:

    Categoria Descrição
    Incitamento ao ódio Comentários negativos ou prejudiciais que visam a identidade e/ou atributos protegidos.
    Conteúdo perigoso Promove ou permite o acesso a bens, serviços e atividades prejudiciais
    Conteúdo sexualmente explícito Contém referências a atos sexuais ou outro conteúdo lascivo
    Assédio Comentários maliciosos, intimidantes, de bullying ou abusivos dirigidos a outro indivíduo

    O conteúdo é bloqueado com base na probabilidade de ser prejudicial. O nível de sensibilidade pode ser personalizado escolhendo uma das seguintes opções para cada categoria: Não bloquear nada (desativar as verificações de RAI), Bloquear poucos (bloquear apenas instâncias de alta probabilidade de conteúdo prejudicial), Bloquear alguns (instâncias de probabilidade média e alta) e Bloquear a maioria (probabilidade baixa, média e alta).

    Para mais informações, consulte o artigo sobre como configurar atributos de segurança.

  • Segurança dos comandos

    Pode selecionar a definição ativar verificação de segurança de comandos para ativar as verificações de segurança de comandos. Quando ativada, o agente tenta impedir ataques de injeção de comandos. Estes ataques podem ser usados para revelar partes do comando do agente ou para fornecer respostas que o agente não deve fornecer. Isto é conseguido através do envio de um comando de MDG adicional que verifica se a consulta do utilizador é possivelmente maliciosa.

Git

Estas definições oferecem uma integração do Git. Siga as instruções para configurar a integração.