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

# Configurar habilidades e ações do agente de IA

> Configure habilidades para que seu agente de IA do BluBash possa adicionar tags, criar notas, transferir conversas e chamar sistemas externos automaticamente.

As habilidades definem as ações que seu agente de IA pode executar automaticamente durante as conversas. Em vez de simplesmente responder a mensagens, um agente com habilidades bem configuradas pode transferir conversas para a equipe certa, marcar contatos com tags, registrar notas para sua equipe e até chamar APIs externas — tudo sem intervenção manual.

## O que as habilidades permitem

* **Automação de tarefas** — O agente executa ações sem intervenção humana.
* **Organização** — Tags e notas mantêm as conversas categorizadas e documentadas.
* **Roteamento inteligente** — Transferências automáticas enviam os clientes para a equipe certa.
* **Integrações** — Requisições HTTP conectam o agente a sistemas externos.
* **Eficiência** — Reduz a carga de trabalho manual da sua equipe.

## Como acessar as habilidades

<Steps>
  <Step title="Abrir Agentes de IA">
    Na barra lateral esquerda, clique em **Agentes de IA**.
  </Step>

  <Step title="Selecionar seu agente">
    Clique no agente que você quer configurar.
  </Step>

  <Step title="Abrir a aba Habilidades">
    Clique na aba **Habilidades** no topo da página.
  </Step>

  <Step title="Adicionar uma habilidade">
    Clique em **Adicionar primeira habilidade** ou **Adicionar habilidade**.
  </Step>
</Steps>

## Tipos de habilidade disponíveis

### Adicionar Nota

Cria uma nota interna na conversa com informações relevantes.

**Quando usar:**

* Registrar detalhes importantes sobre o cliente
* Documentar solicitações específicas
* Deixar observações para a equipe humana

**Como configurar:**

<Steps>
  <Step title="Selecionar Adicionar Nota">
    Escolha **Adicionar Nota** na lista de tipos de habilidade.
  </Step>

  <Step title="Nomear a habilidade">
    Insira um nome descritivo.
    Exemplo: *"Registrar interesse no plano Premium"*
  </Step>

  <Step title="Definir quando usá-la">
    Descreva a condição que dispara esta habilidade.
    Exemplo: *"Quando o cliente demonstra interesse no plano Premium"*
  </Step>

  <Step title="Escrever o conteúdo da nota">
    Informe o que será registrado na nota.
    Exemplo: *"Cliente interessado no plano Premium. Solicitou mais detalhes sobre os recursos."*
  </Step>

  <Step title="Salvar">
    Clique em **Salvar**.
  </Step>
</Steps>

***

### Adicionar Tag

Aplica uma tag à conversa para organização e filtragem.

**Quando usar:**

* Categorizar o tipo de solicitação
* Marcar interesse em produtos específicos
* Identificar nível de prioridade
* Segmentar clientes

**Como configurar:**

<Steps>
  <Step title="Selecionar Adicionar Tag">
    Escolha **Adicionar Tag** na lista de tipos de habilidade.
  </Step>

  <Step title="Nomear a habilidade">
    Insira um nome descritivo.
    Exemplo: *"Marcar como Lead Qualificado"*
  </Step>

  <Step title="Definir quando usá-la">
    Descreva a condição de gatilho.
    Exemplo: *"Quando o cliente fornece informações de contato e demonstra interesse genuíno"*
  </Step>

  <Step title="Selecionar a tag">
    Escolha qual tag aplicar entre as opções disponíveis.
  </Step>

  <Step title="Salvar">
    Clique em **Salvar**.
  </Step>
</Steps>

<Tip>
  Crie tags específicas para ações disparadas pela IA antes de configurar esta habilidade. Exemplos: "IA - Lead Qualificado", "IA - Suporte Técnico", "IA - Consulta de Preço".
</Tip>

***

### Remover Tag

Remove uma tag específica da conversa.

**Quando usar:**

* Atualizar o status da conversa
* Remover marcadores temporários
* Corrigir categorizações erradas

**Como configurar:**

<Steps>
  <Step title="Selecionar Remover Tag">
    Escolha **Remover Tag** na lista de tipos de habilidade.
  </Step>

  <Step title="Nomear a habilidade">
    Insira um nome descritivo.
  </Step>

  <Step title="Definir quando usá-la">
    Descreva a condição de gatilho.
  </Step>

  <Step title="Selecionar a tag a remover">
    Escolha qual tag deve ser removida.
  </Step>

  <Step title="Salvar">
    Clique em **Salvar**.
  </Step>
</Steps>

***

### Transferir para Equipe

Transfere a conversa para uma equipe humana específica.

**Quando usar:**

* Encaminhar para uma equipe especializada
* Escalar para suporte técnico
* Encaminhar para vendas
* Repassar para um agente humano

