Configurações do agente

Nesta página, descreveremos as várias configurações possíveis de aplicar a um agente. Para acessá-las:

1. Acesse o console do Dialogflow ES.
2. selecione seu agente próximo à parte superior do menu da barra lateral à esquerda;
3. clique no botão de configurações ao lado do nome do agente.

Observação: se você estiver trabalhando em uma tela pequena e o menu da barra lateral estiver oculto, clique no botão no canto superior esquerdo.

Edição do agente

O padrão para os agentes é Dialogflow Trial Edition. Para alterar a edição de um agente:

Console

Observação: só proprietários de projetos podem alterar a edição de um agente no Console do Dialogflow.

1. Role até a parte inferior do menu da barra lateral esquerda, onde a edição do agente é exibida
2. Clique no link Editar ou Fazer upgrade.
3. Selecione um plano.

API

Chame o método setAgent para o recurso Projetos. Forneça "TIER_ENTERPRISE" ao campo tier para fazer upgrade para a edição do Dialogflow Essentials ou "TIER_STANDARD" para reverter para a edição da avaliação do Dialogflow.

Observação: a permissão mínima para usar esse método é dialogflow.agents.create.

Se você usar vários projetos, o projeto do consumidor será usado para determinar a edição de cotas e cobranças.

Geral

Para acessar as configurações gerais, clique na guia General.

As seguintes configurações estão disponíveis:

• Description: descrição do agente.
• Default Time Zone: fuso horário padrão do agente. As solicitações de data e hora são resolvidas usando esse fuso horário se o fuso horário não for fornecido nas solicitações da API.
• URI do avatar do agente: um URI para o avatar do seu agente usado por algumas integrações.
• Projeto do Google: projeto do GCP vinculado ao agente.
• Versão do protocolo do webhook do agente: visível apenas nos agentes da API V1 legada. Permite alternar para o formato webhook da API V2.
• Recursos Beta: alterne para ativar os recursos Beta do agente.

• Configurações de registro:

  • Registrar interações no Dialogflow:

    Observação: para acessar ou mudar essa configuração com o console, é necessário ter a função de proprietário do projeto do IAM. Para ler ou mudar essa configuração com a API, é necessário ter um dos seguintes papéis: administrador da API Dialogflow do IAM, editor do IAM ou proprietário do IAM; ou um papel personalizado com a permissão dialogflow.agents.create.

    Indica se o registro de interações está ativado para o agente.

  • Registrar interações no Google Cloud:

    Observação: para acessar ou mudar essa configuração com o console, é necessário ter a função de proprietário do projeto do IAM. Essa configuração não está disponível na API.

    Indica se o Cloud Logging está ativado para o agente. Essa opção só estará disponível se a opção Registrar interações no Dialogflow estiver ativada. A desativação da geração de registros do Dialogflow também desativa essa configuração. Também é possível clicar no link Abrir registros para abrir os registros do agente no Cloud Logging.

• Delete Agent: exclui completamente o agente. Isso não pode ser desfeito. Se o agente estiver compartilhado com outros usuários, é necessário removê-los do agente antes da exclusão. Consulte Gerenciamento de agentes.

Idiomas

Para acessar as configurações de idioma, clique na guia Language.

É possível definir o idioma padrão e vários idiomas adicionais. Para alguns idiomas raiz, também é possível adicionar uma ou mais localidades. Para mais informações, consulte Agentes multilíngues.

Configurações de machine learning (ML)

Para acessar as configurações de machine learning, clique na guia Configurações de ML.

Os agentes do Dialogflow usam algoritmos de machine learning para entender expressões de usuários finais, combiná-las com intents e extrair dados estruturados. Um agente aprende com frases de treinamento fornecidas por você e com os modelos de linguagem incorporados ao Dialogflow. Com base nesses dados, ele cria um modelo para tomar decisões sobre qual intent deve ser combinada com uma expressão do usuário final. Esse modelo é exclusivo para seu agente.

Por padrão, o Dialogflow atualiza o modelo de machine learning do agente sempre que você faz alterações em intents e entidades, importa, restaura ou treina um agente.

As seguintes configurações estão disponíveis:

• Limiar de classificação de ML: para remover do filtro os resultados de falsos positivos e extrair uma variedade de entradas de linguagem natural correspondentes para o agente, ajuste o limiar de classificação de machine learning. Essa configuração controla a confiança de detecção de intent mínima necessária para uma correspondência de intent.

  Observação: antes de ajustar esse valor, tente adicionar exemplos negativos.

