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

# Perfil de IA

> Configure a personalidade e a referência de fluxo de trabalho do agente de IA para atender aos requisitos de serviços de marca personalizados

Use o Perfil de IA para configurar o contexto da marca, as instruções e as ações do seu agente. Teste a configuração no Preview antes de publicar.

## Escolha uma função para o agente de IA

Crie um agente de IA e escolha a função que deseja que ele desempenhe.

<Frame caption="Choose the role that best matches the task you want the agent to handle.">
  <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 de agente de IA mostrando as funções disponíveis e a opção Atendimento ao cliente selecionada." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-create-service-annotated.svg" />
</Frame>

## Início rápido

Já pré-configuramos todas as definições básicas. Você pode preencher diretamente as informações da sua marca e, em seguida, conversar com a IA no painel de visualização à direita para ver como ela funciona. Se precisar ajustar as configurações da IA, basta acessar a seção específica e editá-las.

<Frame caption="Complete the agent profile and use Preview to test it 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 do Perfil de IA com informações básicas e o painel de visualização." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-annotated.svg" />
</Frame>

### Escrevendo instruções

Neste módulo, você pode instruir a IA sobre o fluxo de trabalho geral que ela deve seguir, o estilo de comunicação a ser usado, como lidar com limites operacionais e muito mais. Recomendamos dividir as orientações em várias partes:

| **Componente de prompt** | **Para que é usado** | **Exemplo** |
| - | - | - |
| **Fluxo de trabalho** | Passo a passo, instrua o agente de IA sobre como orientar a interação com o usuário. | **1. Cumprimente:** Dê as boas-vindas ao usuário de maneira calorosa e educada.  <br />**2. Entenda a necessidade:** Pergunte o que ele está procurando, confirme brevemente a resposta e evite perguntas em sequência rápida.  <br />**3. Ofereça valor rápido:** Destaque um benefício relevante em no máximo 1 a 2 frases.  <br />**4. Colete informações de contato:** Depois de fornecer valor, solicite naturalmente os campos necessários um de cada vez, como e-mail ou apelido. Não solicite informações desnecessárias.  <br />**5. Lide com o interesse:** Se o usuário demonstrar forte interesse, ofereça uma demonstração ou uma conversa com um especialista. Escale para o suporte humano se ele concordar.  <br />**6. Encerre:** Pergunte se há algo mais em que possa ajudar, agradeça ao usuário e finalize educadamente. |
| **Contexto** | Descreva com quem o agente de IA está interagindo e o objetivo principal da conversa. | Você está conversando com alguém que está conhecendo nosso produto ou serviço. Seu objetivo é responder às dúvidas iniciais e coletar as informações do cliente necessárias para o acompanhamento. |
| **Função e estilo de comunicação** | Explique a função que o agente de IA deve desempenhar, o tom a ser usado e como ele deve se comunicar. | Você é um consultor de vendas amigável, prestativo e acessível que nunca pressiona. Faça uma pergunta de cada vez. Mantenha as respostas claras, encorajadoras e com no máximo duas frases. |
| **Tratamento de acompanhamento** | Instrua o agente de IA sobre o que fazer caso o usuário não responda, incluindo quanto tempo esperar e qual ação tomar. | Se não houver resposta após 5 minutos, envie: "Olá, só para saber se você ainda está por aí?" Se ainda não houver resposta após mais 5 minutos, envie uma mensagem educada de encerramento e finalize a conversa. A duração máxima do temporizador é de 60 minutos. |
| **Tratamento de fallback** | Explique como responder quando a solicitação do usuário for incerta, incompleta ou estiver fora das capacidades do agente de IA. | Se não entender a intenção do usuário, primeiro confirme-a de forma amigável. Se ainda não estiver claro, escale para o suporte humano. |
| **Limites** | Defina o que o agente de IA não deve tentar fazer, como fornecer aconselhamento jurídico, médico ou financeiro. | Não invente fatos, processos, preços ou políticas que não estejam cobertos nas instruções. Não compartilhe informações confidenciais. Mantenha-se na sua função e nunca faça suposições, opiniões ou promessas sem embasamento. |

### Escrevendo prompts de ações

Com base nas orientações, você pode definir ações que são acionadas em determinados cenários especiais. Fora do fluxo de trabalho guiado, se ocorrer um cenário descrito abaixo em uma conversa com o usuário, a IA também executará uma ação de acordo com os requisitos do seu prompt.

Para cada ação, descreva:

* **Quando** deve acontecer (condições)
* O que o agente de IA deve fazer

