> ## 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.

# Como criar e configurar um AI Agent

> Crie, configure, teste, publique e atribua um AI Agent.

## 1. Criar um AI Agent

<Tip>
  Um AI Agent recém-criado permanece como rascunho. Conclua a configuração, teste-o no Preview e clique em **Publish** antes de atribuí-lo a um número do WhatsApp.
</Tip>

No console da YCloud, abra **AI Agent** e clique em **Create Agent**.

1. Insira um nome para o Agent.
2. Selecione a função que melhor se adapta ao seu caso de uso.
3. Preencha as informações obrigatórias e clique em **Create**.

<Frame caption="Select a role that matches the customer task. This example shows Customer service before creation.">
  <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 quatro opções de função." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-create-service-annotated.svg" />
</Frame>

| Função | Mais indicado para |
| - | - |
| Lead acquisition | Captura e qualificação de leads. Selecione os atributos de contato que o Agent deve salvar durante a criação. |
| Shop assistant | Ajudar os clientes a encontrar e conhecer produtos. |
| Customer service | Responder a perguntas frequentes e oferecer suporte 24 horas por dia, 7 dias por semana. |
| Custom agent | Criar um Agent para um caso de uso personalizado. Descreva suas responsabilidades e objetivos durante a criação. |

***

## 2. Configurar o Agent

### Profile

* **Basic:** Adicione o nome, a descrição e o contexto da marca. As informações sobre a marca ajudam o Agent a entender seu setor, produtos e serviços.
* **Guidance:** Selecione o tom de voz e o idioma de fallback. Use Instructions para definir a função, o estilo de resposta, o fluxo de trabalho e os limites do Agent.
* **Actions:** Configure ações como encerrar conversas, transferir para atendentes humanos, adicionar tags aos contatos e atualizar atributos de contato. Descreva com clareza quando cada ação deve ser executada.

<Check>
  **Dica:** Escreva etapas claras e específicas em Instructions. Especifique quando o Agent deve transferir o atendimento para um humano e quais informações ele nunca deve inventar.
</Check>

<Frame caption="Complete the profile, then use Preview to test the agent before publishing.">
  <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ções básicas do AI Profile e painel de Preview para um agente de demonstração." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-annotated.svg" />
</Frame>

### Capabilities

* **Skills:** Divida tarefas complexas em etapas para que o Agent possa seguir um fluxo de trabalho definido.
* **Knowledge base:** Adicione informações da empresa que o Agent pode usar para responder às perguntas dos clientes.

<Warning>
  **Quando as alterações entram em vigor:** As alterações em Profile e Skills exigem publicação. As alterações em Knowledge base entram em vigor imediatamente.
</Warning>

***

## 3. Visualizar e publicar

1. Insira perguntas comuns de clientes no painel **Preview** e analise as respostas.
2. Teste respostas da base de conhecimento, gatilhos de ações, transferência para humanos e perguntas inesperadas.
3. Clique em **Restart preview** quando quiser iniciar uma nova conversa de teste.
4. Quando o Agent estiver pronto, clique em **Publish**. Se o status for **Draft · Unpublished**, as alterações mais recentes não estão ativas.

***

## 4. Atribuir o AI Agent a um número do WhatsApp

Conclua e publique o Agent antes de atribuí-lo a um número.

Acesse **WhatsApp accounts > Settings > Inbox > Assignment**.

> **Selecione o número que você deseja que o AI Agent atenda.**

> **Configurações de atribuição**

Em **Assign to**, selecione **AI Agent** e, em seguida, escolha o AI Agent que deve gerenciar as conversas.

<Frame caption="Open Inbox > Assignment for the selected number, then choose AI Agent under Assign to.">
  <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="Menu de atribuição do Inbox do número do WhatsApp com a opção AI Agent." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/inbox-assignment-target-annotated.svg" />
</Frame>


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