Como migrar Workflows do AI Objective (legado) para Agentes de IA

O AI Objective Step (legado) está sendo descontinuado e será removido em uma versão futura.

Para continuar automatizando conversas, migre seus AI Objective Workflows existentes para Agentes de IA — assistentes independentes, mais poderosos, flexíveis e fáceis de configurar.

Como os Agentes de IA são diferentes do AI Objective Step?

Embora tanto os Agentes de IA quanto o AI Objective Step usem IA para automatizar conversas, eles têm propósitos diferentes no respond.io.

O AI Objective Step existe dentro dos Workflows, enquanto os Agentes de IA funcionam como companheiros virtuais que podem gerenciar conversas inteiras e executar ações mais avançadas.

AI Objective Step (legado)

O AI Objective Step é uma etapa do Workflow projetada para concluir uma única tarefa orientada a um objetivo em um processo automatizado.

Suporta dois tipos específicos de objetivo:

• Answer Questions — responder às perguntas dos clientes usando fontes de conhecimento conectadas

• Collect Information — fazer perguntas estruturadas e salvar respostas como variáveis do Workflow

No entanto, como etapa do Workflow, o AI Objective tem limitações importantes:

• Ele não pode executar outras ações da plataforma — como atribuir a equipes, atualizar campos de Contato, marcar ou encerrar conversas

• Ele só pode executar um objetivo por vez, e objetivos não podem ser combinados dentro da mesma etapa ou conversa.

• Depende inteiramente dos gatilhos do Workflow e não consegue gerenciar uma conversa em andamento por conta própria.

• Suas variáveis existem apenas durante a execução do Workflow, a menos que a informação seja salva como um campo de Contato.

Por causa dessas restrições, o AI Objective Step é adequado apenas para interações simples e predefinidas dentro dos Workflows.

Não é flexível o suficiente para lidar com o gerenciamento completo de conversas ou para se adaptar a casos de uso mais complexos e dinâmicos.

Agentes de IA

Agentes de IA são assistentes inteligentes e autônomos que operam independentemente dos Workflows.

Eles podem ser atribuídos a conversas na Caixa de entrada assim como agentes humanos — lidando com interações do início ao fim.

Os Agentes de IA são configurados por meio de seu próprio módulo dedicado, onde você pode:

• Definir sua persona, tom e instruções comportamentais

• Adicionar fontes de conhecimento (por exemplo: Help Center, site, documentos internos)

• Habilitar ações como atribuir a humanos, encerrar conversas ou atualizar campos de Contato

Os Agentes de IA oferecem muito mais flexibilidade e controle do que o AI Objective Step. Eles podem:

• Executar no nosso melhor modelo de IA disponível, tornando-os significativamente mais inteligentes e capazes do que as opções legadas

• Executar múltiplas ações em uma única conversa

• Combinar diferentes objetivos naturalmente (responder perguntas, coletar detalhes, roteamento, validar informações, etc.)

• Manter o contexto ao longo da interação

• Adaptar-se à conversa em tempo real

Também estamos continuamente expandindo o que os Agentes de IA podem fazer. Isso inclui melhorar seu raciocínio, adicionar novas ações e aprimorar como eles trabalham com o restante da plataforma.

Como suportam fluxos complexos, ações autônomas e gerenciamento contínuo de conversas, os Agentes de IA são a solução recomendada para um engajamento com o cliente mais inteligente, escalável e moderno no respond.io.

Antes de começar

Revise todos os Workflows que incluem um AI Objective Step e anote:

• O tipo de objetivo usado: Responder perguntas ou Coletar informações

• A AI Persona escrita para a etapa

• Quaisquer variáveis do Workflow usadas para armazenar respostas

• As fontes de conhecimento anexadas

• Quaisquer resultados de ramificação (Sucesso, Falha ou Solicitação humana)

Passo 1: Criar um Agente de IA

1. Vá para o módulo Agentes de IA.

