guilds.run: equipes e fluxos multiagentes de IA

guilds.run, da Cigale AI, executa equipes persistentes de agentes de IA. Cada integrante tem função, modelo e ferramentas próprios; o grupo compartilha conversa, notas e tabelas.

Para que serve, em linguagem simples?

Pense em uma bancada para uma equipe de IA: um agente pesquisa, outro prepara um rascunho e você acompanha o trabalho. Guild é a equipe, Task é a instrução permanente de cada agente e run é uma execução registrada. Você pode ver o prompt real, chamadas de ferramentas, respostas e mudanças de memória.

A proposta atende desenvolvedores e operadores de processos recorrentes que precisam investigar erros. Para perguntas avulsas, considere o esforço de instalação e configuração.

Distribuir trabalho sem perder o contexto

Notas guardam regras e descobertas; tabelas organizam registros; scripts preservam tratamentos repetíveis. A memória individual leva contexto às próximas execuções. Comece com uma entrada definida, um resultado esperado e ações permitidas.

Conectores podem ser adaptadores nativos ou endpoints MCP. Gmail, Drive e GitHub exigem configuração de aplicativos e credenciais na instância. Limite ferramentas por organização, guild ou agente. Os ícones do site não substituem a conexão das contas.

Investigar uma resposta e revisar o Studio

Abra Inspect run e confira o Task efetivo, os argumentos e resultados das ferramentas. Verifique versões de memória quando um erro reaparece.

Prompt Studio analisa uma equipe existente e prepara alterações de Task. Você revisa as diferenças e publica ou descarta. O coach não publica sozinho: novas execuções recebem a mudança, os registros antigos permanecem intactos. Visibilidade facilita a investigação, mas não garante respostas corretas.

Instalar e conferir a primeira execução

Tenha Docker com Compose, git e bash. Siga a instalação oficial:

git clone https://github.com/CigaleAI/guilds.git
cd guilds
./setup.sh
docker compose up --detach --wait

A primeira compilação pode levar minutos. Guarde o .env gerado: ele contém a chave necessária para decifrar credenciais salvas. Abra http://127.0.0.1:8080/.

Conecte um provedor, selecione modelos e um padrão. Crie um guild, adicione um agente e salve seu Task em Prompt. Envie uma tarefa pequena em Group chat: @nome no início desperta só esse membro; sem marcação, todos são acionados. Confira Inspect run, faça uma pergunta de continuidade e revise a memória em State. Acesso remoto precisa de configuração própria.

Rotinas e Recipes para repetir o processo

Rotinas podem ser pausadas. Cron usa UTC e intervalos de pelo menos cinco minutos. Pause testes para não continuar consumindo modelos.

Recipes exporta configuração em JSON. Salve como recipe, aprove e exporte; depois importe, confira o plano de criação, conclua logins e ative as rotinas. Chaves, histórico de chat, memória, registros de tabelas e perfis do navegador ficam de fora. O diretório público de recipes ainda está anunciado como futuro.

Custos de modelos e cuidados com os dados

Verificado em 14 de outubro de 2026: o núcleo auto-hospedado é software livre sob AGPL-3.0-only. A edição hospedada é separada e proprietária; planos disponíveis e cotas atuais não foram confirmados. Infraestrutura, serviços e chamadas de modelos podem ser cobrados à parte, sem um preço único em reais verificado para todo o uso.

O núcleo suporta OpenAI, OpenRouter, xAI, DeepInfra e endpoints locais compatíveis, como Ollama, LM Studio e vLLM. Claude e Gemini podem ser acessados pelo OpenRouter; Kimi Code atende só agentes de programação. A documentação de modelos informa que o titular da chave paga ao provedor. Guilds não define um teto de gastos.

Hospedar o aplicativo não torna locais as requisições a modelos remotos. No Docker, 127.0.0.1 aponta para o contêiner, então um modelo no host exige endereço acessível. Conceda segredos de forma restrita: agentes na mesma máquina compartilham uma fronteira de confiança. Os links de privacidade e termos retornaram 404; retenção e treinamento não foram verificados integralmente.

Perguntas frequentes

Auto-hospedagem gratuita significa operação sem gastos?

O software é gratuito. Hardware, modelos e serviços podem cobrar separadamente; defina limites no provedor.

Posso escolher um modelo local para trabalho sensível?

Sim, por um endpoint compatível. Confira também conectores e ferramentas externas; as condições completas de privacidade estavam indisponíveis.

Posso conferir o que um agente fez?

Sim. Inspect run mostra o prompt efetivo, chamadas de ferramentas e resultados. As versões de memória ajudam a acompanhar o contexto, sem garantir respostas corretas.

Recursos oficiais

• Documentação: instalação e operação.
• Código e registro de problemas: implementação e licença.
• Conta oficial no X: anúncios.
• Comunidade Discord vinculada: pode exigir participação no canal.