> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superagentes.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Estágios de Conversação

> Divida as conversas do seu agente em estágios estruturados para interações mais precisas e controladas

## Visão Geral

Estágios de Conversação é uma funcionalidade poderosa que permite dividir o fluxo de conversação do seu agente em múltiplos estágios estruturados. Cada estágio possui objetivos específicos, instruções e regras de inferência que orientam como o agente processa e responde durante diferentes partes de uma conversa.

Esta funcionalidade permite um tratamento de conversas mais complexo e preciso, permitindo que seu agente:

* Identifique em qual estágio da conversa o usuário está
* Siga instruções específicas para cada estágio
* Use diferentes ferramentas e bases de conhecimento dependendo do estágio
* Faça transições entre estágios com base no contexto da conversa

## Benefícios

> **Conversas Estruturadas**
>
> Crie um fluxo lógico para conversas complexas com múltiplas etapas

> **Compreensão Contextual**
>
> Ajude seu agente a entender onde ele está na jornada da conversa

> **Uso Preciso de Ferramentas**
>
> Ative ferramentas específicas apenas quando forem relevantes para o estágio atual

> **Melhor Experiência do Usuário**
>
> Guie os usuários através de processos complexos com respostas apropriadas em cada etapa

## Como Funciona

Quando os Estágios estão habilitados, seu agente analisa cada mensagem recebida para determinar:

1. Em qual estágio a conversa está atualmente
2. Se deve fazer a transição para um estágio diferente
3. Quais instruções específicas seguir para o estágio atual
4. Quais ferramentas usar no contexto atual

O agente usa as regras de inferência que você define para tomar essas decisões, criando um fluxo de conversa dinâmico que se adapta às necessidades do usuário.

## Requisitos

* **Mínimo de Estágios**: Você precisa configurar pelo menos 2 estágios para que a funcionalidade funcione corretamente
* **Requisito de Plano**: Esta é uma funcionalidade exclusiva disponível nos planos Executivo e Gerencial

## Configurando Estágios

### Habilitando Estágios

1. Navegue até as configurações do seu agente
2. Selecione a aba "Estágios"
3. Ative o botão "Habilitar estágios" para ativar a funcionalidade
4. Clique em "Adicionar Estágio" para criar seu primeiro estágio

### Criando um Estágio

Cada estágio requer as seguintes informações:

| Campo | Descrição | Exemplo |
| - | - | - |
| Nome | Um nome curto e descritivo | "Identificação do Cliente" |
| Objetivo | O que precisa ser alcançado neste estágio | "Coletar nome e email do cliente para contato futuro" |
| Instruções | Orientações detalhadas para o agente | "1. Cumprimente o usuário de forma amigável 2. Explique que precisamos de algumas informações 3. Peça nome completo e email 4. Confirme os dados antes de prosseguir" |
| Regras de Inferência | Condições para ativar, reiniciar ou pular este estágio | "Ativar: Quando o usuário inicia a conversa Reiniciar: Se o usuário ainda não forneceu nome e email Pular: Se já temos o nome e email do usuário" |

### Ferramentas de Estágio

Você pode conectar ferramentas específicas a cada estágio:

1. Ao editar um estágio, navegue até a seção "Ferramentas"
2. Selecione entre as ferramentas disponíveis para adicioná-las a este estágio
3. As ferramentas só serão ativadas quando a conversa estiver neste estágio específico

### Conhecimento de Estágio

Da mesma forma, você pode conectar bases de conhecimento específicas a cada estágio:

1. Ao editar um estágio, navegue até a seção "Conhecimento"
2. Selecione entre as bases de conhecimento disponíveis para adicioná-las a este estágio
3. Estas bases de conhecimento só serão consultadas quando a conversa estiver neste estágio específico

## Gerenciando Estágios

### Reordenando Estágios

Você pode alterar a ordem dos estágios arrastando e soltando-os na lista de estágios. A ordem ajuda o agente a entender a progressão lógica da conversa.

### Editando Estágios

Para modificar um estágio existente:

1. Encontre o estágio na sua lista
2. Clique no ícone de edição (lápis)
3. Faça suas alterações
4. Clique em "Salvar Alterações"

### Excluindo Estágios

Para remover um estágio:

1. Encontre o estágio na sua lista
2. Clique no ícone de exclusão (lixeira)
3. Confirme a exclusão

> [!WARNING]
>
> Lembre-se que você precisa de pelo menos 2 estágios para que a funcionalidade funcione corretamente. Se você excluir estágios e tiver menos de 2 restantes, precisará adicionar mais estágios ou desabilitar a funcionalidade.

## Melhores Práticas

### Projetando Estágios Eficazes

