Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Configurar o Aggrega com o assistente de IA

Um assistente de IA capaz de executar comandos na máquina do utilizador — um agente de programação no terminal ou no editor — pode configurar o Aggrega: instalar o binário aggrega, adicionar a si próprio a skill do Aggrega e ligar-se ao servidor MCP do Aggrega. Um assistente que instala plugins faz as duas últimas ações num único passo, instalando o plugin do Aggrega; qualquer outro adiciona a skill e liga o servidor, um após o outro. Basta colar nele o prompt abaixo, e o assistente executa esses passos; o prompt indica-lhe que peça confirmação antes de instalar o que quer que seja.

Concluído o processo, o assistente tem duas formas de trabalhar com o Aggrega. A skill é uma pasta com um ficheiro SKILL.md que o assistente carrega quando o pedido diz respeito ao Aggrega: indica ao assistente como decorre o ciclo de criação e que deve tirar cada resposta sobre um schema ou um ficheiro do binário, e não da memória. O servidor MCP, aggrega mcp, dá-lhe as ferramentas do Aggrega — scaffold, validate, build e as restantes — e o material de referência com que trabalham. A skill do Aggrega descreve a skill e o plugin, Ligar o servidor MCP o servidor, e O que o assistente pode fazer com o Aggrega aquilo a que chega através dele.

Depois de configurado, Introdução, cada guia passo a passo em Importação e a página de cada exemplo executável que é compilado com o Aggrega apresentam a tarefa que ensinam como um prompt para colar no assistente, ao lado dos comandos.

O prompt

Configure o Aggrega para mim, um passo de cada vez, e diga-me o que executou em cada passo.
1. Execute `aggrega version`. Se o comando não for encontrado, pergunte-me antes de instalar o Aggrega e depois instale-o para o meu utilizador com o instalador oficial: em Linux ou macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, em Windows, no PowerShell, `irm https://aggrega.ai/install.ps1 | iex`. Execute `aggrega version` novamente. Se o instalador imprimiu uma linha a acrescentar ao meu `PATH`, mostre-ma.
2. Se `https://aggrega.ai/docs/ai-assistants/skill/` indicar uma forma de instalar o plugin do Aggrega em si, pergunte-me antes de o instalar e depois instale-o dessa forma, ou diga-me o que fazer quando se tratar de um passo que eu dou na sua interface. O plugin adiciona a skill do Aggrega e liga-o ao servidor MCP do Aggrega. Caso contrário, execute `aggrega skills install --help` e encontre o seu próprio identificador na lista que ele imprime. Pergunte-me se quero a skill neste projeto ou em todos os projetos e depois execute `aggrega skills install --agent <your identifier>`, acrescentando `--global` para todos os projetos. Se não estiver na lista, não instale a skill e diga-o.
3. Se instalou o plugin, já está ligado ao servidor MCP do Aggrega. Caso contrário, ligue-se ao servidor MCP do Aggrega, que é o comando `aggrega mcp`, da forma como adiciona um servidor MCP, tal como `https://aggrega.ai/docs/ai-assistants/mcp-server/` descreve para o seu caso. Se precisar de um reinício ou de um recarregamento para carregar o plugin ou o servidor, diga-me o que fazer.
4. Depois de ligado, chame a ferramenta `describe-capabilities` sem argumentos e resuma o que ela lista.

O prompt é o mesmo em todas as línguas em que a documentação é publicada: só as suas frases são traduzidas, e cada comando, flag, endereço e nome de ferramenta que contém fica exatamente como está escrito, de modo que um assistente lê as mesmas instruções seja qual for a língua de onde é copiado.

O instalador transfere a release mais recente, verifica-a face aos digests SHA-256 publicados da release e instala-a apenas para o utilizador atual, sem direitos de administrador; Instalar o binário descreve o que faz e como instalar manualmente em alternativa.

O que muda de um assistente para outro

Três partes do prompt dependem do assistente: a forma como instala o plugin do Aggrega, se instalar plugins; caso contrário, o identificador que passa a --agent quando instala a skill e a forma como adiciona o servidor. O assistente deduz estas partes a partir do prompt, mas, quando são conhecidas, é possível escrevê-las no prompt.