| **Ação** | **O que você pode escrever no prompt** | **Exemplo** |
| - | - | - |
| **Encerrar conversa** | Diga ao agente quando a conversa pode terminar e se ele deve enviar uma mensagem de encerramento. | Encerre a conversa quando o contato confirmar que o problema foi resolvido e que não precisa de mais ajuda. |
| **Encaminhar para suporte humano** | Defina as situações em que a IA deve transferir a conversa para um agente ou equipe específica. | Se o usuário solicitar um atendente humano, transfira para John. Se o usuário precisar de ajuda com uma solicitação de reembolso, transfira para a Equipe de Suporte. |
| **Adicionar tag de contato** | Descreva as condições sob as quais uma tag específica deve ser adicionada ao contato. | Se o usuário demonstrar forte intenção de compra, adicione a tag "Intenção de compra". Se o usuário estiver interessado no Produto A, adicione a tag "Produto A". |
| **Atualizar propriedades do contato** | Diga ao Agente de IA quando as propriedades do contato devem ser atualizadas e quais propriedades ele tem permissão para alterar. | Atualize os campos relevantes quando o usuário fornecer ou confirmar `{{Contact.Email}}` ou `{{Contact.Order_address}}`. |

As ações só podem ser disparadas de forma independente quando estiverem ativadas. Se uma ação específica estiver desativada, ela ainda poderá ser usada nas instruções, mas não poderá ser acionada de forma independente fora das instruções. Isso significa que, embora a ação continue disponível em instruções predefinidas ou playbooks, ela não poderá ser ativada em outros contextos até que seja reativada.

### Usando variáveis, transbordo e tags de contato

<Frame caption="Select Variables to insert a contact field into your instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-variables-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=dda97b51d22139bfe8cd08dea3013c18" alt="Menu de variáveis aberto a partir das instruções do Perfil de IA." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-variables-annotated.svg" />
</Frame>

**Variáveis**

**O que são variáveis?**

As variáveis permitem referenciar informações específicas de contato nos prompts de IA. Pense nelas como marcadores de posição que são preenchidos automaticamente com dados reais do cliente.

**Como elas funcionam?**

Sempre que precisar mencionar detalhes do contato, como nome, e-mail, histórico de compras ou quaisquer campos personalizados que você criou, basta adicionar variáveis no prompt. O agente de IA pode entender de forma inteligente quando:

* Ler valores de campos (por exemplo, "Olá `{{contact.name}}`")
* Atualizar campos com base no contexto da conversa (por exemplo, “Colete o `{{contact.phone_number}}` do cliente durante a conversa.”)

**Transbordo humano**

<Frame caption="Select Hand off to choose the destination used by your instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-handoff-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=cf88b33447a070b1d0676d61e8e4b2c3" alt="Menu de transbordo com opções de roteamento para equipes e agentes." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-handoff-annotated.svg" />
</Frame>

**O que é transbordo?**

O recurso de transbordo (Hand-off) permite encaminhar uma conversa do agente de IA para um atendente humano quando necessário.

Opções disponíveis:

* Atribuir a um agente específico
* Atribuir a uma equipe
* Atribuir ao proprietário
* Rotear para o proprietário da conta do contato
* Atribuir ao atendente anterior

Quando usar: configure regras de transbordo para consultas complexas, problemas delicados ou solicitações que a IA não consiga resolver.

**Adicionar tags de contato**

<Frame caption="Select Add contact tags to choose a tag referenced by your instructions.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-tags-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=88b601313c53452132a89584fdd0a50b" alt="Menu de adição de tags de contato exibindo tags de demonstração." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-tags-annotated.svg" />
</Frame>

**O que são tags de contato?**

Tags são rótulos que você pode aplicar automaticamente aos contatos com base no comportamento deles ou no conteúdo da conversa.

Como usar: escolha tags específicas para aplicar quando determinadas condições forem atendidas durante a conversa.

Casos de uso comuns:

* Acompanhamento de interesse: se o usuário perguntar sobre o “Produto A”, marque-o automaticamente com a tag “Interessado no Produto A”
* Categorização de problemas: adicione tags aos contatos como “Problema de cobrança” ou “Suporte técnico”
* Qualificação de leads: adicione tags aos potenciais clientes como “Lead quente” ou “Necessita de acompanhamento”

Benefícios: as tags ajudam você a segmentar contatos, disparar fluxos de trabalho automatizados e oferecer uma personalização melhor em interações futuras.


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