* **Objetivos Claros**: Cada estágio deve ter uma meta clara e específica
* **Instruções Detalhadas**: Forneça instruções abrangentes sobre como o agente deve conduzir a conversa em cada estágio
* **Regras de Inferência Precisas**: Defina condições claras para quando um estágio deve ser ativado, reiniciado ou pulado
* **Progressão Lógica**: Organize os estágios em uma sequência lógica que guie o fluxo da conversa

### Exemplo de Estrutura de Estágios

Aqui está um exemplo de um fluxo de conversa de 5 estágios para suporte ao cliente:

1. **Identificação**
   * Objetivo: Coletar informações do cliente
   * Instruções: Pergunte nome, email e categoria do problema
   * Inferência: Ativar no início da conversa

2. **Análise do Problema**
   * Objetivo: Entender o problema específico
   * Instruções: Faça perguntas detalhadas sobre o problema
   * Inferência: Ativar após a identificação estar completa

3. **Verificação**
   * Objetivo: Confirmar o entendimento do problema
   * Instruções: Resuma o problema e confirme a precisão
   * Inferência: Ativar após a análise do problema

4. **Proposta de Solução**
   * Objetivo: Oferecer soluções potenciais
   * Instruções: Apresente opções baseadas no problema verificado
   * Inferência: Ativar após a verificação estar completa

5. **Resolução**
   * Objetivo: Confirmar a resolução do problema
   * Instruções: Verifique se a solução funcionou e ofereça ajuda adicional
   * Inferência: Ativar após uma solução ter sido proposta

## Solução de Problemas

### Problemas Comuns

* **Agente não transitando entre estágios**: Verifique suas regras de inferência para garantir que elas definam claramente quando mudar entre estágios
* **Ferramentas não ativando**: Verifique se as ferramentas estão corretamente conectadas aos estágios relevantes
* **Respostas inconsistentes**: Certifique-se de que suas instruções sejam claras e específicas para cada estágio

### Requisito Mínimo de Estágios

Se você ver um alerta sobre a necessidade de pelo menos 2 estágios:

1. Ou adicione mais estágios até ter pelo menos 2
2. Ou desabilite a funcionalidade de estágios (seus estágios existentes permanecerão salvos)

## Detalhes Técnicos

A funcionalidade de Estágios funciona através de:

1. Análise do histórico da conversa e da mensagem atual
2. Uso de um prompt especializado para determinar o estágio apropriado
3. Aplicação das instruções e ferramentas específicas para esse estágio
4. Geração de uma resposta baseada no contexto específico do estágio

Este processo acontece automaticamente para cada mensagem quando os estágios estão habilitados.

## Limitações

* Os estágios atualmente são limitados a conversas baseadas em texto
* Lógica de ramificação complexa pode exigir um design cuidadoso das regras de inferência
* A funcionalidade requer pelo menos 2 estágios para funcionar corretamente

## Perguntas Frequentes

> **Posso usar diferentes modelos de IA para diferentes estágios?**
>
> Atualmente, todos os estágios usam o mesmo modelo de IA que está configurado para o agente. Não é possível atribuir modelos diferentes a estágios diferentes.

> **Habilitar estágios afetará minhas conversas existentes?**
>
> Habilitar estágios afetará apenas novas conversas. Conversas existentes continuarão a usar a configuração anterior.

> **Posso testar os estágios antes de disponibilizá-los aos usuários?**
>
> Sim, você pode testar sua configuração de estágios iniciando uma conversa com seu agente na interface de teste antes de disponibilizá-lo aos usuários.

> **Quantos estágios posso criar?**
>
> Não há um limite rígido para o número de estágios que você pode criar, mas por questões práticas, recomendamos manter o número gerenciável (tipicamente 3-7 estágios).

> **Os estágios podem fazer loop ou se repetir?**
>
> Sim, suas regras de inferência podem ser projetadas para retornar a estágios anteriores quando certas condições forem atendidas, criando loops ou repetições conforme necessário.

## Próximos Passos

Após configurar seus estágios de conversação, você pode:

> **[Configurar Ferramentas](https://docs.superagentes.ai/agent/tool/overview.md)**
>
> Adicione ferramentas específicas para cada estágio

> **[Conectar Conhecimentos](https://docs.superagentes.ai/datastore)**
>
> Adicione bases de conhecimento específicas para cada estágio

> **[Configurar Subagentes](https://docs.superagentes.ai/agent/subagents/subagents.md)**
>
> Utilize subagentes para tarefas especializadas em diferentes estágios

> **[Testar Integrações](https://docs.superagentes.ai/agent/integration/overview.md)**
>
> Teste seus estágios em diferentes canais de comunicação


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.