**Como configurar:**

<Steps>
  <Step title="Selecionar Transferir para Equipe">
    Escolha **Transferir para Equipe** na lista de tipos de habilidade.
  </Step>

  <Step title="Nomear a habilidade">
    Insira um nome descritivo.
    Exemplo: *"Transferir para equipe de vendas"*
  </Step>

  <Step title="Definir quando usá-la">
    Descreva a condição de gatilho.
    Exemplo: *"Quando o cliente pergunta sobre preços ou quer fechar negócio"*
  </Step>

  <Step title="Selecionar a equipe">
    Escolha qual equipe deve receber a transferência.
  </Step>

  <Step title="Adicionar um motivo da transferência (opcional)">
    Explique o motivo da transferência, se necessário.
  </Step>

  <Step title="Salvar">
    Clique em **Salvar**.
  </Step>
</Steps>

<Info>
  Após uma transferência para uma equipe humana, o agente de IA para de responder e a equipe assume a conversa.
</Info>

***

### Transferir para Agente de IA

Transfere a conversa para um agente de IA diferente.

**Quando usar:**

* Encaminhar para um agente especializado
* Migrar de um agente de triagem para um agente de atendimento específico
* Escalar para um agente mais avançado

**Como configurar:**

<Steps>
  <Step title="Selecionar Transferir para Agente de IA">
    Escolha **Transferir para Agente de IA** na lista de tipos de habilidade.
  </Step>

  <Step title="Nomear a habilidade">
    Insira um nome descritivo.
  </Step>

  <Step title="Definir quando usá-la">
    Descreva a condição de gatilho.
  </Step>

  <Step title="Selecionar o agente de destino">
    Escolha qual agente de IA deve receber a transferência.
  </Step>

  <Step title="Salvar">
    Clique em **Salvar**.
  </Step>
</Steps>

***

### Requisição HTTP

Integra com sistemas externos por meio de chamadas de API.

**Quando usar:**

* Consultar informações em um sistema externo
* Criar registros em um CRM
* Enviar notificações
* Integrar com plataformas de terceiros

**Como configurar:**

<Steps>
  <Step title="Selecionar Requisição HTTP">
    Escolha **Requisição HTTP** na lista de tipos de habilidade.
  </Step>

  <Step title="Nomear a habilidade">
    Insira um nome descritivo.
  </Step>

  <Step title="Definir quando usá-la">
    Descreva a condição de gatilho.
  </Step>

  <Step title="Informar a URL">
    Forneça o endereço do endpoint da API.
  </Step>

  <Step title="Escolher o método">
    Selecione GET, POST, PUT ou DELETE.
  </Step>

  <Step title="Adicionar cabeçalhos (opcional)">
    Inclua quaisquer cabeçalhos necessários para a requisição.
  </Step>

  <Step title="Adicionar um corpo (opcional)">
    Para requisições POST ou PUT, informe o corpo da requisição.
  </Step>

  <Step title="Salvar">
    Clique em **Salvar**.
  </Step>
</Steps>

<Warning>
  Esta habilidade requer conhecimento técnico de APIs. Certifique-se de ter as credenciais e a documentação da API que você quer integrar antes de configurá-la.
</Warning>

## Boas práticas

1. **Seja específico nas condições** — Defina claramente quando cada habilidade deve ser disparada. Use exemplos concretos e evite descrições ambíguas.
2. **Use nomes descritivos** — Nomes que explicam o que a habilidade faz facilitam muito a manutenção futura.
3. **Teste antes de ativar** — Use o recurso de teste do agente para confirmar que as habilidades são disparadas corretamente e ajustar condições se necessário.
4. **Combine habilidades** — Um agente pode ter várias habilidades. Elas podem ser executadas em sequência — por exemplo, adicionar uma tag e depois transferir para uma equipe.
5. **Mantenha as habilidades organizadas** — Revise periodicamente e documente o propósito de cada habilidade.

## Gerenciando habilidades

**Editar uma habilidade:**

1. Encontre a habilidade na lista.
2. Clique no ícone de edição.
3. Faça suas alterações.
4. Clique em **Salvar**.

**Excluir uma habilidade:**

1. Encontre a habilidade na lista.
2. Clique no ícone da lixeira.
3. Confirme a exclusão.

**Ativar ou desativar uma habilidade:** Use o interruptor ao lado da habilidade para ativá-la ou desativá-la temporariamente sem excluí-la.

## Observações importantes

* As habilidades são executadas automaticamente sempre que suas condições de gatilho são atendidas.
* Um agente pode ter quantas habilidades você precisar.
* As habilidades são executadas na ordem em que foram criadas.
* Você pode testar as habilidades usando o recurso de teste do agente.
* Habilidades mal configuradas podem causar comportamentos inesperados — sempre teste antes de ativar o agente.