AssistenteInstalação do pluginInstalação da skill sem o plugin
Claude Codeclaude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsaggrega skills install --agent claude-code
Codexcodex plugin marketplace add aggrega-ai/aggrega-skills e depois codex plugin add aggrega@aggregaaggrega skills install --agent codex
GitHub Copilot CLIcopilot plugin marketplace add aggrega-ai/aggrega-skills e depois copilot plugin install aggrega@aggregaaggrega skills install --agent github-copilot
Gemini CLIgemini extensions install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent gemini-cli
Antigravityagy plugin install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent antigravity, ou --agent antigravity-cli para a CLI do Antigravity
Cursorgit clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega e depois Developer: Reload Windowaggrega skills install --agent cursor

O Visual Studio Code com o GitHub Copilot, o Kiro e o OpenClaw também instalam o plugin; Instalar o plugin indica a forma para cada assistente e o que o OpenClaw pergunta antes de instalar. Os identificadores que --agent aceita, e a pasta em que cada um escreve, estão listados em aggrega skills e são impressos por aggrega skills install --help. A forma como cada assistente adiciona o servidor — um comando próprio, ou uma entrada nas suas definições ou num ficheiro de lista de servidores — encontra-se em Ligar o servidor MCP, cliente a cliente.

Quando parte do prompt não se aplica

  • Um assistente que instala o plugin salta a ligação do servidor: foi o plugin que o ligou. O plugin não instala o binário, pelo que o passo 1 continua a aplicar-se. Quando o assistente inicia o servidor do plugin fora do projeto — o Codex inicia-o na própria pasta do plugin —, a skill indica-lhe que comunique ao servidor a pasta do projeto, como descreve A pasta em que o servidor trabalha.
  • Um assistente que não instale nenhum plugin e não esteja na lista de --agent salta a instalação da skill. Continua a chegar às ferramentas do Aggrega através do servidor MCP depois de ligado, e o servidor dá-lhe orientações próprias quando se liga.
  • Um assistente que não consegue executar comandos — uma aplicação de chat sem acesso ao terminal — não pode seguir o prompt. Instale o binário como descreve Instalação e ligue a aplicação manualmente como descreve Ligar o servidor MCP. Para o Claude Desktop, consulte Claude Desktop mais abaixo.
  • Um servidor executado por outra pessoa, acedido por HTTPS, não precisa nem do binário, nem do plugin, nem da skill. Em vez disso, indica-se o endereço ao cliente do assistente, como descreve Um servidor acedido por HTTPS.

Claude Desktop

O Claude Desktop liga-se ao Aggrega através do pacote de extensão incluído em cada release, e esse pacote inicia o aggrega instalado no computador. Configure ambos manualmente no computador:

  1. Instale o aggrega no PowerShell, no Windows, com irm https://aggrega.ai/install.ps1 | iex, ou num terminal, no macOS ou no Linux, com curl -fsSL https://aggrega.ai/install.sh | sh. Instalar o binário descreve o que faz o instalador.
  2. Instale o pacote de extensão, defina a respetiva Workspace folder e reinicie o Claude Desktop, como descreve Claude Desktop em Ligar o servidor MCP.

Uma sessão do Claude Desktop pode executar os seus comandos num contentor na nuvem em vez de no computador, pelo que o prompt acima, colado nela, atua sobre o contentor. Aí, o aggrega instala-se e executa-se a partir da shell da sessão assim que a política de rede do contentor permitir aggrega.ai — um proprietário da organização permite-o nas definições de acesso à rede da organização. O servidor MCP do Aggrega não fica ligado aí: o Claude Desktop só adiciona um servidor local a partir das definições das suas extensões, e a extensão inicia o aggrega do computador, não o do contentor.

aggrega skills install não tem uma entrada para o Claude Desktop, pelo que uma sessão do Claude Desktop salta a instalação da skill. Chega às ferramentas do Aggrega através do servidor MCP depois de a extensão estar instalada, e o servidor dá-lhe orientações próprias quando se liga.