A documentação para a experiência do classic Watson Assistant foi movida. Para obter a versão mais atualizada, consulte FAQs para IBM® watsonx™ Assistant e Glossário.

Perguntas frequentes

Localize respostas para as perguntas mais frequentes e correções rápidas para problemas comuns.

O que é um...

Termo	Definição
Assistente	Contêiner para suas qualificações. Você inclui qualificações em um assistente e, em seguida, implementa o assistente quando está pronto para iniciar a ajuda aos seus clientes. Saiba mais.
Condição	Lógica que é definida na seção Se o assistente reconhece de um nó de diálogo que determina se o nó é processado. As condições do nó de diálogo são equivalentes a uma instrução If na lógica de programação If-Then-Else.
Catálogo de conteúdo	Um conjunto de intentos pré-construídos que são categorizados por assunto, como o atendimento ao cliente. É possível incluir esses intentos em sua qualificação e iniciar o uso deles imediatamente. Ou é possível editá-los para complementar outros intentos criados. Saiba mais.
Variável de contexto	Uma variável que é possível usar para coletar informações durante uma conversa e referenciá-la posteriormente na mesma conversa. Por exemplo, é possível que você queira perguntar o nome do cliente e, em seguida, abordar a pessoa por nome posteriormente. Uma variável de contexto é usada pela habilidade de diálogo. Saiba mais.
Diálogo	O componente no qual você constrói a conversa que seu assistente tem com seus clientes. Para cada intenção definida, é possível criar a resposta que seu assistente deve retornar. Saiba mais.
Digressão	Um recurso que dá ao usuário o poder de direcionar a conversa. Ele evita que os clientes fiquem presos em uma encadeamento de diálogo; eles poderão alternar tópicos sempre que escolherem. Saiba mais.
Desambiguação	Um recurso que permite que o assistente peça aos clientes para esclarecer seu significado quando o assistente não tiver certeza do que um usuário deseja fazer em seguida. Saiba mais.
Entidade	As informações na entrada do usuário que estão relacionadas ao propósito do usuário. Um intento representa a ação que um usuário deseja fazer. Uma entidade representa o objeto dessa ação. Saiba mais.
Integrações	Como é possível implementar seu assistente em plataformas existentes ou canais de mídia social.
Intenção	O objetivo que é expresso na entrada do usuário, como responder a uma pergunta ou processar um pagamento de fatura. Saiba mais.
Mensagem	Uma única vez em uma conversa que inclui uma única chamada para o terminal de API `/message` e sua resposta correspondente.
Usuário ativo mensal (MAU)	Um único usuário exclusivo que interage com um assistente uma ou muitas vezes em um determinado mês.
Visualizar	Integra o assistente em uma janela de bate-papo que é exibida em uma página da web com a marca IBM. Na visualização, é possível testar como uma conversa flui por toda e qualquer habilidade anexada ao assistente, de ponta a ponta.
Resposta	Lógica que é definida na seção O assistente responde de um nó de diálogo que determina como o assistente responde ao usuário. Quando a condição do nó é avaliada como true, a resposta é processada. A resposta pode consistir em uma resposta, uma pergunta de acompanhamento, um webhook que envia uma solicitação programática a um serviço externo ou slots que representam informações que precisam ser fornecidas pelo usuário antes que o assistente possa ajudar. A resposta do nó de diálogo é equivalente a uma instrução Then na lógica de programação If-Then-Else.
Qualificação	Faz o trabalho do assistente. Uma qualificação de diálogo tem os dados de treinamento que seu assistente usa para bater papo com os clientes. Uma habilidade de procura é configurada para pesquisar em fontes de dados externas apropriadas as respostas para as perguntas do cliente. Saiba mais.
Versão de qualificação	As versões são capturas instantâneas de uma qualificação que podem ser criadas em pontos chave durante o ciclo de vida de desenvolvimento. É possível implementar uma versão para produção, enquanto você continua a fazer e testar melhorias feitas em outra versão da qualificação. Saiba mais.
Intervalos	Um conjunto especial de campos que podem ser incluídos em um nó de diálogo que permitem que o assistente colete as partes necessárias de informações do cliente. Por exemplo, o assistente pode requerer que um cliente forneça detalhes de data e de local válidos antes que ele obtenha informações de previsão do tempo em nome do cliente. Saiba mais.
Salto	Uma etapa incluída em uma ação representa uma única interação ou troca de informações com um cliente, uma virada na conversa. Saiba mais.
Entidade do sistema	Entidades pré-construídas que reconhecem referências a coisas comuns como datas e números. É possível incluí-las em sua qualificação e iniciar o uso delas imediatamente. Saiba mais.
Experimente	Uma janela de bate-papo usada para testar conforme você constrói. Por exemplo, na área de janela "Experimentar" da habilidade de diálogo é possível imitar o comportamento de um cliente e entrar em uma consulta para ver como o assistente responde. É possível testar apenas a habilidade atual; não é possível testar seu assistente e todas as habilidades anexadas de ponta a ponta. Saiba mais.
Variável	Uma variável são dados que um cliente compartilha com o assistente que são coletados e salvos para serem consultados posteriormente. Saiba mais.
Chat web	Uma integração que pode ser usada para integrar seu assistente ao website da sua empresa. Saiba mais.
Webhook	Um mecanismo para ligar para um programa externo durante uma conversa. Por exemplo, seu assistente pode ligar para um serviço externo para traduzir uma sequência de inglês para francês e voltar novamente no decorrer da conversa. Saiba mais.

