Agents - Neotask by Neotask Documentation | Neotask

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 per i dettagli.

    View full documentation