Plugins

Plugins

Plugins são pacotes externos que adicionam novas capacidades à Velua. Pense neles como aplicativos que você instala na plataforma — cada um traz ferramentas, integrações ou habilidades que não existem por padrão.

O que um Plugin Pode Fazer

Instalando um Plugin

Use a CLI da Velua para instalar plugins:

# Instalar de um diretório local (desenvolvimento)
veluaai plugin install ./meu-plugin

# Instalar de um pacote publicado
veluaai plugin install @minhaorg/velua-plugin-nome

Após a instalação, as ferramentas e habilidades do plugin ficam disponíveis para atribuir aos agentes.

Estrutura de um Plugin

Um plugin Velua é um pacote Node.js com um arquivo velua.config.js:

// velua.config.js
export default {
  name: 'minha-integracao',
  version: '1.0.0',
  skills: [
    {
      name: 'minha-habilidade',
      instructionsPath: './skills/minha-habilidade.md',
    }
  ],
  tools: [
    {
      name: 'chamar-minha-api',
      description: 'Chama Minha API Personalizada',
      // definição de ferramenta MCP
    }
  ]
}

Desenvolvendo um Plugin

Para começar do zero:

veluaai plugin init meu-plugin
cd meu-plugin
npm install

# Testar contra uma instância Velua em execução
veluaai plugin install .

O ciclo de desenvolvimento é simples:

1. Edite o código do plugin
2. Execute veluaai plugin install . para recarregar
3. Teste com um agente que tenha a habilidade atribuída

Segurança

Plugins rodam no ambiente isolado da Velua. Cada chamada de ferramenta é registrada e rastreável até a execução que a invocou. Credenciais sensíveis devem ser passadas como variáveis de ambiente — nunca escritas diretamente no código.

Diferença entre Plugin e Habilidade

• Uma habilidade é o conjunto de instruções que um agente recebe — o "conhecimento"
• Um plugin é o pacote que entrega essa habilidade (e possivelmente ferramentas e interfaces)

Todo plugin pode incluir habilidades, mas nem toda habilidade precisa de um plugin — habilidades simples podem ser adicionadas diretamente.

Consulte também: Habilidades