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

# Introdução

> Agente de IA capaz de manter uma conversa natural e tomar ações autônomas usando ferramentas.

O **Agente de IA** permite que você desenhe fluxos conversacionais que lidam com processos de múltiplas possibilidades. Seus principais pontos fortes são a capacidade de integrar **ferramentas** adaptadas às necessidades do seu negócio e a flexibilidade de definir seu comportamento diretamente nas instruções, sem adicionar complexidade desnecessária.

Você não precisa escrever essas instruções à mão: quando você [cria um agente](/pt/docs/main-platform/ai-center/create-agent), o Treble as redige a partir do que você descreve. Esta página explica o que elas contêm, como ajustá-las e o que o agente pode fazer.

## É para você?

<Tabs>
  <Tab title="✅ Ideal se você precisa">
    * Você tem um processo complexo que quer que a IA gerencie.
    * Existem múltiplos caminhos dentro de uma mesma conversa.
    * Você precisa definir diferentes regras de saída ou de escalonamento.
    * Você busca avançar em um processo de vendas.
    * Você quer reduzir o tempo de resposta a prospects.
  </Tab>

  <Tab title="❌ Não é ideal se">
    * Você só precisa enviar uma mensagem fixa ou um modelo, sem conversa envolvida.
    * O fluxo se resolve com blocos de pergunta e resposta e condicionais simples.
  </Tab>
</Tabs>

## Casos de uso

* Qualificação avançada de leads com múltiplas rotas de saída.
* Envio automatizado de informações pós-venda.
* Comunicação com participantes após o registro em um webinar.
* Assistência para ajudar o usuário a escolher um produto entre várias opções.
* Acompanhamento automático de carrinhos abandonados.

<div class="hr" />

## Como ler as instruções geradas

As instruções que o Treble escreve seguem uma estrutura consistente. Conhecê-la ajuda a localizar rapidamente o que modificar quando o agente não se comporta como você espera:

| Seção                      | O que contém                                              | Quando mexer nela                                         |
| -------------------------- | --------------------------------------------------------- | --------------------------------------------------------- |
| **Identidade e voz**       | Quem é o agente, tom e estilo.                            | O agente soa formal demais, frio ou prolixo.              |
| **Meta, escopo e limites** | O que deve alcançar e sobre o que não pode falar.         | O agente responde temas fora do seu negócio.              |
| **Passos e regras**        | A ordem da conversa e seus critérios.                     | Pede dados na ordem errada ou não encerra quando deveria. |
| **Ferramentas**            | Quando chamar cada ferramenta e o que validar antes.      | Uma ferramenta não é usada, ou é usada fora de hora.      |
| **Casos limite**           | O que fazer se faltar informação ou o contato se desviar. | Aparece uma situação que o agente não soube tratar.       |
| **Saídas e escalonamento** | Quando terminar, quando encaminhar e o que registrar.     | As conversas não chegam ao time correto.                  |

<Tip>
  Ajuste uma seção por vez e teste no playground depois de cada mudança. Reescrever todo o prompt de uma vez torna muito difícil saber o que melhorou ou piorou o comportamento.
</Tip>

### Escrever as instruções do zero

Se você preferir partir de uma página em branco, ou quiser entender o que o gerador está fazendo, esta é a estrutura recomendada:

1. **Contexto e objetivo**
   * Explique o que o agente deve alcançar e em que cenário é usado.
2. **Tom e estilo**
   * Indique o registro desejado (por exemplo, profissional e claro).
3. **Conhecimento disponível**
   * Indique quando consultar a base de conhecimento e quando não fazê-lo.
4. **Ferramentas disponíveis**
   * Nome, propósito, parâmetros, precondições e limites de cada ferramenta.
   * Regras de uso: quando chamá-la, o que validar antes e o que devolver depois.
5. **Descrição da tarefa com regras explícitas**
   * Passos a seguir, prioridades, critérios de finalização e de sucesso.
   * O que fazer se faltar informação e como pedi-la.
6. **Capacidades e não-capacidades**
   * O que o agente pode fazer e o que não pode fazer (nem deve prometer).
7. **Exemplos concretos**
   * Amostras de entradas e saídas corretas, mais um ou dois contraexemplos.
8. **Raciocínio**
   * Lembrete para pensar passo a passo antes de responder.
9. **Escalonamento e saídas**
   * Quando finalizar, quando escalar e quais dados registrar.

Comece com um escopo limitado, some ferramentas de forma incremental e amplie a cobertura conforme os resultados fiquem consistentes.

💡Assim que seu agente responder corretamente no playground, vá para o **Criador de Conversas** e adicione o bloco **Agente de IA** ao seu fluxo. Você o encontra na seção de blocos avançados.

<img src="https://mintcdn.com/trebleai/YSdZhfVf8ZqT-MDw/images/TOMNodeES.jpg?fit=max&auto=format&n=YSdZhfVf8ZqT-MDw&q=85&s=a39b92aaf94056db04ab5e0ad16e2d76" alt="Bloco do Agente de IA dentro do criador de conversas" width="658" height="148" data-path="images/TOMNodeES.jpg" />

<div class="hr" />

## Ferramentas

O Agente de IA pode usar diferentes ferramentas para executar ações dentro ou fora da conversa. Essas ferramentas ampliam suas capacidades, permitindo consultar informações, criar tickets ou atualizar propriedades em sistemas externos como o HubSpot, além de interagir com funções nativas do Treble.

