IBM Cloud Docs
Construindo ações a partir de templates

Construindo ações a partir de templates

Ao criar ações, é possível escolher um modelo relacionado ao problema que você está tentando resolver. Os modelos ajudam a adequar suas ações para incluir itens específicos para a sua necessidade de negócio. Os exemplos em cada modelo também podem ajudá-lo a aprender como as ações funcionam.

Os modelos estão disponíveis para diferentes casos de uso, por exemplo, agendando uma reunião, criando um ticket de suporte ou fazendo um pagamento. Os modelos incluem todas as peças que compõem uma ação, como etapas, condições e diferentes tipos de resposta para coletar respostas do cliente.

Você pode usar modelos em assistentes de língua inglesa apenas.

Esses recursos são incluídos como exemplos em modelos de ação:

Recursos
Recursos Descrição Informações adicionais
Condições da etapa Uma condição de etapa é um teste booleano, baseado em um valor de tempo de execução. A etapa será usada somente se o teste for avaliado como true Incluindo condições em uma etapa
Opções de sinônimos Os sinônimos são variações de um valor de opção que os clientes podem inserir. Opções
Validação de resposta customizada Ao editar uma etapa que espera uma resposta do cliente, é possível customizar como os erros de validação são tratados. Quando o cliente dá respostas inválidas
Variáveis de ação: Quando os clientes respondem ao assistente, eles compartilham informações sobre si mesmos e o que eles querem. Seu assistente lembra essas informações e outras informações sobre uma conversa, como variáveis. Usando variáveis para gerenciar informações de conversa
Variáveis de sessão Um valor que não é necessariamente ligado a uma ação específica pode ser armazenado como uma variável de sessão. As variáveis de sessão são memória de longo prazo: elas persistem ao longo da interação do usuário com o assistente e o assistente pode referenciá-las em qualquer ação. Usando variáveis para gerenciar informações de conversa
Tipo de resposta regex Uma resposta regex coleta uma sequência de texto que corresponde a um padrão expresso como uma expressão regular. Use essa resposta para capturar um valor que deve estar em conformidade com um determinado padrão ou formato, como um endereço de e-mail ou número de telefone. Expressão regular
Sim / Não tipo de resposta Uma resposta de confirmação apresenta aos clientes as opções Sim ou Não como botões. Confirmation
Conectar ao agente Se o seu assistente estiver integrado a um dos sistemas de central de serviço suportados, será possível construir na lógica que transfere a conversa para um agente ativo quando necessário. Conectando a um agente em tempo real
Vídeo integrado Inclui um vídeo para exibir uma demonstração de instruções, um clipe promocional ou outro conteúdo de vídeo. No chat web, uma resposta de vídeo é renderizada como um reprodutor de vídeo integrado. Incluindo uma resposta de vídeo
Respostas do cliente referenciadas em URLs Na saída do assistente, é possível fazer referência a variáveis para personalizar um link de URL, incluindo informações específicas para o cliente, como número da conta ou endereço de e-mail Incluindo e consultando variáveis
Informações de entrega do agente customizado Se o seu assistente estiver integrado a um dos sistemas de central de serviço suportados, será possível construir na lógica que transfere a conversa para um agente ativo quando necessário. É possível customizar mensagens que o assistente exibe como parte da transferência Conectando a um agente em tempo real

Criando ações a partir de templates

Para criar ações a partir de templates:

  1. Abra a página Ações.

  2. Se não tiver ações, escolha Criar uma nova ação. Se você já tem algumas ações, escolha Nova ação.

  3. Em Criar uma ação, escolha Início rápido com modelos.

    Criar uma ação
    Criar uma ação

  4. Em Início rápido com modelos, clique em um template para ler detalhes sobre o que ele faz. Ou você pode clicar na caixa de seleção para selecionar o modelo imediatamente.

    Se você escolher um modelo de kit do iniciador, essas ações exigirão que você inclua uma extensão customizada antes de incluir as ações do kit do iniciador. Para obter mais informações, consulte Configuração da extensão do kit do iniciador

    Iniciação rápida com modelos
    Iniciação rápida com modelos

  5. Revise os detalhes do template, em seguida, clique em Selecionar este modelo.

    Detalhes do modelo
    Detalhes de modelo

  6. Sua lista de modelos selecionados inclui todos os que você escolheu. Você pode selecionar quantos modelos quiser. Se você mudar de ideia, clique no ícone da lixeira para remover um modelo da lista.

    Modelos selecionados
    Modelos selecionados

  7. Quando estiver pronto, clique em Adicionar modelos.

  8. No editor de ações, você pode usar uma nova ação como-is, ou modificá-la para encaixar seu caso de uso.

    Nova ação
    Nova ação

Você pode criar várias ações a partir do mesmo modelo. Por exemplo, se você usou o modelo Reservar uma Reunião para criar uma ação, será possível escolher esse modelo novamente Se a primeira ação ainda for denominada Livro a reunião, a nova ação será adicionada com o nome Livro a reunião (1).

Ações de visualização

A maioria dos modelos de ação está completa. (Os modelos do kit do iniciador são marcados com um asterisco e requerem configuração) Você pode tentar uma ação imediatamente mesmo sem fazer nenhuma alteração.

Para visualizar a ação criada a partir de um modelo:

  1. No editor de ações, clique em Preview.

  2. Tente algumas frases de exemplo de O cliente começa com para ver como o assistente responde

    Visualização
    Visualização

Configuração de extensão do kit Starter

Os modelos de kit iniciador adicionam ações que podem usar extensões para se conectar a dados e sistemas fora do watsonx Assistant. Para saber mais sobre extensões em geral, veja Construir uma extensão personalizada.