• Correção ortográfica automática:

  Se esse recurso estiver ativado, e a entrada do usuário tiver um erro ortográfico ou gramatical, uma intent será escolhida como se a entrada estivesse correta. A resposta do intent de detecção conterá a entrada de usuário corrigida. Por exemplo, se um usuário digitar "Quero uma mçã", a frase será processada como se o usuário tivesse digitado "Quero uma maçã". Isso também se aplica a correspondências que envolvem entidades do sistema e personalizadas.

  A correção ortográfica está disponível para todos os idiomas aceitos no Dialogflow.

  Observação: se a entrada original e corrigida do usuário corresponderem a intents diferentes, será selecionada aquela que corresponde à entrada original do usuário.

  Avisos e práticas recomendadas:

  • A correção ortográfica não corrige erros de reconhecimento de fala automático (ASR, na sigla em inglês). Portanto, não recomendamos ativá-la para agentes que usam entradas de ASR.
  • É possível que a entrada corrigida corresponda à intent errada. Isso pode ser corrigido com a inclusão de frases normalmente divergentes em exemplos negativos.
  • A correção ortográfica aumenta um pouco o tempo de resposta do agente.
  • A correção ortográfica não deve ser usada com o Actions on Google.
  • A correção ortográfica é treinada em consultas gerais do usuário. Se um agente for definido usando jargão específico do domínio, as correções poderão ser indesejadas.

• Treinamento automático: ative ou desative o treinamento automático sempre que o agente for modificado.

  Observação: depois de restaurar ou importar, o agente é treinado novamente, mesmo que o treinamento automático esteja desativado.

• Validação de agente: consulte o guia de validação de agente.

Exportar e importar

Observação: os tipos de agente do Dialogflow ES e do Dialogflow CX são incompatíveis. Não é possível importar um agente incompatível.

Para acessar as configurações de exportação e importação, clique na guia Exportar e Importar.

Esse recurso permite exportar/importar um agente para/de um arquivo zip para fazer backup de agentes ou transferi-los de uma conta para outra. É possível editar os arquivos JSON diretamente e importá-los novamente, mas a edição precisa ser feita no console ou na API do Dialogflow. Isso garante que as alterações sejam validadas pelo sistema e a solução de problemas seja mínima.

As seguintes opções estão disponíveis:

• Exportar como ZIP: exporta o agente como um arquivo zip.
• Restaurar do ZIP: substitui o agente atual pelo arquivo zip fornecido.
• Importar do ZIP: adiciona intents e entidades ao agente atual a partir do arquivo zip fornecido. Se alguma intent ou entidade tiver o mesmo nome que o arquivo zip, ela será substituída.

Essas opções são aplicadas ao rascunho do agente. Para exportar uma versão de agente, carregue-a em rascunho primeiro.

Os seguintes itens são incluídos na exportação de um agente:

• Intents
• Entidades
• A maioria das configurações do agente (confira a lista abaixo para ver as configurações excluídas)

Os itens a seguir não são incluídos na exportação de um agente e não são substituídos durante processos de importação ou restauração:

• Nome do agente
• Arquivos package.json e index.json do editor in-line
• Configurações de integração
• Edição
• Bases de conhecimento e documentos de conhecimento
• Configurações de fala
• Registros de interação

O tamanho máximo do agente (conteúdo não compactado) para importação/restauração do agente não pode exceder 50 MB.

Ambientes

Para acessar as configurações dos ambientes, clique na guia Ambientes.

Versões e ambientes permitem que você implante várias versões do agente em ambientes separados e personalizáveis. Para mais informações, consulte Versões e ambientes.

Voz

Para acessar as configurações de fala, clique na guia Fala.

Estas são as configurações de reconhecimento de fala e síntese de fala. As seguintes configurações estão disponíveis:

• Melhorar a qualidade de reconhecimento de fala
  • Ativar os modelos de fala aprimorada e a geração de registros de dados: veja Geração de registros de dados e modelos de voz aprimorados.
  • Ativar a adaptação automática de fala: consulte Adaptação automática de fala.
• Conversão de texto em voz
  • Ativar a conversão automática de texto em voz: converte automaticamente as respostas de texto padrão para voz em todas as conversas. Consulte Detectar intent com saída de áudio.
  • Configuração de voz:
    • Idioma do agente: escolha o idioma padrão para síntese de voz.
    • Voz: escolha um modelo de síntese de voz.
    • Taxa de fala: ajusta a taxa de fala da voz.
    • Tom: ajusta o tom de voz.
    • Ganho de volume: ajusta o ganho de volume do áudio.
    • Perfil de efeitos de áudio: selecione os perfis de efeitos de áudio que você quer aplicar à voz sintetizada. O áudio de fala é otimizado nos dispositivos associados aos perfis selecionados. Por exemplo, fones de ouvido, alto-falante grande e chamada telefônica. Para uma lista de perfis disponíveis, consulte Como usar perfis de dispositivos para áudio gerado na documentação da Conversão de texto em voz.

Compartilhar

Para acessar as configurações de compartilhamento, clique na guia Compartilhar.

Estas configurações são usadas para compartilhar o acesso ao agente com outros desenvolvedores. Consulte Controle de acesso para mais informações.

Avançado

Para acessar as configurações avançadas, clique na guia Avançado.

Atualmente, há apenas um recurso controlado por estas configurações. Para mais informações, consulte Análise de sentimento.