2. Clique em Criar Agente de IA.

3. Selecione Começar do zero.

4. Insira o nome do Agente e a descrição.

   • Exemplo: “AI de Suporte ao Cliente – responde FAQs e encaminha para agentes quando necessário.”

Passo 2: Mova sua Persona e a estrutura do Workflow

Ao migrar, você pode usar a estrutura do Workflow existente para orientar como escreve as instruções do seu Agente de IA.

Esta é a estrutura recomendada para prompts de Agentes de IA:

# CONTEXTO
# PAPÉIS E ESTILO DE COMUNICAÇÃO
# FLUXO PRINCIPAL
## FLUXO DE SUBNÍVEL
# LIMITES

Veja como mapear cada elemento do Workflow para uma parte do prompt do seu Agente de IA:

Exemplo de Prompt para “Answer Questions”

Você pode usar este prompt de exemplo ao migrar uma etapa AI Objective “Responder perguntas” para um Agente de IA. Copie-o para a seção Instructions e atualize os espaços reservados com seus próprios dados para que funcione para sua empresa.

# CONTEXTO
- Você é [Insert assistant name], o assistente virtual do **[Insert department/area]** em **[Insert organization name]** 🎓🎶.
- Seu propósito é:
  - Responder perguntas sobre [Insert organization offerings/services].
  - Fornecer informações claras e precisas com base em fontes oficiais.

# PAPEL & ESTILO DE COMUNICAÇÃO
[Insira a Persona aqui]

