guilds.run: agenti AI open source con ruoli e controllo

guilds.run è una piattaforma di Cigale AI per team persistenti di agenti AI. Ogni membro ha un ruolo, un modello e strumenti propri; chat, note e tabelle collegano il lavoro del gruppo.

In parole semplici, a cosa serve?

È un banco di lavoro per un piccolo team AI: un agente raccoglie informazioni, un altro prepara un testo, e tu controlli come hanno lavorato. Il guild è il gruppo, il Task l’istruzione permanente di un agente, il run un’esecuzione registrata. Puoi leggere il prompt effettivo, le chiamate agli strumenti, i risultati e le versioni della memoria.

È utile a sviluppatori e operatori che vogliono ripetere e migliorare processi. Per una domanda occasionale, considera anche l’impegno di installazione e configurazione.

Installare e verificare il primo agente

Servono Docker con Compose, git e bash. Segui la guida ufficiale:

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

La prima compilazione richiede alcuni minuti. Conserva il file .env: contiene la chiave necessaria a decifrare le credenziali memorizzate. Apri http://127.0.0.1:8080/.

Collega un provider nella finestra iniziale, seleziona i modelli e quello predefinito. Crea un guild, aggiungi un agente e salva il Task nella scheda Prompt. In Group chat invia un compito piccolo: una menzione iniziale @nome attiva solo quel membro, senza menzioni si attiva tutto il team. Apri Inspect run per controllare i passaggi; fai una domanda successiva e verifica la memoria in State. L’accesso remoto richiede una configurazione separata.

Dare a ogni ruolo dati e strumenti adeguati

Le note raccolgono regole e conclusioni, le tabelle dati strutturati, gli script elaborazioni riutilizzabili. La memoria mantiene il contesto individuale tra esecuzioni. Parti da input, risultato atteso e azioni consentite ben definiti.

I connettori possono essere adattatori nativi o endpoint MCP. Gmail, Drive e GitHub richiedono applicazioni e credenziali configurate nell’istanza. Limita gli strumenti a organizzazione, guild o agente: le icone del sito non sostituiscono la procedura di collegamento.

Correggere un problema con prove e Studio

Inspect run permette di distinguere errori nelle istruzioni, nelle risposte degli strumenti o nella memoria. Prompt Studio esamina il team esistente e prepara una modifica del Task. Sei tu a leggere le differenze e pubblicare o scartare. Il coach non pubblica da solo; cambiano le esecuzioni future, mentre quelle storiche restano immutate. La visibilità aiuta la diagnosi, senza garantire risposte corrette.

Modelli locali, spese e dati

Verifica del 14 ottobre 2026: il nucleo self-hosted è software libero sotto AGPL-3.0-only. L’edizione ospitata è separata e proprietaria; non sono stati confermati piani attualmente disponibili o quote. Hardware, provider AI e servizi esterni possono costare a parte.

Sono supportati OpenAI, OpenRouter, xAI, DeepInfra e endpoint locali compatibili come Ollama, LM Studio e vLLM. Claude e Gemini si possono raggiungere tramite OpenRouter; Kimi Code è riservato agli agenti di coding. La documentazione dei modelli precisa che paga il titolare della chiave API e Guilds non imposta un tetto di spesa.

Con modelli cloud, le richieste raggiungono comunque il provider. In Docker, 127.0.0.1 indica il container: per un server sul computer host serve un indirizzo raggiungibile. Concedi pochi segreti e separa le macchine quando necessario: gli agenti sulla stessa macchina condividono il confine di fiducia. Privacy e condizioni del sito restituivano 404, quindi conservazione e uso per training non sono stati verificati.

Programmare attività e trasferire Recipes

Le routine sono sospendibili. Cron usa UTC e intervalli di almeno cinque minuti; sospendi i test per fermare il consumo continuato.

Recipes esporta la configurazione in JSON. Salva come ricetta, approva ed esporta; importa, controlla l’anteprima, completa accessi e configurazioni esterne, poi attiva le routine. Chiavi, chat precedenti, memoria, righe delle tabelle e profili browser non vengono copiati. Il catalogo pubblico delle ricette è ancora annunciato come prossimo.

Domande frequenti

Il self-hosting è senza costi?

Il software è gratuito. Modelli, infrastruttura e servizi possono essere fatturati separatamente; imposta i limiti dal provider.

Posso usare un modello locale per informazioni riservate?

Sì, con un endpoint compatibile. Controlla anche gli strumenti esterni: non è stata verificata una garanzia completa sui dati.

Posso verificare come ha lavorato un agente?

Sì. Inspect run mostra il prompt effettivo e le chiamate agli strumenti con i risultati. Le versioni della memoria aiutano a seguire il contesto, senza garantire risposte corrette.

Risorse ufficiali

• Documentazione: avvio e gestione.
• Codice sorgente e problemi: implementazione e licenza.
• Account ufficiale X: annunci.
• Community Discord collegata: può richiedere l’appartenenza al canale.