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

# Melhores práticas para o YCloud AI Agent

> Projete fluxos baseados em regras confiáveis e experiências com o AI Agent.

Use estas práticas para configurar seu AI Agent para atendimento ao cliente, vendas e tarefas operacionais.

### 1. O que um AI Agent pode fazer por você?

O YCloud AI Agent oferece suporte a atendimento ao cliente, vendas e automação de processos no WhatsApp. Os cenários comuns incluem:

* **Atendimento ao Cliente**: Respostas automatizadas 24 horas por dia, 7 dias por semana para dúvidas frequentes, tratamento de solicitações e acolhimento de reclamações para aliviar a carga da equipe humana de atendimento.
* **Vendas e Captação de Clientes** : dê as boas-vindas aos visitantes de forma proativa, oriente-os a deixar informações de contato, recomende produtos, faça o acompanhamento de clientes potenciais e aumente a conversão de leads.
* **Processamento de Solicitações**: Consulta em autoatendimento de pedidos, informações da conta, processamento de serviços e verificação de informações para encurtar a jornada de atendimento.
* **Gerenciamento de Cancelamento de Inscrição**: Execute automaticamente operações de cancelamento, responda com precisão às solicitações de descadastramento dos usuários, evite envios em não conformidade, reduza taxas de reclamações e garanta a qualidade da conta.

### 2. Fluxo: processo padronizado, automatização fácil de alcançar

O Flow é adequado para cenários de negócios fixos, lineares e bem definidos. Por meio da configuração visual de arrastar e soltar, ele automatiza processos de negócios e reduz custos de manutenção.

#### Principais cenários de aplicação

1. **Gerenciamento automático de cancelamento de inscrição**

Quando um usuário envia palavras-chave como "unsubscribe", "sair" ou "TD", o Flow as reconhece automaticamente, adiciona o usuário à lista de cancelamento, interrompe o envio de mensagens de marketing simultaneamente e responde com uma mensagem de confirmação, tudo sem intervenção manual durante o processo.

<img src="https://mintcdn.com/lchnan/RN4tXfXENVvDu0Te/product-assets/b559263b2c-1-1.webp?fit=max&auto=format&n=RN4tXfXENVvDu0Te&q=85&s=8d6b95991af463fe282c1a7962d41542" alt="Captura de tela do produto YCloud" width="5820" height="2928" data-path="product-assets/b559263b2c-1-1.webp" />

2. **Envie automaticamente o menu principal por meio da mensagem de boas-vindas**

Quando o usuário inicia uma conversa pela primeira vez, uma mensagem de boas-vindas da marca é enviada automaticamente, exibindo o menu principal de opções (por exemplo, "1 Consultar produtos, 2 Solicitar serviços, 3 Falar com um atendente") e, com base no clique ou seleção do usuário, direciona para o fluxo da ramificação correspondente.

<img src="https://mintcdn.com/lchnan/RN4tXfXENVvDu0Te/product-assets/b5bf51f185-2.webp?fit=max&auto=format&n=RN4tXfXENVvDu0Te&q=85&s=a82b79135ef4149544c20c02b29a753f" alt="Captura de tela do produto YCloud" width="5820" height="2928" data-path="product-assets/b5bf51f185-2.webp" />

<img src="https://mintcdn.com/lchnan/RN4tXfXENVvDu0Te/product-assets/b89712665b-3.webp?fit=max&auto=format&n=RN4tXfXENVvDu0Te&q=85&s=3864a2f3be53bdb26694b0ffdd717bb1" alt="Captura de tela do produto YCloud" width="1600" height="900" data-path="product-assets/b89712665b-3.webp" />

3. **Reduza custos de manutenção com fluxos de agentes baseados em regras reutilizáveis**

Divida nós genéricos (como verificação de identidade e confirmação de informações) em Flows independentes, permitindo que outros cenários os referenciem e vinculem diretamente. Isso evita configurações duplicadas, unifica o ponto de manutenção e melhora a eficiência.

<img src="https://mintcdn.com/lchnan/WD-ixrYVrqB7b7aQ/product-assets/3adc1ac927-4.webp?fit=max&auto=format&n=WD-ixrYVrqB7b7aQ&q=85&s=b02e3bb653319975e1f4a7bbf31cc583" alt="Captura de tela do produto YCloud" width="5820" height="2928" data-path="product-assets/3adc1ac927-4.webp" />

### 3. AI Agent: resposta inteligente e eficiente para cenários complexos

O AI Agent possui capacidade de compreensão de intenções, julgamento lógico e execução de tarefas em várias etapas, sendo ideal para cenários que exigem interação flexível e tomadas de decisão complexas. Ele pode orientar proativamente, tomar decisões autônomas e chamar ferramentas para concluir tarefas.