Se você estiver tendo problemas para efetuar login em uma instância de serviço ou vir mensagens sobre tokens, como unable to fetch access token ou 400 bad request - header or cookie too large, isso poderá significar que é necessário limpar o cache do navegador. Abra uma janela do navegador privado e, em seguida, tente novamente.

Se acessar a página usando uma janela de navegação privada corrigir o problema, considere sempre usar uma janela privada ou limpar o cache do seu navegador. Geralmente, é possível localizar uma opção para limpar o cache ou excluir cookies nas configurações de privacidade e segurança do navegador.
Se acessar a página usando uma janela de navegação privada não corrigir o problema, tente excluir a chave de API para a instância e criar uma nova.

Se você continuar recebendo mensagens, como you are getting redirected to login, isso poderá ser devido a uma das coisas a seguir:

O plano Lite que você estava usando expirou. Os planos Lite expirarão se não forem usados dentro de um intervalo de 30 dias. Para começar novamente, efetue login na IBM Cloud e crie uma nova instância de serviço do Watson Assistant.
Uma instância é bloqueada quando você excede os limites do plano para o mês. Para efetuar login com sucesso, aguarde até o início do próximo mês quando os totais do limite do plano forem reconfigurados.

Eu estou obtendo uma resposta `401`

O código de resposta 401 é retornado por muitas razões, incluindo:

Você excedeu o limite de chamadas da API para o seu plano durante este mês. Por exemplo, para planos Lite, o limite mensal para chamadas da API é de 10.000 mensagens por mês. Se você atingir o seu limite para o mês, mas os logs mostrarem que foram feitas menos chamadas do que o limite, lembre-se de que o plano Lite armazena informações de log somente por 7 dias. A resposta 401 desaparecerá assim que o próximo ciclo de faturamento for iniciado, que é o primeiro dia do mês-calendário.
Você está tentando usar uma chave de API de nível de instância que criou em um local de data center para se conectar a uma instância de serviço hospedada por meio de outro local. Deve-se criar uma chave de API no mesmo local de data center que hospeda a instância de serviço.

Obtendo a mensagem `Unable to fetch access token for account`

A mensagem completa é, Assistants could not be loaded at this time. Unable to fetch access token for account.

Essa mensagem é exibida por algumas razões:

Os tokens de atualização de seu IBM Cloud® podem ter expirado. Efetue logout e, em seguida, login novamente no IBM Cloud para gerar tokens atualizados.
Certifique-se de que o IBMid com o qual você efetuou login tenha acesso a essa instância de serviço. Para confirmar, é possível acessar a lista de recursos do IBM Cloud e, em seguida, efetuar login com o mesmo IBMid. É necessário ver essa instância de serviço listada como um de seus serviços disponíveis.

Obtendo a mensagem `Authentication Required` ou `Sign in`

