- Página inicial
- /
- Artigo
Este artigo descreve a visão geral das intenções, entidades e respostas para configurar seu agente de IA.
Intenções
A intenção é um componente central da plataforma Webex AI Agent Studio que permite que o agente de IA compreenda e responda às suas informações de forma eficaz. Representa uma tarefa ou ação específica que você deseja realizar durante uma conversa. Você pode definir todas as intenções que correspondem às tarefas que você deseja realizar. A precisão da classificação de intenções afeta diretamente a capacidade do agente de IA de fornecer respostas relevantes e úteis. A classificação de intenções é o processo de identificação da intenção com base em suas informações, permitindo que o agente de IA responda de maneira significativa e contextualmente relevante. Para obter detalhes sobre como criar intenções, consulte Criar uma intenção.
Intenções do sistema
- Intenção alternativa padrão — os recursos de um agente de IA são inerentemente limitados pelas
intenções projetadas para reconhecer e responder. Embora uma empresa não consiga prever todas as perguntas possíveis que você possa fazer, a intenção alternativa padrão pode ajudar as conversas a continuarem.
Ao implementar uma intenção alternativa padrão, os desenvolvedores de agentes de IA podem garantir que o agente de IA processe com facilidade consultas inesperadas ou fora do escopo, redirecionando a conversa de volta para intenções conhecidas.
Os desenvolvedores de agentes de IA não precisam adicionar declarações específicas à intenção alternativa. O agente pode ser treinado para acionar automaticamente a intenção alternativa ao encontrar questões conhecidas fora do escopo que, de outra forma, poderiam ser categorizadas incorretamente em outras intenções.
Por exemplo, em um agente bancário de IA, os clientes podem tentar perguntar sobre empréstimos. Se o agente de IA não estiver configurado para lidar com consultas relacionadas a empréstimos, essas consultas poderão ser incorporadas como frases de treinamento dentro da intenção alternativa padrão. Quando um cliente pergunta sobre empréstimos em qualquer momento da conversa, o agente de IA reconhece que a consulta está fora de suas intenções definidas e aciona a resposta alternativa. Isso garante uma resposta mais apropriada.
A intenção alternativa:
- não deve ter nenhum slot associado a ele.
- deve usar a chave de modelo de fallback padrão para sua resposta.
- Ajuda — Essa intenção foi criada para atender às dúvidas dos clientes sobre os recursos do agente de IA.
Quando os clientes não têm certeza do que podem fazer ou encontram dificuldades durante uma conversa, eles geralmente buscam ajuda pedindo ajuda.Por padrão, a resposta para a intenção de ajuda é mapeada para a chave do modelo de
mensagem de ajuda. No entanto, os desenvolvedores de agentes de IA podem personalizar a resposta ou alterar a chave do modelo associada para fornecer orientações mais personalizadas e informativas .É recomendável transmitir as capacidades do agente de IA em alto nível, fornecendo aos clientes uma compreensão clara do que eles podem fazer a seguir.
- Converse com um agente — Essa intenção permite que os clientes solicitem assistência de um
agente humano em qualquer estágio de sua interação com o agente de IA. Quando essa intenção é invocada,
o sistema inicia automaticamente uma transferência para um agente humano. O
modelo de resposta padrão para essa intenção é a
transferência do agente. Embora não haja restrições de interface do usuário para alterar a chave do modelo de resposta, alterá-la não afetará o resultado da transferência humana.
Intenções de conversa fiada
Todos os agentes de IA recém-criados incluem quatro intenções predefinidas de conversa fiada para lidar com saudações comuns de clientes, expressões de gratidão, feedback negativo e despedidas:
- Saudações
- Obrigado
- O agente de IA não ajudou
- Adeus
Contextos
O contexto torna as interações entre agente e cliente mais simples e concisas. O agente de IA entende facilmente frases como “Eu quero comprar isso” quando há contexto suficiente para identificar a que “isso” se refere. Os contextos ajudam a obter clareza nas interações com os clientes. Essas expressões podem ser alinhadas com uma intenção se o contexto apropriado for fornecido.
Para permitir o acompanhamento das intenções e organizar formas de estruturar o fluxo de uma conversa, cada intenção pode ser configurada com contexto de entrada e contexto de saída. Essa variável de contexto é armazenada para cada sessão e o estado dessa variável muda com base nas intenções que são invocadas ao longo de uma sessão.
Contexto de entrada
Os contextos de entrada controlam se uma intenção pode ser combinada com a consulta do usuário final com base no contexto ativo da sessão. Quando o contexto está presente em uma sessão, as seguintes regras são aplicadas para correspondência de intenções:
-
Uma intenção com contextos de entrada só será correspondida se o contexto ativo na sessão já contiver todos os valores de contexto de entrada necessários. Em outras palavras, o contexto de entrada de uma intenção deve ser um subconjunto do contexto ativo para que ela seja correspondida.
-
Para todas as intenções que satisfazem a regra acima, é dada preferência às intenções cujo contexto de entrada corresponda mais de perto ao ativo se as pontuações de confiança para várias intenções forem as mesmas. Em outras palavras, o contexto de entrada será usado para partidas parciais de desempate.
Contexto de saída
Os contextos de saída controlam os contextos ativos de uma sessão. Um contexto de saída contém a string do valor do contexto e a duração desse contexto. Quando uma intenção é concluída (todos os espaços são preenchidos e a resposta final é invocada), os contextos de saída configurados para essa intenção se tornam saída por suas respectivas durações. Os desenvolvedores podem configurar no máximo 15 contextos de saída para uma intenção específica. Um contexto de saída pode ser adicionado pressionando a tecla enter/return depois de digitar o contexto.
Entidades
As entidades são os alicerces das conversas. Eles são elementos essenciais que o agente de IA extrai das declarações do usuário. As entidades representam informações específicas, como nomes de produtos, datas, quantidades ou qualquer outro grupo significativo de palavras. Ao identificar e extrair entidades de forma eficaz, o agente de IA pode entender melhor a intenção do usuário e fornecer respostas mais precisas e relevantes. Para obter detalhes sobre como criar uma entidade, consulte Criar uma entidade.
Tipos de entidade
O Webex AI Agent Studio oferece 11 tipos de entidades pré-criadas para capturar vários tipos de dados do usuário. Você também pode criar qualquer uma das seguintes entidades personalizadas.
Entidades personalizadas
Essas entidades são configuráveis e permitem que os desenvolvedores capturem informações específicas do caso de uso.
-
Lista personalizada—Defina listas de cadeias de caracteres esperadas para capturar pontos de dados específicos não cobertos por entidades pré-criadas. Você pode adicionar vários sinônimos em cada string. Por exemplo, uma entidade personalizada de tamanho de pizza.
-
Regex—Use expressões regulares para identificar padrões específicos e extrair dados correspondentes.
Por exemplo, um número de telefone regex, como em 123-123-8789 -
Dígitos — Capture entradas numéricas de comprimento fixo com alta precisão, especialmente em interações de voz. Usamos isso como uma alternativa aos tipos de entidades personalizadas e Regex em interações sem voz. Por exemplo, defina um comprimento de cinco para detectar um número de conta de cinco dígitos.
-
Alfanumérico — Capture combinações de letras e números, fornecendo reconhecimento preciso para entradas de voz e não vozes.
-
Formulário livre — capture pontos de dados flexíveis que são difíceis de definir ou validar.
-
Localização no mapa (WhatsApp) — Extraia dados de localização compartilhados por você no canal do WhatsApp.
Entidades do sistema
| Nome da entidade | Descrição | Exemplo de entrada | Exemplo de saída |
|---|---|---|---|
| Data | Analisa datas em linguagem natural para um formato de data padrão | “julho do próximo ano” | 01/07/2020 |
| Hora | Analisa a hora em linguagem natural para um formato de hora padrão | 5 da noite | 17:00 |
| Detecta endereços de e-mail | escreva para mim em info@cisco.com | info@cisco.com | |
| Número de telefone | Detecta um número de telefone comum | ligue para 9876543210 | 9876543210 |
| Unidades monetárias | Analisa moeda e valor | Eu quero 20$ | 20$ |
| Ordinal | Detecta o número ordinal | Quarta de dez pessoas | 4º |
| Cardeal | Detecta o número cardinal | Quarta de dez pessoas | 10 |
| Geolocalização | Detecta localizações geográficas (cidades, países etc.) | Fui nadar no Tâmisa, em Londres, Reino Unido. | Londres, Reino Unido |
| Nomes de pessoas | Detecta nomes comuns | Bill Gates, da Microsoft | Bill Gates |
| Quantidade | Identifica medidas, como peso ou distância | Estamos a 5 km de Paris | 5 km |
| Duração | Identifica períodos de tempo | 1 semana de férias | 1 semana |
Você pode editar entidades criadas na guia entidades. Vincular entidades a uma intenção anota suas declarações com entidades detectadas à medida que você as adiciona.
Respostas
As respostas são as mensagens que seu agente de IA envia aos clientes em resposta às suas dúvidas ou intenções. Você pode criar respostas que incluam:
- Texto — mensagens de texto simples para comunicação direta.
- Multimídia — Elementos de imagens, áudio ou vídeo para aprimorar a experiência do usuário.
Para obter detalhes sobre como criar respostas, consulte Criar uma resposta.
Respostas do sistema
As seguintes respostas pré-configuradas do sistema estão disponíveis para o agente de IA com script. Você pode personalizar as mensagens para as respostas padrão do sistema. No entanto, você não pode excluir essas respostas.
-
Mensagem de boas vindas
-
Sugestão de resposta
-
Mensagem parcial
-
Mensagem alternativa
-
Sugestão de entidade
-
Entrega do agente
Respostas de conversa fiada
Você pode personalizar e excluir as seguintes respostas de conversa fiada:
-
Adeus
-
Saudações
-
Mensagem de ajuda
-
Não ajuda
-
Obrigado
Os canais suportados para os quais você pode configurar as respostas são Web (padrão), Apple Messages for Business, Messenger, RCS, SMS, Voice e WhatsApp.
Designer de respostas
O designer de respostas oferece uma interface fácil de usar para criar respostas sem exigir amplo conhecimento de codificação. A opção de respostas condicionais permite a fácil construção de respostas para não desenvolvedores que o agente de IA fornece aos clientes.
O designer de respostas foi projetado para garantir que a experiência do usuário atenda ao canal específico com o qual o agente de IA está interagindo.
Tipos de resposta compatíveis para canais
No Response Designer, você pode configurar respostas específicas do canal para as intenções. Para obter mais informações sobre como configurar vários tipos de resposta, consulte a seção Configurar tipos de resposta.
| Tipo de resposta | Descrição | Canais suportados |
|---|---|---|
| Texto | Respostas de texto simples permitem várias caixas de texto em uma resposta. Essa configuração divide mensagens longas em partes gerenciáveis. Você pode adicionar várias opções de resposta às suas respostas, e o sistema escolherá aleatoriamente uma para exibir, garantindo interações dinâmicas. | Todos |
| Carrossel | As respostas avançadas consistem em um único cartão ou em vários cartões exibidos em formato de carrossel. | Web (padrão), Messenger |
| Resposta rápida | Uma resposta predefinida que os agentes de IA usam para responder rapidamente às consultas dos clientes. | Web (padrão), SMS, Messenger, Apple Messages for Business, RCS |
| Imagem | Um tipo de resposta multimídia em que você pode configurar imagens fornecendo URLs. | Web (padrão), Messenger, WhatsApp |
| Vídeo | Renderiza vídeos na pré-visualização com base no URL do vídeo configurado. | Web (padrão), WhatsApp |
| Áudio | Processa o arquivo de áudio fornecendo o URL do áudio. Também mostra a duração da mensagem de áudio na saída. | Web (padrão), WhatsApp, Webchat |
| Arquivo | Mostra/reproduz o tipo de arquivo com base no URL do arquivo configurado. | |
| Botão de resposta | Oferece respostas rápidas a partir de um conjunto limitado de opções, como escolher um
produto para devolução. Cada mensagem é composta por:
| |
| Mensagem da lista | Apresenta várias opções para facilitar a seleção do usuário, adequadas para vários usos,
como menus para viagem ou catálogos de produtos. Para configurar uma mensagem de lista, preencha as guias
'configuração' e 'seções da lista'. A tela de 'configuração' mostra o conteúdo da
mensagem que os usuários verão em seus dispositivos. Cada mensagem é composta por:
A seção da lista consiste em:
A configuração de uma mensagem de lista na plataforma exigirá um campo adicional: ID da linha - identificador exclusivo para cada linha que ajudará você a identificar a escolha dos usuários. | |
| Lista numerada | A resposta rápida no WhatsApp é definida como lista numerada. Quando os usuários escolhem um número da lista de itens, a carga configurada no item é recebida. | |
| Seletor de listas | Com o seletor de listas, o agente de IA compartilha uma lista de itens com um cliente com base na consulta. Isso permite que o cliente selecione os itens das opções fornecidas e responda com a seleção. Se a consulta do cliente corresponder parcialmente, o agente de IA responderá com as intenções próximas à consulta do cliente como opções. As respostas de correspondência parcial são renderizadas somente para a opção Seletor de listas no canal Apple Messages for Business. | Mensagens da Apple para empresas |
| Seletor de horário | O tipo de resposta do seletor de horário permite configurar intervalos de tempo para agendar compromissos ou reuniões. Cada seção precisa de um título, fuso horário e vários slots. Depois de configurado para uma intenção, o agente de IA envia esses intervalos de tempo aos usuários para que eles escolham. | Mensagens da Apple para empresas |
| Mídia | Este modelo suporta anexos em vários formatos, como jpeg, mp3, mp4, png, pdf e aac. | Mensagens da Apple para empresas |
| Link avançado | O URL do rich link está incorporado na imagem ou no vídeo que está em um balão de bate-papo. Quando você clica nesse balão, o cliente é redirecionado para o site especificado na imagem ou no vídeo. | Mensagens da Apple para empresas |
| Formulário | As mensagens do Business Forms permitem criar experiências interativas complexas de várias páginas para iOS e iPadOS usando um único arquivo JSON. Esse recurso ajuda as empresas a coletar dados detalhados dos clientes por meio de uma interface fácil de usar no Apple Messaging. Ele permite várias interações sem que os usuários precisem sair do chat. | Mensagens da Apple para empresas |
| Evento personalizado | Fornece controle sobre uma conversa enquanto interage com o agente de IA com script. | Voz |
Lista de variáveis de resposta comuns
Use as variáveis de resposta na seção Regras do designer de resposta condicional para definir as condições. Você também pode usar as variáveis de resposta nas respostas dos agentes de IA para personalizar e enriquecer as respostas do agente. Para obter mais informações sobre como configurar regras, consulte Criar uma resposta.
| Nome da variável |
Chave variável | Descrição |
|---|---|---|
|
Valor da entidade |
|
Use essa variável para usar o valor das entidades coletadas dos usuários. Por exemplo, em um caso de uso de reserva de compromisso em que solicitamos ao usuário sua data preferida usando uma entidade chamada 'Date' Entity.date retorna o valor fornecido pelo usuário. |
|
Intenção |
|
Use essa variável para retornar a intenção inserida pelo cliente. |
|
Loja de eventos |
|
Use isso para acessar o dicionário que contém todos os parâmetros enviados na carga útil do evento de eventos personalizados por meio do Webex Contact Center Flow Designer. |
|
Valores da loja de eventos |
|
Use isso para acessar os valores de chaves específicas enviadas em cargas de eventos personalizados por meio do Webex Contact Center Flow Designer. |
|
Valor do parâmetro extra/parâmetro da mensagem |
|
Use isso para acessar as informações passadas em “Parâmetros de mensagem” no nó do Agente de IA para agentes com script. Por exemplo, se uma chave 'user_plan' for passada no nó do agente de IA, ela estará acessível como extra_params.user_plan. Esses valores são mantidos por apenas um turno de mensagem, ou seja, o valor da chave só pode ser usado na resposta à mensagem que acompanhou esses parâmetros de mensagem. |
|
Parâmetros extras |
|
Use isso para acessar o dicionário contendo todos os valores passados em “ Parâmetros de mensagem” no nó do Agente de IA para agentes com script. |
|
Armazenamento de dados do consumidor/parâmetros do cliente |
|
Use isso para acessar o dicionário contendo todos os parâmetros passados em “Parâmetros do cliente” no nó do Agente de IA para agentes com script. |
|
Armazenamento de dados do consumidor/valores dos parâmetros do cliente |
|
Use isso para acessar as informações passadas em “Parâmetros do cliente” no nó do Agente de IA para agentes com script. Por exemplo, se uma chave 'user_name' for passada no nó do agente de IA, ela estará acessível como consumerDatastore.extra_params.user_name |
|
Intenção anterior/Última intenção ativa |
|
Use essa variável para acessar o nome da intenção que estava ativa na conversa antes da intenção atual. |
|
Matriz de contexto |
|
Use isso para acessar os nomes de todos os contextos presentes na conversa na forma de uma matriz. |
|
Duração do contexto |
|
Obtém o valor da duração de um contexto específico. |
|
UID do cliente |
|
Use essa variável para acessar a ID exclusiva do cliente nas condições ou no conteúdo de resposta do agente de IA. Para canais digitais, o UID é configurado no fluxo e varia de acordo com o canal. |
|
Variável de armazenamento de dados |
|
Use essa variável para acessar variáveis personalizadas armazenadas em um nível de sessão. |
|
Entrega do agente por bandeira de regras |
|
Use essa variável para verificar se a conversa foi entregue a um humano com base em alguma das regras de transferência do agente. |
|
Chave de modelo correspondente |
|
Use essa variável para acessar o nome da resposta atual. |
|
Texto de PNL |
|
Use essa variável para acessar a consulta não processada do cliente. |
|
Consulta processada |
|
Use essa variável para acessar a consulta processada do cliente. |
| ID da transação |
| Use essa variável para acessar o ID da transação. |
Além dos itens acima, existem alguns outros objetos de dados que podem ser acessados como variáveis de resposta. Isso inclui MessageStore, newDFState e lastDFState, que contêm metadados sobre a resposta do agente. Os desenvolvedores podem imprimir isso em suas respostas para acessar os detalhes e usar qualquer parâmetro desses dicionários em suas respostas. No entanto, na maioria dos casos de uso, as variáveis listadas na tabela acima são suficientes para criar seu agente.