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

# Skills (Habilidades)

> Ensine tarefas específicas aos seus agentes com blocos de conhecimento reutilizáveis

As **Skills** (Habilidades) são blocos de conhecimento reutilizáveis que ensinam tarefas específicas aos seus agentes de IA. Vincule a mesma Skill a múltiplos agentes para padronizar procedimentos.

<CardGroup cols={3}>
  <Card title="Ensinar Tarefas" icon="graduation-cap">
    Defina passo a passo como o agente deve executar tarefas específicas.
  </Card>

  <Card title="Reutilizar Conhecimento" icon="arrows-rotate">
    Vincule a mesma Skill a múltiplos agentes para manter consistência.
  </Card>

  <Card title="Organizar Instruções" icon="folder-tree">
    Separe responsabilidades em módulos independentes e gerenciáveis.
  </Card>
</CardGroup>

## Skills vs. Instruções do Agente

| Aspecto          | Instruções do Agente                | Skills                             |
| ---------------- | ----------------------------------- | ---------------------------------- |
| **Escopo**       | Comportamento geral e personalidade | Tarefas específicas                |
| **Reutilização** | Específico de um agente             | Compartilhável entre agentes       |
| **Propósito**    | Define "quem" o agente é            | Define "o que" o agente sabe fazer |

<Tip>
  Use as instruções do agente para definir personalidade e contexto geral. Use Skills para ensinar procedimentos e tarefas específicas.
</Tip>

***

## Como funcionam?

<Steps>
  <Step title="Crie a Skill">
    Defina um nome descritivo e escreva o conteúdo com instruções detalhadas da tarefa.
  </Step>

  <Step title="Vincule ao Agente">
    Na página do agente, conecte a Skill na seção **Skills**.
  </Step>

  <Step title="Agente aprende automaticamente">
    O agente incorpora as instruções e passa a executar a tarefa durante as conversas.
  </Step>
</Steps>

***

## Campos de Configuração

| Campo    | Obrigatório | Descrição                                                              |
| -------- | ----------- | ---------------------------------------------------------------------- |
| Nome     | Sim         | Identificador da Skill (máximo 100 caracteres)                         |
| Conteúdo | Sim         | Instruções detalhadas de como executar a tarefa (mínimo 10 caracteres) |

**Dicas para o nome:** escolha algo que identifique a tarefa claramente.

* **Bom**: "Agendamento de Reuniões", "Coleta de Dados Cadastrais"
* **Evite**: "Skill 1", "Tarefa", "Novo"

***

## Gerenciando Skills

As Skills são gerenciadas pela **página de detalhe do agente**. Acesse a seção **Skills** para vincular, criar, editar ou desvincular.

### Vincular uma Skill existente

<Steps>
  <Step title="Acesse o Agente">
    Vá para a página **Agentes** e clique no agente desejado.
  </Step>

  <Step title="Localize a seção Skills">
    Role até encontrar a seção **Skills**.
  </Step>

  <Step title="Clique em Vincular Skill">
    Clique no botão **Vincular Skill**.
  </Step>

  <Step title="Escolha a Skill">
    Na aba **Skills Existentes**, busque e selecione a Skill desejada.
  </Step>
</Steps>

### Criar e vincular em um passo

1. Na página do agente, clique em **Vincular Skill**
2. Selecione a aba **Criar Nova**
3. Preencha nome e conteúdo
4. Clique em **Criar e Vincular**

### Editar uma Skill

Clique sobre a Skill vinculada na seção Skills do agente. Um diálogo de edição será aberto com os campos de nome e conteúdo.

<Warning>
  Alterações em uma Skill afetam todos os agentes vinculados a ela.
</Warning>

### Desvincular uma Skill

Clique no ícone de lixeira ao lado da Skill na seção Skills do agente. A Skill não será excluída, apenas desvinculada daquele agente.

***

## Exemplos Práticos

### Agendamento de Reuniões

```text theme={null}
Quando o usuário quiser agendar uma reunião, siga este processo:

1. COLETA DE INFORMAÇÕES
   - Pergunte o assunto/objetivo da reunião
   - Pergunte a data e horário preferidos
   - Pergunte quem são os participantes

2. VALIDAÇÃO
   - Repita todas as informações coletadas
   - Peça confirmação do usuário

3. FINALIZAÇÃO
   - Confirme que a reunião será agendada
   - Informe que um convite será enviado por e-mail

Se o horário não estiver disponível, sugira alternativas próximas.
```

### Processo de Vendas Consultivo

```text theme={null}
Ao identificar interesse de compra, conduza uma venda consultiva:

FASE 1 - DESCOBERTA
- Entenda a necessidade real do cliente
- Pergunte qual problema ele quer resolver

FASE 2 - APRESENTAÇÃO
- Apresente a solução mais adequada
- Destaque benefícios (não apenas características)

FASE 3 - OBJEÇÕES
- Ouça objeções com atenção
- Ofereça alternativas quando necessário

FASE 4 - FECHAMENTO
- Resuma os benefícios acordados
- Apresente próximos passos claros

NUNCA: pressione o cliente ou prometa o que não pode cumprir.
```

***

## Boas Práticas

<CardGroup cols={2}>
  <Card title="Uma Skill, Uma Tarefa" icon="bullseye">
    Cada Skill deve focar em uma tarefa específica. Se ficou longa demais, divida em múltiplas Skills.
  </Card>

  <Card title="Seja Específico" icon="list-check">
    Detalhe passos, perguntas a fazer, informações a coletar e regras a seguir. Evite instruções vagas.
  </Card>
</CardGroup>

### O que incluir no conteúdo

1. **Gatilho**: Quando a Skill deve ser usada
2. **Passos**: Sequência de ações a executar
3. **Perguntas**: O que perguntar ao usuário
4. **Regras**: Condições e exceções

<Warning>
  Evite instruções genéricas como "seja prestativo". O agente já tem diretrizes gerais. Foque em procedimentos específicos e acionáveis.
</Warning>

***

## Resolução de Problemas

| Problema                       | Solução                                                      |
| ------------------------------ | ------------------------------------------------------------ |
| Agente não usa a Skill         | Confirme se a Skill está vinculada ao agente na seção Skills |
| Agente não segue as instruções | Revise o conteúdo para ser mais específico e claro           |
| Conflito entre Skills          | Separe melhor as responsabilidades de cada Skill             |

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Rules" icon="shield-check" href="/rules">
    Defina restrições de comportamento para seus agentes
  </Card>

  <Card title="Documentos" icon="file-lines" href="/documents">
    Adicione conhecimento aos seus agentes
  </Card>

  <Card title="Tools" icon="wrench" href="/tools">
    Expanda as capacidades com ferramentas que executam ações
  </Card>

  <Card title="Playground" icon="play" href="/playground">
    Teste seus agentes com Skills configuradas
  </Card>
</CardGroup>