#### (1) Cenários práticos

* **Atendimento inteligente ao cliente**: responde a dúvidas multidimensionais, gerencia reclamações, resolve problemas complexos, retém o contexto da conversa e proporciona uma interação humanizada.
* **Captura automática de leads**: orienta os usuários ativamente a fornecerem informações como nome, telefone e necessidades.
* **Guia de compras inteligente**: compreende as preferências do usuário, recomenda produtos, tira dúvidas sobre especificações, orienta na realização de pedidos e simula um atendimento exclusivo de consultoria de compras.

#### (2) Etapas de configuração recomendadas

1. **Selecione a função (Role) apropriada**

Com base no cenário, pré-defina as funções (atendimento ao cliente, vendas, consultor de compras etc.) e determine as funções principais e os estilos de comunicação, como o atendimento ao cliente com foco em respostas profissionais e vendas com foco em guiar a conversão.

<Frame caption="Choose a role that matches the task. This example shows Customer service.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-create-service-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=51661e4297cccf5c0cb2df1dc94d98d7" alt="Formulário de criação do AI Agent com Customer service selecionado." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-create-service-annotated.svg" />
</Frame>

2. **Configurar o perfil**

Preencha as informações básicas da função, incluindo nome, avatar, apresentação, estilo de linguagem e escopo de atendimento, para padronizar a imagem da marca.

Para obter mais detalhes, consulte: [AI Profile](/pt/documentation/agents/ai-agent/ai-profile)

<Frame caption="Configure the agent identity and instructions, then use Preview to test the behavior.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=3466b5ef4209a28b3ff415a80e051fdc" alt="Configuração e visualização prévia do AI Profile." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-annotated.svg" />
</Frame>

3. **Configurar a base de conhecimento**

Faça upload de documentos de produtos, FAQs, manuais de negócios, termos de políticas etc., com suporte a formatos de documento, página web e P\&R para garantir respostas precisas e em conformidade.&#x20;

Para obter mais detalhes, consulte: [ Base de conhecimento de IA](/pt/documentation/agents/ai-agent/ai-knowledge-base)

<Frame caption="Select Add knowledge to choose a document, website, Q&A pair, or attachment.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-knowledge-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=13fb54ebe5a0d887655629b635facaa0" alt="Lista de conhecimento com a opção Add knowledge destacada." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-knowledge-annotated.svg" />
</Frame>

4. **Configurar Skills**

Crie uma Skill para cada tarefa repetível. Defina quando a Skill deve iniciar, os passos que o AI Agent deve seguir e quando ele deve utilizar uma ação nativa ou um Data Connector.

Para mais detalhes, veja [AI Skills](/pt/documentation/agents/ai-agent/ai-skills).

<Frame caption="Define when the Skill should start, then write its step-by-step instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-skill-create-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=3a034063698d0a90839f4dacec5db19b" alt="Editor de habilidades com o gatilho inicial destacado." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-skill-create-annotated.svg" />
</Frame>

Quando for necessário integrar com sistemas externos, configure a interface de API por meio do Conector de Dados ([Data Connector](/pt/documentation/integrations/data-connectors)) para implementar operações como consultar pedidos e verificar informações, capacitando a IA com recursos de execução. Recomenda-se começar com processos padrão e repetitivos e configurar conectores de dados.&#x20;

Para obter detalhes, consulte [Data Connector](/pt/documentation/integrations/data-connectors)

<img src="https://mintcdn.com/lchnan/RN4tXfXENVvDu0Te/product-assets/cbe8e5fb3b-10.webp?fit=max&auto=format&n=RN4tXfXENVvDu0Te&q=85&s=e281a2dade87d744dece77283e0ab30e" alt="Captura de tela do produto YCloud" width="5820" height="2928" data-path="product-assets/cbe8e5fb3b-10.webp" />

<img src="https://mintcdn.com/lchnan/AlSk34JesCiO_ZYy/product-assets/dbb5da31d0-11.webp?fit=max&auto=format&n=AlSk34JesCiO_ZYy&q=85&s=17b3c5ea1181a37a81a1a4d9ac28c8e2" alt="Captura de tela do produto YCloud" width="5820" height="2928" data-path="product-assets/dbb5da31d0-11.webp" />

5. **Configurar regras de atribuição**

Após concluir a configuração da IA, atribua as sessões recebidas à IA correspondente para processamento nas configurações de número para melhorar a eficiência do atendimento.&#x20;

