Neste artigo
dropdown icon
Intenções
    Intenções do sistema
    Pequenas intenções de conversa
    Contextos
dropdown icon
Entidades
    Tipos de entidade
dropdown icon
Respostas
    Respostas do sistema
    Respostas de conversa pequena
    Designer de respostas
    Lista de variáveis de resposta comuns
Entenda as intenções, entidades e respostas no AI Agent Studio
list-menuNeste artigo
list-menuComentários?

Este artigo descreve a visão geral das intenções, entidades e respostas para configurar seu agente de IA.

Intenções

Intenção é um componente central da plataforma Webex AI Agent Studio que permite que o agente de IA entenda e responda às suas contribuiçõ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 deseja executar.A precisão da classificação de intenção afeta diretamente a capacidade do agente de IA de fornecer respostas relevantes e úteis.A classificação de intenção é o processo de identificação de intenção com base em sua entrada, permitindo que o agente de IA responda de maneira significativa e contextualmente relevante. For details on how to create intents, see Create an intent.

Intenções do sistema

  • Intenção de fallback padrão — As capacidades de um agente de IA são inerentemente limitadas pelas intenções projetadas para reconhecer e responder.Embora uma empresa não possa antecipar todas as perguntas possíveis que você possa fazer, a intenção de fallback padrão pode ajudar as conversas a estarem no caminho certo.

    Ao implementar uma intenção de fallback padrão, os desenvolvedores de agentes de IA podem garantir que o agente de IA lide graciosamente com 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 expressões específicas à intenção de fallback.O agente pode ser treinado para acionar automaticamente a intenção de fallback quando encontrar perguntas conhecidas fora do escopo que, de outra forma, poderiam ser incorretamente categorizadas em outras intenções.

    Por exemplo, em um agente de IA bancária, 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 podem ser incorporadas como frases de treinamento dentro da intenção de fallback padrão.Quando um cliente consulta sobre empréstimos em qualquer ponto da conversa, o agente de IA reconhece a consulta como fora de suas intenções definidas e aciona a resposta de fallback.Isso garante uma resposta mais apropriada.

    A intenção de fallback:

    • não deve ter nenhum slot associado a ele.
    • deve usar a chave do modelo de fallback padrão para sua resposta.

  • Ajuda — Esta intenção é projetada para responder a consultas do cliente sobre as capacidades do agente de IA.Quando os clientes não têm certeza do que podem realizar 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 associado para fornecer orientações mais personalizadas e informativas.

    Recomenda-se transmitir os recursos do agente de IA em um nível elevado, fornecendo aos clientes uma compreensão clara do que podem fazer a seguir.

  • Fale com um agente—Essa intenção permite que os clientes solicitem assistência de um agente humano em qualquer fase de sua interação com o agente de IA.Quando esta intenção é invocada, o sistema inicia automaticamente uma transferência para um agente humano.O modelo de resposta padrão para esta intenção é a transferência de agente.Embora não haja restrições da IU sobre a alteração da chave do modelo de resposta, alterar a chave não afetará o resultado da transferência humana.

Pequenas intenções de conversa

Todos os agentes de IA recém-criados incluem quatro pequenas intenções de conversa predefinidas para lidar com as saudações comuns do cliente, expressões de gratidão, comentários negativos e despedidas:

  • Saudações
  • Obrigado
  • O agente de IA não foi útil
  • Adeus
Essas intenções e suas respostas correspondentes estão disponíveis por padrão em cada agente de IA.No entanto, você pode personalizar ou excluí-los para alinhar com seu caso de uso específico e o fluxo de conversação desejado.

Contextos

O contexto torna as interações agente-cliente mais simples e concisas.O agente de IA entende facilmente frases como "Eu quero comprar isso" quando há contexto suficiente para identificar o 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 ativar as intenções de acompanhamento e organizar maneiras de estruturar o fluxo de uma conversa, cada intenção pode ser configurada com o contexto de entrada e 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 correspondida 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ção:

  • 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 satisfaçam 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 correspondências parciais de quebra de empate.

Sair do contexto

