Documentação · BoltLynx

Início rápido

Configure o computador ou ambiente isolado onde pretende que os agentes atuem. Um cliente local pode servir vários agentes.

Instale o cliente local.
Inicie o cliente local e confirme a página de emparelhamento no navegador.
Abra a aplicação web e crie ou selecione um agente.
Escolha a pasta do projeto que o agente pode utilizar.

Cliente local para Windows

Transfira o iniciador para Windows:

Transferir o iniciador para Windows

Crie uma pasta permanente que irá conservar, por exemplo C:\BoltLynx, e extraia para lá todos os ficheiros do ZIP. Esta versão é portátil; não requer instalador.

Não execute o boltlynx-desktop.exe diretamente a partir da janela do ficheiro ZIP. O Windows poderá iniciá-lo a partir de uma pasta temporária, tornando difícil encontrar mais tarde o iniciador e os respetivos ficheiros locais.

Na pasta extraída, faça duplo clique em boltlynx-desktop.exe. O iniciador para Windows gere o cliente local; não é onde fala com os agentes. Utilize-o para iniciar ou parar o cliente e para abrir ou copiar a página de emparelhamento.

O Windows pode mostrar um aviso do Microsoft Defender SmartScreen porque esta versão inicial ainda não está assinada. Se a descarregou através do botão oficial, clique em More info e depois em Run anyway.

Se o antivírus sinalizar o iniciador para Windows

O cliente local pode executar as ações de sistema, comandos e ficheiros que autorizar. Por isso, versões não assinadas podem ativar deteções heurísticas do antivírus, como Trojan:Win32/Sprisky.U!cl. Não permita uma deteção automaticamente.

Primeiro, confirme que o ZIP veio do botão de transferência oficial acima e que o ficheiro detetado é C:\BoltLynx\boltlynx-desktop.exe. Se a origem, o nome ou o ficheiro detetado não corresponder, elimine-o e transfira uma nova cópia através do botão oficial.
Se corresponder, abra Segurança do Windows → Proteção contra vírus e ameaças → Histórico de proteção, abra a deteção e escolha Permitir no dispositivo. Se o ficheiro tiver sido colocado em quarentena, escolha Restaurar. Os nomes podem variar ligeiramente consoante a versão do Windows.
Se o Defender voltar a colocar em quarentena o ficheiro confirmado, abra Definições de Proteção contra vírus e ameaças → Gerir definições → Exclusões → Adicionar ou remover exclusões, escolha Pasta e adicione apenas C:\BoltLynx.

Não desative a proteção em tempo real nem exclua Transferências, toda a pasta do utilizador ou uma unidade inteira.

Instruções da Microsoft: Histórico de proteção e exclusões de pastas.

Após o emparelhamento, deixe o cliente local a funcionar em segundo plano. Abra a aplicação web para falar com os agentes e escolher a pasta do projeto que podem utilizar.

Quando houver uma atualização, o iniciador para Windows poderá transferir o novo cliente local. Como é portátil, os ficheiros locais permanecem na pasta a partir da qual executa o programa.

Linha de comandos do Linux

Instale o cliente local:

curl -fsSL https://boltlynx.com/install.sh | bash

O instalador coloca o binário boltlynx em ~/.boltlynx/bin/ e adiciona-o ao PATH. Reinicie o terminal e inicie o cliente local. Na primeira execução, o comando apresenta uma ligação para a página de emparelhamento; abra-a no navegador e confirme. Depois, o cliente local continua a funcionar em segundo plano. Não é necessário outro comando de emparelhamento.

boltlynx start

Consulte o estado do cliente em qualquer momento:

boltlynx status

Linha de comandos do macOS

Instale o cliente local:

curl -fsSL https://boltlynx.com/install.sh | bash

boltlynx start

Consulte o estado do cliente em qualquer momento:

boltlynx status

Quando o cliente local estiver a funcionar e emparelhado, abra a aplicação web, crie ou selecione um agente e escolha a pasta do projeto que este pode utilizar.

Abrir a aplicação web

Atualizar o cliente local

Depois de uma atualização:

Windows: atualize o cliente local através do iniciador e reinicie o núcleo do cliente.
Linux / macOS: reinicie o cliente local no terminal.

Reiniciar o cliente local

boltlynx restart

Conceitos essenciais

Aplicação web

Fale com os agentes, crie e gira o trabalho e decida o que deve acontecer a seguir. A aplicação web funciona no navegador.

Cliente local

O cliente é executado no seu computador. Dá aos agentes aprovados acesso a ficheiros locais, comandos, análise de dados, pesquisa de código e competências privadas.

Um cliente não é um único agente. É um ambiente de execução isolado: uma máquina, um contentor ou um utilizador distinto do sistema operativo. Instale o cliente uma vez nesse ambiente; pode alojar vários agentes.

Agente

Um agente combina uma conversa e um ambiente de trabalho. Tem histórico da conversa, diretório de trabalho, memória, competências ativas e instruções próprias.

Competências

As competências dão capacidades de domínio a um agente. Este guia cobre Code para desenvolvimento de software e Ops para operações e regras de segurança de bases de dados.

Agentes especializados

Um agente principal pode delegar trabalho em agentes especializados. Cada um pode ter o seu próprio modelo, diretório de trabalho, competências e função.

Configuração do agente

Cada agente pode ser configurado para um projeto ou carga de trabalho específicos.

Nome, descrição e diretório de trabalho	Identifique o agente e defina a pasta raiz em que pode operar.
Competências	Ative capacidades de domínio como Code ou Ops.
Modelo	Escolha o modelo e o nível de raciocínio para o trabalho.
Permissões de ficheiros	Defina caminhos permitidos, editáveis ou bloqueados.
Permissões de comandos	Permita ou bloqueie padrões de comandos, como `git *`, bloqueando comandos destrutivos.
Instruções e memória	Dê ao agente regras de trabalho de longo prazo e notas editáveis que possa manter entre conversas.
Agentes especializados	Configure colaboradores especializados para trabalhos maiores.
Triggers e notificações	Execute verificações agendadas, fluxos acionados por webhook ou notificações de conclusão e alerta.

Utilização diária

Abra a aplicação web. Selecione o agente do projeto e continue a conversa ou indique-lhe o trabalho seguinte.
Descreva o trabalho. Dê ao agente uma tarefa real, não apenas um prompt.
Deixe-o atuar. O agente pode ler e escrever ficheiros, executar comandos, pesquisar código e analisar dados dentro do ambiente aprovado.
Aprove ações sensíveis. As operações que exigem confirmação pedem primeiro aprovação humana.
Receba notificações. A BoltLynx pode avisar quando o trabalho termina, surge uma anomalia ou uma tarefa agendada apresenta resultados.

Modelo de segurança

A BoltLynx foi concebida com limites explícitos. O agente trabalha dentro dos diretórios e permissões de comandos que configura.

O acesso a ficheiros é controlado pelo diretório de trabalho e por regras adicionais de permissão ou bloqueio.
Os comandos sensíveis podem exigir aprovação humana.
As competências privadas são executadas através do cliente local, em vez de serem carregadas como ferramentas do servidor.
As notificações podem apresentar conclusões, falhas e relatórios agendados.

Limites dos dados

O BoltLynx foi concebido para minimizar o acesso local e a transferência de dados. Não replica o espaço de trabalho nem analisa e envia ficheiros sem relação com o trabalho.

O conteúdo de trabalho só sai do cliente quando é necessário para o raciocínio do modelo, para resultados de ações necessários, para um serviço online que escolher ou para diagnósticos operacionais necessários para executar e proteger o Serviço.

Instale o cliente local. Comece a trabalhar.