Ruoli e specializzazioni degli agenti
Assegni a ogni agente un ruolo ristretto, come planner, coder, critic o executor: le prestazioni saranno migliori rispetto a quelle di un generalista.
Ruoli e specializzazioni degli agenti è una lezione AI Agents gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento AI Agents, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso AI Agents include 4 lezioni in totale.
Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.
Perché la specializzazione è utile
Un agente focalizzato, con un prompt preciso e un piccolo insieme di strumenti, è più efficace di un generalista con accesso a tutto. Motivi:
- I prompt possono essere più lunghi e specifici per ogni ruolo
- Le descrizioni degli strumenti sono più chiare (meno opzioni che confondono il modello)
- Debug e valutazione sono più semplici
- Ogni agente può usare un modello di dimensioni diverse
Ruoli comuni
- Planner — suddivide le attività in passaggi
- Researcher — raccoglie informazioni
- Coder — scrive codice
- Reviewer / Critic — individua i difetti
- Editor — perfeziona l'output
- Executor — esegue comandi e strumenti
Define a Role Clearly
RESEARCHER_PROMPT = '''
You are Researcher. Your job is to gather facts.
Never write code. Never make final decisions.
Return 3-5 sourced findings with URLs.
When finished, end your message with: HANDOFF: planner
'''
print(RESEARCHER_PROMPT.strip())
Strumenti per ruolo
Elenco rigoroso degli strumenti consentiti per ogni ruolo:
researcher_tools = ['web_search', 'fetch_url']
coder_tools = ['read_file', 'write_file', 'run_python']
reviewer_tools = [] # critique-only, no tools
print("Researcher tools:", researcher_tools)
print("Coder tools:", coder_tools)
print("Reviewer tools:", reviewer_tools)
Modelli per ruolo
Usare modelli economici per i ruoli semplici e modelli più grandi per quelli difficili:
ROLE_MODELS = {
'planner': 'gpt-4o', # critical role
'researcher': 'gpt-4o-mini', # routine
'coder': 'gpt-4o', # hard
'reviewer': 'claude-sonnet-4-5' # second opinion
}
for role, model in ROLE_MODELS.items():
print(f"{role}: {model}")
Valutazione critica tra modelli
Per una qualità superiore, usare una famiglia di modelli diversa per la valutazione critica. Si riducono gli errori dovuti a pregiudizi condivisi:
- Coder: GPT-4
- Reviewer: Claude
- Se entrambi concordano, procedere; altrimenti, fare un'escalation
Protocollo di passaggio di consegne
Gli agenti hanno bisogno di un modo chiaro per passarsi il lavoro. Una convenzione semplice:
# Each message ends with one of:
HANDOFF: <role_name>
FINAL: <answer>
ABORT: <reason>Specializzazione per tipo di attività
Alcuni team aggiungono esperti di dominio:
- Legal-Reviewer per la conformità
- Security-Reviewer per la sicurezza del codice
- Domain-Specialist per le conoscenze del settore
Limiti per ruolo
Impostare limiti per ogni ruolo previene la crescita incontrollata:
MAX_ROLE_INVOCATIONS = {
'planner': 3,
'researcher': 5,
'coder': 10,
'reviewer': 3
}
for role, cap in MAX_ROLE_INVOCATIONS.items():
print(f"{role}: max {cap} invocations")
Non ecceda nella specializzazione
Passare da 3 ruoli a 30 crea problemi: la selezione da parte del supervisore diventa inaffidabile, la latenza aumenta enormemente e la maggior parte degli "specialisti" duplica il lavoro.
Aggiunga ruoli solo quando ne misura il reale beneficio.
Valutazione per ruolo
Verifichi ogni ruolo in modo indipendente:
- Valutazione del ricercatore: restituisce fatti corredati da fonti?
- Valutazione del programmatore: il codice viene compilato e supera i test?
- Valutazione del revisore: individua i bug noti?
Componibilità
I ruoli possono essere riutilizzati in più sistemi di agenti. Un Researcher ben configurato funziona sia per un flusso di lavoro che scrive documenti sia per uno di verifica dei fatti.
Perché usare i ruoli?
Qual è il vantaggio principale di assegnare un ruolo chiaro a ogni agente?
Riepilogo
Plan -> Research -> Code -> Review è un'ottima pipeline predefinita. Prompt mirati, strumenti specializzati, modelli per ruolo e un protocollo di passaggio di consegne. Aggiunga ruoli solo quando ne esiste un beneficio misurato.
Domande Frequenti
La lezione «Ruoli e specializzazioni degli agenti» è gratuita?
Sì — il testo completo di «Ruoli e specializzazioni degli agenti» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso AI Agents, passa a CoddyKit PRO. Il corso AI Agents include 4 lezioni in totale.
Cosa imparerò in «Ruoli e specializzazioni degli agenti»?
Assegni a ogni agente un ruolo ristretto, come planner, coder, critic o executor: le prestazioni saranno migliori rispetto a quelle di un generalista. Eserciti AI Agents con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare AI Agents?
Non è richiesta alcuna esperienza precedente. AI Agents su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Ruoli e specializzazioni degli agenti»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione AI Agents?
Sì. Ogni lezione AI Agents include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Multi-agente basato sulla conversazione (AutoGen)
- Supervisori gerarchici (orchestratore + worker)
- Ruoli e specializzazioni degli agenti
- Protocolli di comunicazione (message bus)