Sair controla os contextos ativos de uma sessão.Um contexto de saída contém a string de valor de contexto e a duração desse contexto.Quando uma intenção é concluída (todos os slots são preenchidos e a resposta final é invocada), os contextos de saída configurados para essa intenção tornam-se saída para suas respectivas durações.Os desenvolvedores podem configurar um máximo de contextos de saída do 15 para uma determinada intenção.Um contexto de saída pode ser adicionado pressionando a tecla enter/return depois de digitar o contexto.

Entidades

As entidades são os blocos de construção das conversas.Eles são elementos essenciais que o agente de IA extrai dos enunciados do usuário.As entidades representam partes específicas de informações, como nomes de produtos, datas, quantidades ou qualquer outro grupo significativo de palavras.Ao identificar e extrair entidades com eficácia, o agente de IA pode entender melhor a intenção do usuário e fornecer respostas mais precisas e relevantes. For details on how to create an entity, see Create an entity.

Tipos de entidade

O Webex AI Agent Studio oferece 11 tipos de entidade pré-criados 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 de casos de uso.

  • Lista personalizada — define listas de strings esperadas para capturar pontos de dados específicos não cobertos por entidades pré-criadas.Você pode adicionar vários sinônimos para cada string.Por exemplo, uma entidade de tamanho de pizza personalizada.

  • Regex — Use expressões regulares para identificar padrões específicos e extrair dados correspondentes.Por exemplo, um regex de número de telefone, 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 entidade Custom e Regex em interações que não sejam de voz.Por exemplo, defina um comprimento de cinco para detectar um número de conta de cinco dígitos.

  • Alfanumérico — Captura combinações de letras e números, fornecendo reconhecimento preciso para entradas de voz e não-voz.

  • Forma livre — Capture pontos de dados flexíveis que são difíceis de definir ou validar.

  • Mapear localização (WhatsApp) — Extraia dados de localização compartilhados por você no canal do WhatsApp.

Entidades do sistema

Nome da entidadeDescriçãoEntrada de exemploSaída de exemplo
DataAnalisa as datas na linguagem natural num formato de data normalizado“Julho do próximo ano”01/07/2020
DuraçãoAnalisar a hora em linguagem natural para um formato de hora padrão5 à noite17:00
E-mailDetecta endereços de e-mailwrite to me at info@cisco.cominfo@cisco.com
Número de telefoneDetecta o número de telefone comumchamar-me em 98765432109876543210
Unidades monetáriasAnalisa a moeda e o montanteEu quero 20$20$
OrdinalDetecta o número ordinalQuarto de dez pessoas
CardeaisDetecta o número cardinalQuarto de dez pessoas10
GeolocalizaçãoDetecta localizações geográficas (cidades, países, etc.)Eu fui nadar no Tamisa em Londres Reino UnidoLondres, Reino Unido
Nomes de pessoasDetecta nomes comunsBill Gates da MicrosoftPredefinição: Bill Gates
QuantidadeIdentifica medições, como o peso ou a distânciaEstamos a 5km de Paris5km
DuraçãoIdentifica períodos de tempo1 semana de férias1 semana

Você pode editar entidades criadas na guia de entidades.Vincular entidades a uma intenção anota seus enunciados com entidades detectadas à medida que você os adiciona.

Respostas

Respostas são as mensagens que o seu agente de IA envia aos clientes em resposta a suas consultas ou intenções.Você pode criar respostas que incluem:

  • Texto — Mensagens de texto simples para comunicação direta.
  • Multimídia—Imagens, elementos de áudio ou vídeo para aprimorar a experiência do usuário.

For details on how to create responses, see Create a response.

Respostas do sistema

As seguintes respostas pré-configuradas do sistema estão disponíveis para o agente de IA scripted.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 de fallback

  • Sugestão de entidade

  • Transferência do agente

Respostas de conversa pequena

Você pode personalizar e excluir as seguintes respostas de conversa pequena:

  • Adeus

  • Saudações

  • Mensagem de ajuda

  • Não útil

  • Obrigado

