# Agenti

## Cosa Sono gli Agenti?

Gli agenti sono assistenti AI isolati che ragionano sui problemi, eseguono compiti e comunicano su più piattaforme. Ogni agente ha il proprio spazio di lavoro, la cronologia delle sessioni, la configurazione del modello e le associazioni ai canali.

## Isolamento degli Agenti

Ogni agente ottiene:

- **Spazio di lavoro**, Una directory dedicata per file, note e dati specifici dell'agente
- **Sessioni**, Cronologia delle conversazioni e trascrizioni indipendenti
- **Configurazione**, Selezione del modello, autorizzazioni degli strumenti, limiti di spesa
- **Identità**, Una persona unica definita nel file `AGENTS.md` dell'agente
- **Profili di Autenticazione**, Configurazioni di chiavi API e autenticazione per agente

## Personas degli Agenti

Lo spazio di lavoro di ogni agente contiene un file `AGENTS.md` che definisce personalità, istruzioni e linee guida comportamentali. Questo prompt di sistema persistente plasma come l'agente risponde, tono, competenza nel dominio, formattazione, utilizzo degli strumenti e policy di sicurezza.

## Routing Multi-Agente

Quando si eseguono più agenti, i messaggi in entrata vengono instradati automaticamente in base alle **associazioni**:

- **Associazione al canale**, Instrada tutti i messaggi da una piattaforma (es. tutti i messaggi Telegram → agente `personale`)
- **Associazione server/spazio di lavoro**, Instrada uno specifico server Discord o spazio di lavoro Slack a un agente dedicato
- **Associazione tipo di chat**, Instrada i messaggi privati a un agente e i messaggi di gruppo a un altro
- **Associazione contatto/peer**, Instrada i messaggi da contatti specifici ad agenti specifici

Le associazioni vengono valutate in ordine di priorità. Vince il primo match. I messaggi senza corrispondenza vanno all'agente predefinito.

## Sotto-Agenti e Delega

Gli agenti possono creare sotto-agenti per compiti specializzati:

- **Delega dei compiti**, Scomponi i compiti complessi e delega le parti ad agenti specializzati
- **Esecuzione isolata**, I sotto-agenti vengono eseguiti nel proprio contesto di sessione
- **Conversazioni ping-pong**, Gli agenti possono avere scambi avanti e indietro (fino a 5 turni) per collaborare
- **Annuncio dei risultati**, I risultati dei sotto-agenti possono essere pubblicati nel canale originale

## Team e Orchestrazione

I team multi-agente abilitano flussi di lavoro coordinati:

- **Esecuzione parallela**, Esegui più agenti simultaneamente su diversi aspetti di un compito
- **Pipeline sequenziali**, Collega gli agenti dove ognuno si basa sull'output precedente
- **Modalità ibrida**, Combina esecuzione parallela e sequenziale
- **Monitoraggio dei compiti**, Monitora lo stato del lavoro di ogni agente (in coda, in esecuzione, completato, errore, annullato)

## Profili degli Strumenti

Controlla cosa può fare ogni agente:

| Profilo | Strumenti Disponibili |
|---------|----------------|
| **minimale** | Solo stato della sessione |
| **codifica** | I/O file, esecuzione, sessioni, memoria, immagini |
| **messaggistica** | Invio messaggi, cronologia delle sessioni |
| **completo** | Tutti gli strumenti (predefinito) |

Elenchi di consentiti/negati personalizzati possono essere impostati per agente e per provider del modello.

## Modalità Sicura

La Modalità Sicura fornisce un sandbox di esecuzione:

- **Interruttore principale**, Abilita o disabilita globalmente
- **Controlli per agente**, Disabilita per agenti fidati, mantieni attiva per altri
- **Approvazione dell'esecuzione**, Le operazioni sensibili richiedono l'approvazione esplicita dell'utente
- **Sincronizzazione delle policy**, Impostazioni sincronizzate su tutti i client connessi in tempo reale

## Memoria degli Agenti

Ogni agente ha accesso a un sistema di memoria:

- **MEMORY.md**, Note persistenti e informazioni importanti tra le sessioni
- **File di memoria**, Conoscenza strutturata aggiuntiva in `memory/`
- **Ricerca vettoriale**, Cerca nella memoria usando query in linguaggio naturale

Consulta [Sessioni e Memoria](sessions-memory.md) per i dettagli.