Você está sendo solicitado por credenciais para acessar uma instância de serviço do Watson Assistant que pôde ser acessada sem problemas no passado. Você pode ver Authentication Required: {service-url} is requesting your username and password. ou apenas uma caixa de diálogo Sign in com campos para um nome de usuário e senha.

Essa mensagem pode ser exibida para instâncias de serviço que foram migradas do Cloud Foundry, mas para as quais as funções de acesso não foram atualizadas posteriormente. Após a migração, o proprietário da instância de serviço deve atualizar as permissões de usuário para assegurar que qualquer pessoa que precise de acesso à instância seja designada às funções de acesso de Plataforma e de Serviço apropriadas.

Para recuperar o acesso à instância de serviço, peça ao proprietário da instância de serviço para revisar suas permissões de acesso. Peça para que seja concedida pelo menos uma função de acesso ao serviço de Gravador.

Após as suas funções de acesso serem corrigidas, certifique-se de usar o endereço da web correto, a URL da instância de serviço migrada, para abri-la.

Não é possível ver a página Análise de dados

Para visualizar a página Análise de dados, deve-se ter uma função de serviço de Gerenciador e uma função de plataforma que seja, pelo menos, de Visualizador. Para obter mais informações sobre as funções de acesso e como solicitar uma mudança de função de acesso, consulte Gerenciando o acesso a recursos.

Não é possível visualizar os detalhes da API, a chave de API ou as credenciais de serviço

Se não for possível visualizar os detalhes da API ou as credenciais de serviço, provavelmente você não tem acesso de Gerenciador à instância de serviço em que o recurso foi criado. Somente pessoas com o acesso de serviço Gerenciador à instância podem usar as credenciais de serviço.

Não é possível editar intenções, entidades ou nós de diálogo

Para editar qualificações, deve-se ter o acesso de serviço Gravador à instância de serviço e uma função de plataforma que seja, pelo menos, de Visualizador. Para obter mais informações sobre as funções de acesso e como solicitar uma mudança de função de acesso, consulte Gerenciando o acesso a recursos.

Onde é possível encontrar um exemplo para criar meu primeiro assistente?

Siga as etapas no tutorial Introdução ao Watson Assistant para obter uma introdução do produto e para obter ajuda na criação de seu primeiro assistente.

É possível exportar as conversas do usuário da página Análise de dados?

Não é possível exportar diretamente as conversas da página Conversa do usuário. No entanto, é possível usar a API /logs para listar eventos das transcrições de conversas que ocorreram entre os seus usuários e o seu assistente. Para obter mais informações, consulte a Referência de API e a Referência de Consulta de Filtro Ou, é possível usar um script Python para exportar logs. Para obter mais informações, consulte export_logs_py.

É possível exportar e importar nós de diálogo?

Não, não é possível exportar e importar nós de diálogo por meio da interface com o usuário do produto.

Para copiar nós de diálogo de uma qualificação para outra, siga estas etapas:

Faça download como arquivos JSON tanto da qualificação de diálogo da qual você deseja copiar os nós de diálogo quanto da qualificação de diálogo para a qual deseja copiar os nós.
Em um editor de texto, abra o arquivo JSON para a qualificação de diálogo da qual você deseja copiar os nós de diálogo.
Localize a matriz dialog_nodes e copie-a.
Em um editor de texto, abra o arquivo JSON da qualificação de diálogo para a qual você deseja copiar os nós de diálogo e, em seguida, cole a matriz dialog_nodes nele.
Importe o arquivo JSON que você editou na etapa anterior para criar uma nova qualificação de diálogo com os nós de diálogo desejados.

É possível recuperar uma qualificação excluída?

Faça backup de dados regularmente para evitar problemas que possam surgir de exclusões inesperadas. Se você não tiver um backup, haverá um espaço de tempo curto durante o qual uma qualificação excluída poderá ser recuperável. Imediatamente após a exclusão, abra um caso com o Suporte para determinar se os dados podem ser recuperados. Inclua as informações a seguir em seu caso:

o ID da qualificação
o ID ou nome da instância
a região na qual a instância de serviço está hospedada por meio da qual a qualificação foi excluída

Posso mudar meu plano para um plano Lite?

Não, não é possível mudar de um plano Trial, Plus ou Standard para um plano Lite. E não é possível fazer o upgrade de um plano Trial para um Standard. Para obter mais informações, consulte Fazendo upgrade.