Os canais suportados para os quais você pode configurar as respostas são Web (padrão), Apple Messages for Business, Messenger, RCS, SMS, Voz, 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 nos canais

No Designer de respostas, você pode configurar respostas específicas do canal para as intenções. For more information on how to configure various response types, see the Configure response types section.

Tabela 1.Tipos de resposta para canais
Tipo de respostaDescriçãoCanais compatíveis
TextRespostas de texto simples permitem várias caixas de texto em uma resposta.Essa configuração quebra mensagens longas em partes gerenciáveis.Você pode adicionar várias opções de resposta às suas respostas e o sistema escolherá aleatoriamente uma a ser exibida, garantindo interações dinâmicas.Tudo
CarouselRespostas ricas consistem em um único cartão ou vários cartões exibidos em um formato carrossel.Web (Padrão), Messenger
Quick ReplyUma resposta predefinida que os agentes de IA usam para responder rapidamente às consultas dos clientes.Web (padrão), SMS, Messenger, Mensagens da Apple para negócios, RCS
ImageUm tipo de resposta multimídia onde você pode configurar imagens fornecendo URLs.Web (padrão), Messenger, WhatsApp
VideoProcessa vídeos na pré-visualização com base na URL de vídeo configurada.Web (Padrão), WhatsApp
AudioProcessa o arquivo de áudio fornecendo a URL de áudio.Ela também mostra a duração da mensagem de áudio na saída.Web (padrão), WhatsApp, Webchat
FileMostra/reproduz o tipo de arquivo com base na URL do arquivo configurado.WhatsApp
Reply ButtonOferece respostas rápidas de um conjunto limitado de opções, como escolher um produto para retornar.

Cada mensagem é composta por:

  • Cabeçalho - um campo opcional que pode ser 20 caracteres de texto, imagem, vídeo ou um documento.
  • Corpo - um campo de texto obrigatório que pode conter até 1024 caracteres.
  • Rodapé - um campo de texto opcional que permite até 60 caracteres.
  • Botões - máximo de botões de texto 3 com um limite de 20-character.

WhatsApp
List MessageApresenta várias opções para fácil seleção do usuário, adequadas para vários usos, como menus de saída ou catálogos de produtos.Para configurar uma mensagem de lista, preencha as guias "configuração" e "seções de lista".A tela "configuração" mostra o conteúdo da mensagem que os usuários verão em seus dispositivos.

Cada mensagem é composta por:

  • Cabeçalho - um campo de texto opcional com um máximo de 60 caracteres.

  • Corpo - um campo de texto obrigatório que pode conter até 1024 caracteres.

  • Rodapé - um campo de texto opcional que permite até 60 caracteres.

  • Título da lista - um campo de botão com máximo de 20 caracteres.

A seção da lista consiste em:

  • Títulos da seção - campo de texto opcional usado para categorizar várias linhas com um máximo de caracteres 24.

  • Título da linha - campo de texto obrigatório que é enviado como uma opção de seleção acompanhada por um botão de opção com um máximo de 24 caracteres.

  • Descrição da linha - campo de texto opcional que fornece contexto adicional para itens de linha com um máximo de 72 caracteres.

Configurar uma mensagem de lista na plataforma exigirá um campo adicional:ID da linha - identificador exclusivo para cada linha que o ajudará a identificar a escolha dos usuários.