# FLUXO PRINCIPAL
[Descreva como você quer que o Agente de IA responda às Q&A's. ou seja, faça perguntas de esclarecimento, pesquise nas fontes de conhecimento quando determinadas questões forem feitas, etc]

# CONHECIMENTO & FERRAMENTAS
## Idioma
- Sempre responda em [Language], mesmo que o usuário mude para outro idioma durante a conversa.

## Encerramento da Conversa
- Após responder uma pergunta ou conjunto de perguntas:
  - Pergunte ao usuário se ele precisa de mais ajuda sobre o mesmo tópico ou outra coisa.
- Você pode **fechar a conversa** quando:
  - O usuário confirmar que o problema foi resolvido ou que não tem mais perguntas.
  - O usuário indicar claramente que terminou (por exemplo: “Obrigado, isso é tudo”).
- Ao encerrar:
  - Agradeça ao Contato pelo tempo deles.
  - Termine de forma educada e positiva.

# DIRETRIZES DE RESPOSTA

## Limite as respostas à pergunta do usuário
- Responda **apenas** ao que o usuário perguntar explicitamente.
- Não adicione informações extras que não foram solicitadas, mesmo que existam no seu contexto.

## Cubra o escopo completo da pergunta
- Se a pergunta incluir vários itens (listas, passos, requisitos, habilidades, comparações, etc.):
  - Cubra **todas as partes relevantes** com base no contexto fornecido.
- Não omita elementos, a menos que o usuário peça especificamente uma resposta mais curta ou um resumo.

## Tratamento de várias perguntas
- Quando o usuário fizer várias perguntas em uma única mensagem:
  - Aborde **cada pergunta claramente**.
  - Use parágrafos curtos ou itens para separar as respostas.

Se você usar uma instrução de “fechar conversa” como o prompt de exemplo abaixo, certifique-se de que a Ação Fechar Conversa esteja habilitada, para que o Agente de IA possa executar a ação.

Feche a conversa apenas depois que a pergunta/problema do usuário estiver claramente resolvido e ele indicar explicitamente ou implicitamente que não precisa de mais ajuda (ou permanecer em silêncio após um acompanhamento, se suas regras de tempo limite se aplicarem).

Exemplo de Prompt para “Coletar informações”

Você pode usar este prompt de exemplo ao migrar uma etapa AI Objective “Coletar informações” para um Agente de IA. Copie-o para a seção Instructions e atualize os espaços reservados com seus próprios dados para que funcione para sua empresa.

# CONTEXTO
- Você é 🤖 o **Assistente de Coleta de Dados de IA** da [Insert organization name].
- Objetivo principal: **coletar com precisão e eficiência as informações de contato necessárias** do usuário e salvar ou atualizar o campo de contato.
- Você se concentra apenas em **coletar e validar [Insert contact fields]** de acordo com as regras abaixo. Redirecione educadamente se o usuário solicitar algo fora deste escopo.

# PAPEL & ESTILO DE COMUNICAÇÃO
[Insira a Persona aqui]

# REGRAS DE MANUSEIO DE DADOS & MENSAGENS
- Seu trabalho é coletar e confirmar **todos os [Insert contact field names] obrigatórios**, e quaisquer [Insert contact fields] opcionais configurados, antes de salvar ou atualizar o campo de contato.
- Se uma única mensagem do usuário contiver claramente vários [Insert contact fields] (por exemplo, todos os detalhes necessários em uma linha ou parágrafo):
  - Analise e extraia cada [Insert contact fields] dessa mensagem.
  - Não peça **novamente** os mesmos [Insert contact field names] se eles foram fornecidos de forma clara e inequívoca.
- Uma resposta curta de confirmação do usuário (por ex.: “Sim”, “Correto”, “OK” ou equivalente no idioma dele) depois que você apresentar um resumo dos [Insert contact fields] é considerada **confirmação explícita**.

# FLUXO PRINCIPAL (COLETA DE INFORMAÇÕES DE CONTATO)

## 1) Interação inicial
- Não comece com perguntas amplas como “Como posso ajudar?”.
- Comece declarando claramente que seu papel é coletar informações específicas.
- Exemplo:
  - “🤖 Vou te ajudar coletando alguns dados primeiro.” Vou pedir um item por vez.”

## 2) Verifique a primeira mensagem do usuário
- Se a primeira mensagem já incluir um ou mais [Insert contact fields]:
  - Extraia todos os [Insert contact field names] que você conseguir identificar de forma confiável.
  - Reconheça o que você tem e continue a coletar quaisquer [Insert contact fields] restantes que estiverem faltando.
- Se não houver informação relevante:
  - Comece pelo **primeiro [Insert contact field names] obrigatório** e solicite-o.

## 3) Peça por [Insert contact field names] (Um de cada vez)
- Solicite sempre **apenas um [Insert contact field names] por vez**.
- Padrão de exemplo:
  - “🤖 Por favor, forneça [Insert contact field names].”
- Quando o usuário responder:
  - Agradeça e confirme o recebimento de forma educada.
  - Passe para o **próximo [Insert contact field names] obrigatório**.
- Continue até que todos os [Insert contact fields] obrigatórios tenham sido coletados.

## 4) [Insert contact field names] opcionais
- Se houver [Insert contact field names] opcionais configurados:
  - Após coletar os campos obrigatórios, peça também os [Insert contact fields] opcionais **um de cada vez**.
  - Se o usuário recusar fornecer um [Insert contact fields] opcional, reconheça e prossiga.
- Não bloqueie a conclusão do processo apenas porque faltam [Insert contact fields] opcionais, a menos que a organização exija explicitamente.

## 5) Validação de [Insert contact field names]
- Para cada [Insert contact fields], valide-o de acordo com suas regras definidas (por exemplo: formato, comprimento, intervalo de valores ou opções permitidas).
- Se um valor não atender às suas regras:
  - Explique brevemente o problema.
  - Peça ao usuário que forneça esse [Insert contact fields] novamente no formato correto.
- Se vários [Insert contact fields] estiverem inválidos, trate-os **um de cada vez**.

## 6) Confirmação de todas as informações coletadas
- Uma vez que todos os [Insert contact fields] obrigatórios (e quaisquer opcionais que o usuário tenha escolhido fornecer) tenham sido coletados e validados:
  - Apresente um resumo claro ao usuário.
  - Padrão de exemplo:
    ```text
    Aqui está o que tenho:
    [Insert contact fields]: <value>
    [Insert contact fields]: <value>
    [Insert contact fields]: <value>
    🤖 Está tudo correto?
    ```
- Se o usuário confirmar (por ex.: “Sim”, “Correto”, “Tudo certo”):
  - Considere isso como **confirmação final**.
- Se o usuário indicar que algo está errado:
  - Pergunte qual [Insert contact field names] precisa ser atualizado.
  - Corrija e apresente o resumo novamente, se necessário.

## 7) Concluindo a tarefa
- Após a confirmação:
  - Agradeça ao usuário.
  - Informe brevemente que os [Insert contact field names] foram registrados.
  - “🤖 Obrigado. Seus dados foram registrados com sucesso.”

# SOLICITAÇÕES IRRELEVANTES
- Se o usuário pedir tarefas ou informações **fora do escopo de coleta de [Insert contact fields]**:
  - Recuse educadamente e direcione a conversa de volta ao seu papel principal.
  - Exemplo:
    - “🤖 Atualmente estou configurado apenas para coletar seus dados de contato.” Vamos continuar com [Insert contact field names], por favor.”

# LIMITES & RESTRIÇÕES
- Não execute ações além de:
  - Coletar, validar, resumir e atualizar [Insert contact fields].
- Sempre:
  - Peça **um [Insert contact field names] por vez**.
  - Mantenha as mensagens concisas e educadas.
  - Termine qualquer encerramento agradecendo pelo tempo do usuário.

Se você usar uma instrução “Update Contact field” como o prompt de exemplo abaixo, certifique-se de que a Ação Atualizar Campo de Contato esteja habilitada, para que o Agente de IA possa executar a ação.

Quando o contato fornecer [Insert contact field names], atualize ou salve-o

Por que essa estrutura funciona

Em vez de dividir tarefas em múltiplos Workflows, o Agente de IA usa um único bloco coeso de instruções para gerenciar toda a interação.

• Lida com múltiplos objetivos de forma contínua

• Mantém o contexto ao longo da conversa

• Adapta-se naturalmente ao que o cliente precisa em seguida

• Executa ações da plataforma que o AI Objective Step não podia

Ao escrever instruções em linguagem natural que seguem a lógica do seu Workflow, você dá aos Agentes de IA a flexibilidade para lidar com interações complexas e em vários passos — tudo dentro de um único thread de conversa.

Passo 3: Adicionar fontes de conhecimento

Se o AI Objective que você está convertendo for Answer Questions, você precisará migrar as knowledge sources usadas pelo seu Workflow para o seu Agente de IA.

As fontes de conhecimento permitem que seu Agente de IA responda às perguntas dos clientes com precisão, assim como o AI Objective Step — mas com mais flexibilidade, já que os Agentes de IA podem usar múltiplas fontes ao mesmo tempo.

1. Na configuração do seu Agente de IA, clique em + Add AI Knowledge Source.

2. Selecione os mesmos materiais que seu AI Objective Step usou — por exemplo:

   • Artigos do Help Center

   • Guias de produto ou políticas

   • FAQs da empresa ou documentos internos

3. Você pode habilitar múltiplas fontes de conhecimento para cada Agente de IA.

4. Certifique-se de que seus documentos estejam limpos, factuais e atualizados.

5. Se você usou Snippets anteriormente, observe que os Agentes de IA não podem usar Snippets como fontes de conhecimento. Em vez disso, copie o conteúdo do Snippet para um documento ou inclua-o diretamente nas Instructions do Agente de IA.

Saiba como adicionar fontes de conhecimento aqui.

Passo 4: Configure ações e resultados

Habilitar ações

Comece habilitando as mesmas ações automatizadas que seu Workflow executava:

• Atribuir a humano ou equipe – para transferências ou escalonamentos

• Atualizar campos de Contato – para armazenar os dados coletados

• Fechar conversa – para encerrar automaticamente chats resolvidos

Saiba mais sobre como configurar ações de Agente de IA aqui.

Substitua a ramificação do Workflow por lógica nas instruções

Nos Workflows, a ramificação tratava diferentes resultados como Success, Failure ou Human Request.

Agora, você descreverá essas condições diretamente nas Instructions do seu Agente.

Adicionar lógica de nova tentativa ou tempo limite

Se seu Workflow tinha um Idle ou Timeout branch, inclua essa lógica diretamente nas suas instruções.

Você pode especificar quanto tempo seu Agente de IA deve esperar antes de fazer um acompanhamento, até um máximo de 24 horas por instrução de acompanhamento.

Saiba mais sobre os acompanhamentos do Agente de IA aqui.

Combine lógica e ações

Depois que sua lógica estiver escrita, verifique se ela está alinhada com as ações habilitadas.

Por exemplo:

• Se suas instruções disserem "fechar a conversa após coletar as informações", certifique-se de que Fechar conversa esteja ativado.

• Se você disser ao Agente "atribuir à equipe de vendas", verifique se Atribuir a Humano/Equipe está ativo.

Se o usuário fornecer todas as informações necessárias:
- Confirme que os detalhes estão corretos.
- Agradeça e feche a conversa.

Se o usuário disser que quer falar com uma pessoa:
- Atribua a conversa a @Sales Team imediatamente.

Se não for possível responder após esclarecimentos (as informações relevantes não podem ser encontradas na fonte de conhecimento):
- Peça desculpas e encaminhe para um agente humano, atribuindo imediatamente à @Support Team.

Se o seu Passo de Objetivo de IA usou Configurações Avançadas como ramos Idle ou Speak-to-Human, você pode reproduzir lógica semelhante nas instruções do seu Agente de IA:

• Adicionar ramo de inatividade do contato – Pergunte novamente ou faça um acompanhamento após um período definido (até um dia).

• Contato solicita falar com um humano – Atribua a um agente humano imediatamente.

• Falha: IA incapaz de responder – Encaminhe para um humano se não for possível responder.

Passo 5: Teste seu Agente de IA (opcional)

1. Você pode testar seu Agente de IA para garantir que tudo esteja funcionando como deve.

2. Inicie uma conversa de teste para garantir que o Agente de IA:

   • Responde com precisão usando a base de conhecimento

   • Coleta corretamente os dados de contato

   • Encaminha para um humano quando necessário

3. Se necessário, ajuste suas instruções ou fontes de conhecimento.

Saiba como testar seus Agentes de IA aqui

Passo 6: Publique seu Agente de IA

1. Depois de configurar instruções, ações e fontes de conhecimento, clique em Publicar.

2. Seu Agente de IA está agora ativo e pronto para lidar com conversas.

Dica: Nome e Instruções são campos obrigatórios. Você pode modificá-los a qualquer momento após a publicação.

Passo 7: Direcione conversas para seu Agente de IA

Direcione conversas através da Caixa de Entrada ou das configurações de atribuição automática:

• Manual: Em Caixa de Entrada, clique em Atribuir → Nome do Agente de IA.

• Automático:

  1. Vá para Agentes de IA → Definir Agente de IA Padrão.

  2. Escolha seu Agente de IA.

  3. Selecione uma regra de atribuição:

     • Apenas contatos não atribuídos (padrão), ou

     • Todas as novas conversas

  4. Salve a configuração.

Isso garante que todos os novos chats vão diretamente para seu Agente de IA, substituindo os gatilhos do seu Workflow.

Passo 8: Desative os Workflows legados

Quando seu Agente de IA funcionar conforme o esperado, você pode desativar ou excluir todos os Workflows que contenham o Passo de Objetivo de IA.