Documentação · BoltLynx

Início rápido

Escolha o cliente para o ambiente em que pretende que a BoltLynx trabalhe. Um cliente pode alojar vários agentes.

Ambiente de trabalho portátil para Windows

Descarregue o iniciador para Windows:

Descomprima-o numa pasta que controla. É uma versão portátil: não requer instalador.

Faça duplo clique em boltlynx-desktop.exe. A aplicação é um pequeno iniciador do cliente local. Pode iniciar e parar o cliente, mostrar um URL de emparelhamento, abri-lo no navegador ou copiá-lo.

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.

Depois do emparelhamento, continue a usar a BoltLynx no navegador e escolha a pasta do projeto em que o agente pode trabalhar.

Se existir uma atualização, o iniciador pode descarregar o novo cliente. Como é portátil, a BoltLynx guarda os ficheiros locais 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. Na primeira execução, o emparelhamento é automático: é apresentado um link, abre-o e confirma, e o cliente continua em segundo plano. Não é necessário outro passo.

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

Depois, inicie sessão na BoltLynx no navegador, crie um agente e escolha a pasta do projeto em que pode trabalhar.

Iniciar sessão na BoltLynx

Conceitos essenciais

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.

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.

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 um agente. Comece no navegador e escolha o agente do projeto.
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.

Instale o cliente. Execute trabalho real.