É importante incluir a extensão em seu assistente primeiro para que as ações do kit do iniciador possam detectar a extensão instalada. Não inclua as ações do kit iniciador sem incluir a extensão primeiro.

Esta tabela lista cada kit iniciante, um link para fazer o download de um arquivo de especificação OpenAPI que você precisa para configurar a extensão, e um link para instruções de setup.

Kits do iniciador
Kit do iniciador Arquivo de especificação OpenAPI Instruções de Configuração
Pesquisa de coveo coveo.openapi.json Configuração de pesquisa do Coveo
Pesquisa customizada Google google-custom-search-openapi.json Google setup de busca personalizado
HubSpot hubspot.advanced.openapi.json HubSpot
NeuralSeek Requer um arquivo específico para sua instância de NeuralSeek. Consulte as instruções de setup. NeuralSeek setup de extensão
ServiceNow sn.openapi.json ServiceNow setup de extensão
Zendesk zendesk-openapi.json Configuração de extensão do Zendesk

Setup de extensão de pesquisa Coveo

Para configurar a extensão para a procura Coveo, consulte Configuração da extensão de procura Coveo.

Setup de extensão de busca personalizada do Google

Para configurar a extensão para a procura customizada do Google, consulte Google

Setup de extensão HubSpot

Para configurar a extensão para HubSpot:

  1. No HubSpot, você precisa criar uma conta de desenvolvedor e, em seguida, criar um app privado. O app privado inclui um token de acesso necessário para autenticação. Para obter instruções detalhadas, consulte Obtendo token de acesso ao app privado no repositório HubSpot Custom Extension starter kit GitHub.

  2. Sua conta HubSpot precisa de propriedades customizadas. Siga as instruções em Adicionando Propriedades Personalizadas em HubSpot no repositório HubSpot Custom Extension starter kit GitHub.

  3. Faça o download do arquivo de especificação OpenAPI: hubspot.advanced.openapi.json.

  4. Em seu assistente, na página Integrações, clique em Construir extensão customizada e use o arquivo de especificação OpenAPI para construir uma extensão personalizada. Para obter instruções gerais sobre como construir qualquer extensão customizada, consulte Construindo uma extensão customizada.

  5. Após construir a extensão de busca personalizada do HubSpot e ela aparecer em sua página Integrações, clique em Adicionar para adicioná-lo ao seu assistente. Use o token de acesso do app privado HubSpot para autenticar. Para instruções gerais sobre adicionar qualquer extensão customizada, consulte Adicionando uma extensão ao seu assistente.

  6. Abra a página Ações.

  7. Se não tiver ações, escolha Criar uma nova ação. Se você já tem algumas ações, escolha Nova ação.

  8. Em Criar uma ação, escolha Início rápido com modelos.

  9. Em Iniciação rápida com modelos, inclua o kit do iniciador HubSpot..

NeuralSeek setup de extensão

Para configurar a extensão para NeuralSeek, consulte NeuralSeek

Setup de extensão ServiceNow

Para configurar a extensão para ServiceNow:

  1. Solicite uma Instância de Desenvolvedor Pessoal ServiceNow. Para instruções detalhadas, consulte Instâncias de Desenvolvedor Pessoal.

  2. Faça o download do arquivo de especificação OpenAPI: sn.openapi.json.

  3. Em seu assistente, na página Integrações, clique em Construir extensão customizada e use o arquivo de especificação OpenAPI para construir uma extensão personalizada. Para obter instruções gerais sobre como construir qualquer extensão customizada, consulte Construindo uma extensão customizada.

  4. Depois de construir a extensão ServiceNow e ela aparecer em sua página Integrações, clique em Adicionar para adicioná-lo ao seu assistente. Use o seu nome de usuário e senha admin ServiceNow para autenticar. Substitua a variável de servidor de instância padrão por sua própria. Para instruções gerais sobre adicionar qualquer extensão customizada, consulte Adicionando uma extensão ao seu assistente.

  5. Abra a página Ações.

  6. Se não tiver ações, escolha Criar uma nova ação. Se você já tem algumas ações, escolha Nova ação.

  7. Em Criar uma ação, escolha Início rápido com modelos.

  8. Em Iniciação rápida com modelos, inclua o kit do iniciador do ServiceNow

Configuração de extensão Zendesk

Para configurar a extensão para Zendesk:

  1. No Zendesk, abra o Admin Center, por exemplo, https://{server-domain}.zendesk.com/admin.

  2. Em Apps e integrações, clique em API de Zendesk.

  3. Na aba Configurações, ative o acesso de senha.

  4. Faça o download do arquivo de especificação OpenAPI: zendesk-openapi.json.

  5. Em seu assistente, na página Integrações, clique em Construir extensão customizada e use o arquivo de especificação OpenAPI para construir uma extensão personalizada. Para obter instruções gerais sobre como construir qualquer extensão customizada, consulte Construindo uma extensão customizada.

  6. Depois de construir a extensão do Zendesk e ela aparecer em sua página Integrações, clique em Adicionar para adicioná-la ao seu assistente. Use o seu nome de usuário e senha do Zendesk para autenticar. Para instruções gerais sobre adicionar qualquer extensão customizada, consulte Adicionando uma extensão ao seu assistente.

  7. Abra a página Ações.

  8. Se não tiver ações, escolha Criar uma nova ação. Se você já tem algumas ações, escolha Nova ação.

  9. Em Criar uma ação, escolha Início rápido com modelos.

  10. Em Iniciação rápida com modelos, inclua o kit do iniciador Zendesk.