WhatsApp
Numbered ListA resposta rápida no WhatsApp está definida como lista numerada.Quando os usuários escolhem um número da lista de itens, a carga configurada em relação ao item é recebida.WhatsApp
List PickerCom 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 que estão próximas da consulta do cliente como opções.As respostas de correspondência parcial são renderizadas apenas para a opção Seletor de lista no canal Mensagens da Apple para negócios.Mensagens da Apple para negócios
Time PickerO tipo de resposta do seletor de tempo permite configurar intervalos de tempo para reservas de 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 para os usuários escolherem.Mensagens da Apple para negócios
MediaEsse modelo suporta anexos que estão em vários formatos, como jpeg, mp3, mp4, png, pdf e aac.Mensagens da Apple para negócios
Rich LinkA URL do link rico está incorporada na imagem ou em um vídeo que está em um balão de bate-papo.Quando você clica neste balão, o cliente é redirecionado para o site especificado na imagem ou vídeo.Mensagens da Apple para negócios
FormAs Mensagens de Formulários de Negócios permitem criar experiências complexas e interativas de várias páginas para iOS e iPadOS usando um único arquivo JSON.Esse recurso ajuda as empresas a coletar dados detalhados do cliente por meio de uma interface fácil de usar no Apple Messaging.Ele permite várias interações sem que os usuários tenham que sair do bate-papo.Mensagens da Apple para negócios
Custom EventFornece controle sobre uma conversa enquanto interage com o agente de IA scripted.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 condições.Você também pode usar as variáveis de resposta nas respostas do agente de IA para personalizar e enriquecer as respostas do agente. For more information on how to configure rules, see Create a response.

Tabela 2.Variáveis de resposta comuns
Nome da variável

Chave de variável

Descrição

Valor da entidade

entidade.<entity-name> OU lastdfState.model_state.entities.<entity-name>.value

Use esta 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 pedimos ao usuário sua data preferida usando uma entidade chamada "Data". A data retorna o valor fornecido pelo usuário.

Intenção

intenção OU lastdfState.model_state.intent.name

Use esta variável para retornar a intenção que é inserida pelo cliente.

Loja de eventos

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 Designer de fluxo do Webex Contact Center.

Valores do armazenamento de eventos

EventStore.<key>

Use isso para acessar os valores de chaves específicas enviadas em cargas de eventos personalizados por meio do Designer de fluxo do Webex Contact Center.

Valor do parâmetro extra/Parâmetro de mensagem

extra_params.<key>

Use isso para acessar informações passadas em "Parâmetros de mensagem" no nó do agente de IA para agentes scripts.Por exemplo, se uma chave "user_plan" for passada no nó do agente de IA, ela será acessível como extra_params.user_plan.Esses valores são persistentes para apenas uma rotação 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

extra_params

Use isso para acessar o dicionário que contém todos os valores passados em "Parâmetros de mensagem" no nó do agente de IA para agentes scripts.

Armazenamento de dados do consumidor/parâmetros do cliente

consumerDataStore.extra_params

Use isso para acessar o dicionário que contém todos os parâmetros passados em "Parâmetros do cliente" no nó do agente de IA para agentes scripts.

Armazenamento de dados do consumidor/valores de parâmetros do cliente

consumerDataStore.extra_params.<key>

Use isso para acessar informações passadas em "Parâmetros do cliente" no nó do agente de IA para agentes scripts.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

lastdfState.previous_intent_model_state.intent.name

Use esta variável para acessar o nome da intenção que estava ativa na conversa antes da intenção atual.

Matriz de contexto

lastdfState.context

Use isso para acessar os nomes de todos os contextos presentes na conversa na forma de uma matriz.

Duração do contexto

LastdfState.context.<nome de contexto>

Busca o valor da duração de um contexto específico.

UID do cliente

consumerData.uid

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

dataStore.<key>

Use essa variável para acessar variáveis personalizadas armazenadas em um nível de sessão.

Sinalizador de transferência do agente por regras

messageStore.agent_handover_by_rules

Use esta variável para verificar se a conversa foi entregue a um ser humano com base em qualquer uma das regras de entrega do agente.

Chave do modelo correspondente

messageStore.templateKey

Use esta variável para acessar o nome da resposta atual.

Texto da PLN

nlp.text

Use esta variável para acessar a consulta do cliente não processada.

Consulta processada

nlp.processed_query

Use esta variável para acessar a consulta do cliente processada.

ID da transação

transação_id

Use esta variável para acessar a ID da transação.

Além do acima, existem determinados outros objetos de dados que são acessíveis como variáveis de resposta.Eles incluem messageStore, newdfState e last dfState que contêm metadados sobre a resposta do agente.Os desenvolvedores podem imprimir isso em suas respostas para acessar os detalhes e usar quaisquer parâmetros 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 o agente.

Este artigo foi útil?
Este artigo foi útil?