Quando você gera um agente, o Treble escolhe as ferramentas de que ele precisa e as insere nas instruções. As que exigem dados seus ficam marcadas como pendentes de configuração; você pode completá-las e adicionar outras pelo [editor](/pt/docs/main-platform/ai-center/configure-agent).

### Gerais

* **Pesquisar na Web** — Busca informações atualizadas ou contextuais na internet.
* **Enviar documento** — Envia um arquivo ao usuário durante a conversa.
* **Enviar imagem** — Envia uma imagem ao usuário durante a conversa.

### Treble

* **Ler variável** — Referencia o valor de uma variável dentro das instruções.
* **Salvar resposta como variável** — Guarda a resposta do contato em uma variável do Treble.
* **Transferir para um agente** — Escala a conversa para um agente humano no Treble.
* **Enviar conversa** — Envia o contato para outro fluxo do Treble.
* **Fechar conversa** — Finaliza a interação depois do tempo que você definir.

### HubSpot

* **Transferir para um agente** — Envia a conversa para outro agente ou time dentro do HubSpot.
* **Criar ticket** — Gera um novo ticket com as informações coletadas.
* **Ler Propriedade de Contato** — Consulta o valor de uma propriedade específica de um contato.
* **Salvar / Editar propriedade** — Atualiza uma propriedade de contato com dados da conversa.

### Avançadas

* **Chamada de API** — Faz uma chamada a uma API externa com valores fixos ou com variáveis que o agente tenha coletado. Veja o [guia da ferramenta de API](/pt/docs/main-platform/ai-center/agents/ai-agent/api-tool).
* **Apps Conectadas** — Executa ações nos aplicativos que você conectou ao Treble, como [Google Calendar](/pt/docs/main-platform/ai-center/agents/ai-agent/google-calendar) ou [Shopify](/pt/docs/main-platform/ai-center/agents/ai-agent/shopify-usage).

<Note>
  As ferramentas do HubSpot só aparecem se você tiver a integração conectada, e **Apps Conectadas** mostra apenas os aplicativos que você já vinculou à sua conta.
</Note>

<div class="hr" />

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="O que é o Agente de IA?">
    É um agente de IA projetado para lidar com fluxos conversacionais de múltiplas possibilidades, integrando ferramentas e lógica avançada para executar tarefas automáticas.
  </Accordion>

  <Accordion title="Eu tenho que escrever o prompt?">
    Não. Você descreve o que precisa, responde algumas perguntas e o Treble redige as instruções, escolhe as ferramentas e monta a base de conhecimento. Seu trabalho é revisar o resultado, completar as ferramentas pendentes e testá-lo.
  </Accordion>

  <Accordion title="Preciso saber programar para configurá-lo?">
    Não. Toda a configuração é feita pela interface do Treble.
  </Accordion>

  <Accordion title="O agente entende mensagens de voz do WhatsApp?">
    Sim. O agente pode **entender mensagens de voz enviadas pelos usuários pelo WhatsApp** e responderá automaticamente com texto na conversa.
  </Accordion>

  <Accordion title="O que acontece se o agente não se comportar como espero?">
    Revise as instruções e tente deixá-las mais explícitas. Localize a seção correspondente na tabela acima e adicione o caso que falhou como exemplo concreto.
  </Accordion>

  <Accordion title="Posso combinar este agente com outros nós do fluxo?">
    Sim. O agente pode ser integrado a um fluxo mais amplo e pode ativar ou fechar conversas, salvar respostas ou chamar ferramentas externas conforme suas regras.
  </Accordion>

  <Accordion title="Quais ferramentas o agente pode usar?">
    Ferramentas **gerais**, **do Treble**, **do HubSpot** e **avançadas**, incluindo ações como criar tickets, ler ou editar propriedades, enviar documentos, transferir conversas, chamar uma API ou buscar informações na web.
  </Accordion>

  <Accordion title="Como testo minha configuração antes de lançá-la?">
    Use o [playground](/pt/docs/main-platform/ai-center/playground) para executar testes controlados com diferentes inputs, e envie para si mesmo uma conversa de teste pelo WhatsApp. Itere até que o agente responda corretamente em todos os casos.
  </Accordion>

  <Accordion title="O agente entende imagens?">
    Sim. O agente pode entender imagens enviadas pelo WhatsApp e usar o que vê para guiar suas ações. Por exemplo, pode reconhecer objetos, ler texto em capturas de tela ou interpretar elementos na imagem para decidir o que fazer.

    No entanto, o agente não gera nem cria imagens. Sua capacidade visual se concentra em interpretar e agir sobre imagens existentes, não em produzir novas.
  </Accordion>

  <Accordion title="Como lido com casos complexos ou exceções?">
    Defina regras claras de saída ou escalonamento. Se o agente não conseguir resolver uma situação, transfira a conversa para um agente humano ou registre o evento em um ticket.
  </Accordion>

  <Accordion title="O agente aprende ou se adapta com o tempo?">
    Ele não aprende automaticamente de cada interação, mas você pode **melhorar seu comportamento** iterando sobre as instruções e ajustando as ferramentas ou condições de saída.
  </Accordion>
</AccordionGroup>

## Considerações importantes

<Note>
  **Privacidade:** Informe aos usuários que seus dados serão armazenados e cumpra as regulamentações aplicáveis (GDPR, etc.).
</Note>