Quantas instâncias do plano Lite do Watson Assistant posso criar?

É possível ter apenas uma instância do plano Lite do Watson Assistant por grupo de recursos..

Quanto tempo os arquivos de log são mantidos para uma área de trabalho?

O tempo durante o qual as mensagens são retidas depende de seu plano de serviço. Para obter mais informações, consulte Limites de log.

Como criar um webhook?

Para definir um webhook e incluir seus detalhes, abra a habilidade na qual você deseja incluir o webhook. Abra a página Opções e, em seguida, clique em Webhooks para incluir detalhes sobre o seu webhook. Para chamar o webhook, chame-o de um ou mais de seus nós de diálogo. Para obter mais informações, consulte Fazendo uma chamada programática por meio de um diálogo.

É possível ter mais de uma entrada no campo URL para um webhook?

Não, é possível definir somente uma URL de webhook para uma qualificação de diálogo. Para obter mais informações, consulte Definindo o webhook.

É possível estender o limite de tempo do webhook?

Nº O serviço para o qual você liga por meio do webhook deve retornar uma resposta em 8 segundos ou menos ou a chamada será cancelada. Não é possível aumentar esse limite de tempo.

A mensagem “Consulta cancelada” foi recebida ao importar uma qualificação

Essa mensagem é exibida quando ocorre a parada da importação de qualificação porque os artefatos na qualificação, como nós de diálogo ou sinônimos, excedem os limites do plano. Para obter informações sobre como tratar esse problema, consulte Resolução de problemas de importação de qualificação.

Se ocorrer um tempo limite devido ao tamanho da qualificação, mas nenhum limite do plano for excedido, será possível reduzir o número de elementos que são importados por vez concluindo as etapas a seguir:

Faça uma cópia do arquivo JSON que você está tentando importar.
Abra a cópia do arquivo JSON em um editor e exclua a matriz entities.
Importe o arquivo JSON editado como uma nova qualificação.
Se essa etapa for bem-sucedida, edite a cópia original do arquivo JSON.
Remova as matrizes dialog_nodes, intents e counterexamples.
Atualize a qualificação usando a API. Certifique-se de incluir o ID da área de trabalho e a sinalização append=true, como neste exemplo:

curl -X POST -H "content-type: application/json" -H "accept: application/json" -u "apikey:{apikey}" -d@./skill.json "url/api/v1/workspaces/{workspace_id}?version=2019-02-28&append=true"

O processo de treinamento leva muito tempo e parece travado

Se o processo de treinamento ficar travado, primeiro verifique se há uma indisponibilidade para o serviço acessando a Página de status da nuvem É possível iniciar um novo processo de treinamento para parar o atual e começar de novo. Para fazer isso, inclua uma nova intenção ou entidade e, em seguida, exclua-a. Essa ação inicia um novo processo de treinamento.

Existe um intervalo de endereços IP que estão sendo usados por um webhook?

Infelizmente, os intervalos de endereço IP dos quais o Watson Assistant pode chamar uma URL de webhook estão sujeitos a mudanças, o que, por sua vez, impede que eles sejam utilizados em qualquer configuração de firewall estático. Use o transporte https e especifique um cabeçalho de autorização para controlar o acesso ao webhook.

Como eu vejo meus usuários ativos mensais no Watson Assistant?

Para ver seus usuários ativos mensais (MAU) faça o seguinte:

Conecte-se a https://cloud.ibm.com
Clique no menu Gerenciar e escolha Faturamento e uso.
Clique em Uso.
Para Watson Assistant, selecione Visualizar planos.
Em Prazo, selecione o mês que você precisa.
Selecione seus planos Plus ou planos Plus Trial para ver os usuários ativos mensais e as chamadas de API.

Erro: novo Off-Topic não suportado

Você vê o erro New Off Topic not supported depois de editar o arquivo JSON para uma habilidade de diálogo e mudar o idioma da habilidade do inglês para outro idioma.

Para resolver esse problema, modifique o arquivo JSON configurando off_topic para false. Para obter mais informações sobre esse recurso, consulte Definindo o que é irrelevante.

É possível aumentar o número de intenções por qualificação

Não, não é possível aumentar o número de intenções por habilidade.