Agenti
Cosa Sono gli Agenti?
Gli agenti sono assistenti potenziati dall'intelligenza artificiale in grado di ragionare, agire e comunicare per tuo conto. A differenza dei semplici chatbot, gli agenti di Neotask sono entità autonome che analizzano i problemi, eseguono attività e interagiscono su più piattaforme.
Caratteristiche principali degli agenti:
- Identità -- Ogni agente ha un nome, un'emoji e una personalità unici che lo distinguono dagli altri.
- Workspace -- Ogni agente opera nel proprio spazio di lavoro, mantenendo file, sessioni e contesto separati.
- Skill -- Gli agenti possono essere equipaggiati con skill modulari che ne estendono le capacità (vedi Skill).
- Canali -- Gli agenti si connettono a piattaforme di comunicazione come Slack, Discord e la posta elettronica per inviare e ricevere messaggi (vedi Canali).
- Indipendenza -- Più agenti possono lavorare in modo indipendente su attività diverse, oppure collaborare come team per affrontare flussi di lavoro complessi.
Capacità degli Agenti per Piano
| Piano | Agenti Simultanei |
|---|---|
| Free | Solo l'agente di chat principale; la creazione di agenti personalizzati è bloccata |
| Individual | Agenti illimitati con accesso completo alla piattaforma |
| Business | Agenti illimitati, più operazioni aziendali e postazioni per i dipendenti |
| Enterprise | Agenti illimitati con orchestrazione multi-azienda su larga scala |
Con il piano Free, la superficie principale è la chat interattiva, le board e i workflow di codifica; la creazione di agenti personalizzati richiede un piano a pagamento. Su tutti i piani a pagamento il numero di agenti non è limitato: Individual offre la piattaforma completa a una persona, mentre Business ed Enterprise aggiungono le operazioni aziendali e l'orchestrazione parallela su larga scala, tutto coordinato attraverso il motore di orchestrazione del team della piattaforma. Vedi Fatturazione e Piani per dettagli sul funzionamento dell'utilizzo.
Creare un Agente
Per creare un nuovo agente:
- Vai su Agenti nella dashboard.
- Clicca su Crea Agente.
- Fornisci le seguenti informazioni:
- Nome -- Un nome descrittivo per l'agente (ad esempio, "Bot di Supporto", "Runner DevOps").
- Workspace -- Seleziona uno spazio di lavoro esistente o creane uno nuovo. Lo spazio di lavoro determina dove l'agente archivia i file e mantiene lo stato.
- Emoji -- Scegli un'emoji per identificare visivamente l'agente nella dashboard.
Modelli di Agente
Neotask fornisce modelli preconfigurati per iniziare rapidamente. Ogni modello include skill consigliate, impostazioni del modello e prompt di sistema adattati a un caso d'uso specifico:
| Modello | Descrizione |
|---|---|
| Assistente | Helper generico per attività quotidiane, domande e risposta, e produttività |
| Sviluppatore | Generazione di codice, debug, gestione di repository e flussi di lavoro CI/CD |
| Ricercatore | Ricerca approfondita, sintesi e raccolta di informazioni sul web |
| Social Media | Creazione di contenuti, pianificazione e coinvolgimento sulle piattaforme social |
| Analista di Dati | Elaborazione dei dati, visualizzazione e reportistica |
| Domotica | Controllo di dispositivi smart home, routine e monitoraggio |
| Assistente Vocale | Flussi di lavoro conversazionali con sintesi e riconoscimento vocale |
| Tutor | Erogazione di contenuti educativi, quiz e apprendimento adattivo |
| Responsabile Campagna | Pianificazione, esecuzione e analisi di campagne di marketing |
Puoi sempre personalizzare un modello dopo la creazione o iniziare da zero con un agente vuoto.
Configurazione dell'Agente
Override del Modello
Per impostazione predefinita, gli agenti utilizzano il modello configurato a livello di sistema nelle impostazioni di Neotask. Puoi sovrascrivere questa impostazione per ogni singolo agente assegnandogli un modello AI specifico.
- Apri la scheda Impostazioni dell'agente.
- Nella sezione Modello, seleziona un provider e un modello dal menu a tendina.
- Se impostato su Predefinito di Sistema, l'agente utilizzerà il modello configurato globalmente.
Questo è utile quando certi agenti hanno bisogno di un ragionamento più potente (ad esempio, Claude 4 Opus per attività architetturali) mentre altri possono usare modelli più leggeri per ridurre i costi (ad esempio, GPT-4.1 Nano per la formattazione).
Limiti di Spesa
Controlla i costi impostando un limite di spesa giornaliero per agente.
- Vai alla scheda Impostazioni dell'agente.
- Nella sezione Limite di Spesa, inserisci un costo massimo giornaliero in USD.
- Quando l'agente raggiunge il suo limite, smetterà di effettuare chiamate API per il resto della giornata.
- I limiti di spesa si azzerano a mezzanotte UTC.
L'applicazione automatica garantisce che nessun singolo agente possa generare costi imprevisti, il che è particolarmente importante quando si gestiscono centinaia di agenti su Enterprise o quando gli agenti operano autonomamente con pianificazioni.
Modalità Sicura
La modalità sicura esegue l'agente all'interno di un sandbox di esecuzione isolato. Quando abilitata:
- L'accesso al file system è limitato alla directory dello spazio di lavoro dell'agente.
- Le richieste di rete sono limitate ai domini esplicitamente consentiti.
- I comandi della shell vengono eseguiti in un ambiente contenuto.
- L'agente non può influenzare altri agenti o risorse a livello di sistema.
La modalità sicura è consigliata per gli agenti che eseguono codice non attendibile, interagiscono con API esterne o operano con supervisione minima.
Sessioni degli Agenti
Ogni agente mantiene sessioni di conversazione che tracciano la cronologia completa delle interazioni.
Tipi di Sessione
| Tipo | Comportamento |
|---|---|
| Principale | Una sessione persistente che si mantiene nelle interazioni. L'agente ricorda il contesto precedente e può fare riferimento a messaggi precedenti. |
| Isolata | Una sessione nuova creata ogni volta. Nessun contesto precedente viene conservato. Utile per attività senza stato o quando si vuole che l'agente inizi da zero. |
Cronologia della Chat
Ogni sessione registra una cronologia completa della chat con ruoli dei messaggi chiaramente etichettati:
- Utente -- Messaggi inviati da te o ricevuti da un canale connesso.
- Assistente -- Risposte generate dall'agente.
- Sistema -- Istruzioni a livello di sistema, prompt o messaggi di configurazione.
- Strumento -- Risultati restituiti dalle esecuzioni di skill e strumenti.
Modalità di Ragionamento
Abilita la modalità di ragionamento per vedere il processo di ragionamento interno dell'IA prima che produca una risposta. Questo è utile per:
- Eseguire il debug di comportamenti imprevisti dell'agente.
- Comprendere come l'agente giunge a una decisione.
- Verificare catene di ragionamento complesse a più passaggi.
Quando la modalità di ragionamento è attiva, i passaggi di ragionamento dell'agente appaiono in una sezione comprimibile sopra ogni risposta.
Allegati
Gli agenti possono elaborare allegati all'interno di una sessione:
- Immagini -- Screenshot, foto, diagrammi. L'agente può analizzare e descrivere il contenuto visivo.
- File -- Documenti, fogli di calcolo, PDF. L'agente può leggere, riassumere ed estrarre dati.
- Codice -- File sorgente e snippet. L'agente può esaminare, modificare ed eseguire codice.
Strumenti degli Agenti
Gli agenti sono dotati di un set di strumenti integrati organizzati per categoria. Questi strumenti sono sempre disponibili e non richiedono installazione.
File System
| Strumento | Descrizione |
|---|---|
| Leggi | Legge il contenuto di un file dallo spazio di lavoro dell'agente |
| Scrivi | Crea o sovrascrive un file nello spazio di lavoro dell'agente |
| Modifica | Esegue modifiche mirate a un file esistente usando trova e sostituisci |
Esecuzione
| Strumento | Descrizione |
|---|---|
| Comandi Shell | Esegue comandi shell (bash, zsh, ecc.) nell'ambiente dell'agente |
| Gestione Processi | Avvia, arresta e monitora i processi in esecuzione |
| Agenti Secondari | Avvia agenti figlio per gestire sottoattività, abilitando flussi di lavoro paralleli e delegati |
Web
| Strumento | Descrizione |
|---|---|
| Automazione Browser | Controlla un browser headless per navigare pagine, compilare moduli, cliccare elementi e catturare screenshot |
| Richieste HTTP | Effettua richieste HTTP/HTTPS ad API e servizi web con controllo completo su metodo, intestazioni e corpo |
Pianificazione
| Strumento | Descrizione |
|---|---|
| Cron Job | Pianifica attività ricorrenti usando espressioni cron (ad esempio, esegui un report ogni lunedì alle 9:00) |
| Webhook | Registra endpoint webhook che attivano azioni dell'agente quando chiamati da servizi esterni |
Modelli degli Agenti
Neotask supporta più provider AI e modelli. Puoi assegnare qualsiasi modello supportato a qualsiasi agente.
Provider e Modelli Supportati
Anthropic
| Modello | Ideale per |
|---|---|
| Claude 4 Sonnet | Prestazioni bilanciate tra coding, analisi e conversazione |
| Claude 4 Opus | Profondità di ragionamento massima per architettura complessa e analisi |
| Claude 3.5 Haiku | Attività veloci e leggere come sintesi e classificazione |
OpenAI
| Modello | Ideale per |
|---|---|
| GPT-5.1 | Attività complesse di coding e generazione |
| GPT-4.1 | Attività generali con forte capacità di seguire istruzioni |
| GPT-4.1 Nano | Attività leggere ultra-veloci come formattazione e boilerplate |
| Modello | Ideale per |
|---|---|
| Gemini 3 Pro | Analisi complessa e ragionamento su contesti lunghi |
| Gemini 3 Flash | Ricerca veloce e test con finestre di contesto ampie |
| Gemini 2.5 Flash Lite | Estrazione di dati ed elaborazione semplice a basso costo |
DeepSeek
| Modello | Ideale per |
|---|---|
| DeepSeek V3.2 | Revisione del codice, documentazione e generazione di boilerplate |
OpenRouter
| Modello | Ideale per |
|---|---|
| Routing multi-modello | Selezione automatica del modello in base al tipo di attività e al budget |
Routing Intelligente delle Attività
Quando un agente è configurato per utilizzare il routing intelligente, Neotask seleziona automaticamente il modello migliore per ogni attività in base alla complessità e al tipo. La tabella di routing di seguito mostra le assegnazioni predefinite:
| Tipo di Attività | Modello | Livello |
|---|---|---|
| Architettura | Claude Sonnet 4 | Pesante |
| Coding Complesso | GPT-5.1 | Pesante |
| Analisi Complessa | Gemini 3 Pro | Pesante |
| Coding Standard | Claude Haiku 4.5 | Medio |
| Revisione Codice | DeepSeek V3.2 | Medio |
| Test | Gemini 3 Flash | Medio |
| Ricerca | Gemini 3 Flash (1M contesto) | Medio |
| Documentazione | DeepSeek V3.2 | Medio |
| Estrazione Dati | Gemini 2.5 Flash Lite | Leggero |
| Formattazione | GPT-4.1 Nano | Leggero |
| Sintesi | Claude Haiku 3.5 | Leggero |
| Attività Semplici | GPT-4.1 Nano | Leggero |
| Boilerplate | DeepSeek V3.2 | Leggero |
Definizioni dei livelli:
- Pesante -- Attività che richiedono ragionamento approfondito, contesto ampio o alta precisione. Utilizzano i modelli più capaci (e più costosi).
- Medio -- Attività che richiedono buone prestazioni ma possono essere gestite da modelli di fascia media. Un buon equilibrio tra costo e capacità.
- Leggero -- Attività di routine che privilegiano velocità ed efficienza dei costi. Utilizzano i modelli più veloci e convenienti.
Il routing intelligente aiuta a ottimizzare i costi di utilizzo abbinando automaticamente il modello giusto all'attività giusta. Questo è particolarmente utile nei piani Enterprise dove centinaia di agenti possono essere in esecuzione simultaneamente.