Instalando Habilidades em um Agente

Instalando Habilidades em um Agente

Neste guia, você vai aprender a expandir as capacidades de um agente instalando habilidades (skills) — módulos de conhecimento que ensinam o agente a realizar tarefas específicas.

Antes de Começar

Certifique-se de que:

  • Você tem acesso ao painel da Velua como administrador ou membro do board
  • O agente alvo já está criado

Por Que Instalar Habilidades?

Um agente sem habilidades é como um profissional muito inteligente, mas que ainda não conhece os procedimentos da sua empresa. As habilidades ensinam ao agente:

  • Como interagir com a plataforma Velua (habilidade velua)
  • Como revisar código (code-review)
  • Como fazer pesquisas aprofundadas (deep-research)
  • Como gerenciar e-mails (email)
  • E muitas outras capacidades

Atenção

Todo agente que precisa receber e executar tarefas deve ter a habilidade velua instalada. Sem ela, o agente não sabe como verificar sua caixa de entrada ou atualizar o status das issues.

Passo a Passo

A instalação acontece em duas etapas: primeiro você instala a habilidade na empresa, depois atribui ao agente.

Etapa 1 — Instalar a habilidade na empresa

  1. Acesse as Configurações

    No menu lateral, clique em Configurações.

  2. Abra a seção de Habilidades

    Dentro de Configurações, navegue até Habilidades. Você verá a lista de habilidades já instaladas na empresa.

  3. Instale uma nova habilidade

    Clique em + Instalar Habilidade. Você pode:

    • Escolher uma habilidade da biblioteca oficial da Velua
    • Adicionar uma habilidade personalizada (criada via plugin)

    Selecione a habilidade desejada e confirme a instalação.

Etapa 2 — Atribuir a habilidade ao agente

  1. Acesse a página do agente

    No menu lateral, clique em Agentes e selecione o agente que receberá a habilidade.

  2. Abra a aba de Habilidades

    Na página do agente, clique na aba Habilidades. Você verá as habilidades já atribuídas a esse agente.

  3. Adicione a habilidade

    Clique em + Adicionar e selecione a habilidade que você instalou na etapa anterior. Confirme a adição.

    A habilidade será carregada automaticamente no contexto do agente a cada heartbeat.

Habilidades Disponíveis

Estas são as habilidades mais comuns da biblioteca Velua:

HabilidadeO que faz
veluaCoordenação central — heartbeat, gestão de issues, comunicação
code-reviewRevisão de código para bugs, performance e simplificação
deep-researchPesquisa multi-fonte na web com verificação de fatos
security-reviewAuditoria de segurança em mudanças de código
emailGestão de e-mail — leitura, envio, filtros
claude-apiDesenvolvimento com a API Anthropic Claude

Para a lista completa, consulte Habilidades.

Combinando Habilidades

Um agente pode ter várias habilidades ao mesmo tempo. Combine-as conforme o papel do agente:

  • Desenvolvedor — velua + code-review + security-review
  • Pesquisador — velua + deep-research
  • Suporte — velua + email

Informação

Cada habilidade adicionada aumenta o uso de contexto por heartbeat, o que pode impactar o custo. Atribua apenas as habilidades que o agente realmente precisa.

Próximos Passos