Plugin Claude Code para Instalação e Configuração do SWIRL

A avaliação de software de busca empresarial tem um custo fixo que não tem nada a ver com o software: configurar um servidor, ler a documentação, conectar uma fonte, depurar o conector, configurar um LLM. Quando você vê uma resposta real dos seus próprios dados, uma semana já se passou.

Construímos um plugin Claude Code que comprime isso para cerca de uma hora e, ao longo do caminho, aprendemos algo mais interessante do que a economia de tempo: uma habilidade de plugin é um runbook executável, e a melhor maneira de escrever um é observar onde o agente pesquisa e mover esse conhecimento para cima.

O que é

swirl-claude-plugin é gratuito e Apache-2.0. Ele dá ao Claude Code oito fluxos de trabalho guiados para SWIRL, um motor de busca federado + RAG:

claude plugin marketplace add swirlai/swirl-claude-plugin
claude plugin install swirl@swirl --scope user

Inicie uma nova sessão do Claude Code e você terá:

Por que "uma hora" é honesto

O SWIRL é federado. Ele consulta SharePoint, OneDrive, Box, bancos de dados e APIs da web onde eles estão, reclassifica resultados com modelos locais e alimenta as melhores passagens para o LLM que você configura. Nada é copiado, ingerido ou indexado; não há banco de dados vetorial a ser construído.

É por isso que a avaliação é rápida: o passo usual de vários dias (movendo seus dados para o motor de busca) não existe. Claude instala a pilha, conecta duas ou três fontes e você está vendo respostas classificadas e citadas dos seus próprios documentos.

Habilidades são runbooks, não código

Não há código no plugin. Cada comando é uma habilidade: um arquivo markdown cuja descrição no frontmatter direciona a solicitação e cujo corpo carrega conhecimento operacional focado no contexto do Claude. A habilidade de instalação conhece o verdadeiro início rápido do Docker para cada edição e insiste em verificar com uma busca ao vivo antes de declarar sucesso. A habilidade de solução de problemas incorpora uma regra de suporte que aplicamos a nós mesmos: o relatório do usuário é dado; encontre a linha de log antes de propor uma correção. As habilidades também codificam o que NÃO fazer: nunca imprima chaves de API, nunca cole segredos no chat, nunca reinicie uma pilha que alguém está demonstrando.

O ciclo de desenvolvimento que realmente o melhora

Aqui está o padrão que agora usamos para cada lançamento, com um exemplo real.

Durante uma demonstração, um usuário pediu ao Claude para "habilitar o cross-encoder e usar embeddings maiores em vez de spaCy." Claude fez o que um agente capaz faz com conhecimento ausente: pesquisou. Uma dúzia de comandos em arquivos de configuração e módulos compilados, o usuário o direcionou: modelos de classificação no SWIRL são configurados como Provedores de IA, no banco de dados, como qualquer outra escolha de modelo. Uma vez apontado para lá, Claude mudou o papel do leitor para mxbai-embed-large servido pelo próprio sidecar do Ollama da pilha, verificou que o cross-encoder já estava ativo na saída de explicação de cada resultado e confirmou que a mudança teve efeito sem reiniciar.

Essa transcrição se tornou o próximo lançamento. A habilidade rag agora afirma isso claramente: modelos de classificação são Provedores de IA; não procure em configurações ou fontes. O cross-encoder é enviado ativado por padrão, então confirme-o em vez de configurá-lo. O modelo de embedding é qualquer provedor que detém o papel de reader. As mudanças se aplicam no momento da consulta.

A forma geral: observe onde seu agente pesquisa, então mova esse conhecimento para a habilidade. A pesquisa é o imposto que um agente paga pelo que a habilidade não diz. Cada transcrição de demonstração é um currículo gratuito; a diferença entre "o que o agente teve que descobrir" e "o que deveria ter sabido" é exatamente a próxima versão da habilidade.

Se você está construindo seu próprio plugin

Três práticas que economizarão tempo real:

1. Dê ao plugin uma identidade explícita. Envie um .claude-plugin/plugin.json com o nome e a versão do plugin, e mantenha as definições de componentes (habilidades, comandos) em exatamente um lugar. A ambiguidade aqui aparece na máquina do usuário, não na sua.
2. Teste o caminho exato que um estranho seguirá, a partir de um ambiente limpo. HOME=$(mktemp -d) claude plugin marketplace add you/your-repo && claude plugin install ..., então verifique a superfície visível para o usuário: os nomes reais dos comandos em uma sessão, não apenas "instalado." Validadores de manifesto verificam a sintaxe, não a experiência.
3. Escreva a descrição para roteamento. A descrição do frontmatter é o que decide se a frase de um usuário chega à sua habilidade. Quando as palavras de um usuário real falharam, adicionamos suas palavras à descrição.

O ciclo se fecha com o MCP

A parte que mais gostamos: /swirl:mcp faz o Claude conectar o servidor MCP do SWIRL a si mesmo. O mesmo assistente que instalou sua camada de conhecimento então a consulta, com permissões aplicadas no servidor por usuário. Seus agentes têm acesso governado aos dados empresariais; os dados nunca se movem.

Experimente

• Plugin: claude plugin marketplace add swirlai/swirl-claude-plugin
• Documentos: docs.swirlaiconnect.com/claude-plugin
• PDF de uma página: folha de dados, sem registro
• A Comunidade SWIRL é de código aberto; quer uma licença Enterprise para avaliar? E-mail de trabalho, licença em troca; nenhum humano entrará em contato com você.

Problemas e PRs são bem-vindos no repositório.