Para obter detalhes, consulte: [Regras de atribuição de conversas](/pt/documentation/channels/whatsapp-accounts-management/phone-number-management/conversation-assignment-rules)

<Frame caption="Select AI Agent under Assign to for the business number that should use it.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/inbox-assignment-target-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=16e8a6d729c7a835c86c0511190cb978" alt="Configurações de atribuição da caixa de entrada com o AI Agent no menu Atribuir a." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/inbox-assignment-target-annotated.svg" />
</Frame>

#### (3) Melhores práticas

**1. Esclarecimento das instruções de tarefas (práticas recomendadas vs. não recomendadas)**

**① Cenário de geração de leads**

* ❌ Prática não recomendada: "Você deve coletar as informações do cliente e depois armazená-las."
* ✅ Prática recomendada: "Você é um especialista em coleta de leads de produtos de empréstimo, responsável por orientar educadamente os usuários a fornecerem nome, telefone de contato, valor do empréstimo e localização. Após coletar todas as informações, sincronize-as com o CRM. Para qualquer informação ausente, solicite-a uma a uma para garantir que nenhum campo seja esquecido."

**② Cenário de atendimento ao cliente**

* ❌ Prática não recomendada: "Apenas ajude o cliente a resolver problemas."
* ✅ Prática recomendada: "Você é um representante de atendimento financeiro, responsável por responder a dúvidas sobre consultas de conta, pagamentos, taxas, etc. Responda estritamente de acordo com a Base de Conhecimento, não prometa nada fora do escopo, acalme os clientes primeiro ao lidar com reclamações e transfira para o atendimento humano quando não conseguir resolver os problemas."

**③ Cenário de guia de compras**

* ❌ Prática não recomendada: "Você recomenda produtos aos clientes e pede para que comprem."
* ✅ Prática recomendada: "Como guia de compras de e-commerce, primeiro pergunte sobre as necessidades, orçamento e preferências do usuário, recomende de 2 a 3 produtos correspondentes, explique suas vantagens, preços e especificações, oriente o usuário a fazer o pedido quando ele hesitar e informe-o prontamente em caso de problemas de estoque."

**2. Otimização da configuração de ferramentas**

**① Configuração da Base de Conhecimento**

* Gerenciamento de classificação: classifique por produto, negócio e FAQ para facilitar a busca precisa pela IA.
* Diretrizes de conteúdo: as respostas devem ser concisas, precisas e inequívocas; setores como o financeiro precisam incluir lembretes de conformidade.
* Atualização dinâmica: sincronize regularmente novas políticas e produtos, remova conteúdos expirados e garanta a atualização das informações.
* Complementar dados desconhecidos: quando a IA não conseguir responder, registre a pergunta e complemente-a manualmente, otimizando continuamente a Base de Conhecimento.

**② Configuração de Skills com Data Connectors**

* Definir cenários: configure apenas as interfaces necessárias, como configurar "Consulta de Conta" para o cenário de atendimento ao cliente.
* Parâmetros de especificação: defina os parâmetros de solicitação/resposta, esclareça o significado dos campos, formatos e campos obrigatórios para evitar falhas de chamada.
* Tratamento de exceções: configure novas tentativas em caso de falha e avisos de erro, como "Falha na consulta, tente novamente mais tarde", para melhorar a experiência do usuário.
* Controle de permissões: restrinja operações sensíveis e adicione etapas de revisão manual para cenários financeiros a fim de evitar riscos.

### 4. Exemplo: Atendimento financeiro ao cliente

Uma equipe de serviços financeiros pode usar um AI Agent para responder a perguntas comuns, coletar detalhes de leads e transferir solicitações complexas ou sensíveis para um atendente humano.

#### Configuração recomendada

1. **Perfil:** Defina uma função profissional e paciente e especifique quais tópicos financeiros o AI Agent não deve responder sem informações aprovadas.
2. **Base de conhecimento:** Adicione conteúdos atualizados sobre produtos, pagamentos, tarifas e tratamento de reclamações. Remova políticas desatualizadas prontamente.
3. **Skills:** Crie Skills focadas para tarefas como consulta de conta ou registro de reclamações. Valide a identidade antes de exibir informações específicas do cliente.
4. **Data Connectors:** Conecte apenas os sistemas exigidos por cada Skill e defina o comportamento em caso de falha e contingência.
5. **Transferência:** Transfira solicitações que exijam julgamento humano, aprovação ou acessos que o AI Agent não possui.

Comece com um caso de uso focado, teste conversas realistas e revise os resultados regularmente. Aprimore a Base de conhecimento, Perfil, Skills e fluxos baseados em regras ao identificar lacunas recorrentes.


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