Vai al contenuto
PentAGI
Concetti

Agents

Gli agents specializzati dietro un flow e le salvaguardie che li mantengono in carreggiata.

Un flow viene eseguito da un team di agents. Ogni agent type ha il proprio prompt, le proprie impostazioni del modello e i propri tools, così puoi assegnare modelli più potenti o più economici in base al ruolo.

Agent types

AgentRuolo
primary_agentAgent di ragionamento principale che guida un flow
assistantModalità assistant interattivo
generatorSuddivide ogni task in subtasks
refinerAffina il piano man mano che arrivano i risultati
adviserConsulenza esperta; mentor nel monitoraggio dell'esecuzione e planner nella pianificazione dei task
reflectorCorregge gli agents che smettono di produrre tool calls
searcherRaccolta informazioni e ricerca web
enricherRaccoglie contesto aggiuntivo dalla memory e dal sandbox prima che l'adviser risponda
coderScrive e analizza codice
installerInstalla e configura tools nella sandbox
pentesterPenetration test e valutazione della sicurezza
simple, simple_jsonCompletamenti in testo semplice e strutturati in JSON

Altri due agents lavorano dietro le quinte: il memorist risponde alle domande degli altri agents sul lavoro passato attingendo alla memory a lungo termine, e il reporter redige il risultato di ogni task.

Come viene delegato il lavoro

How a task is split into subtasks and the primary agent delegates each step to specialist agents through shared memoryVector storeSpecialistsMemoristPrimary agentGeneratorVector storeSpecialistsMemoristPrimary agentGeneratorSubtasks of the taskPast work, when the context lacks itSearch memoryDelegate a step to the searcher, pentester, coder or installerStore tool resultsResult

Meccanismi di sicurezza

  • Limiti alle tool call (sempre attivi) — MAX_GENERAL_AGENT_TOOL_CALLS (predefinito 100) limita i turni del modello nelle catene di primary_agent, assistant, pentester, coder e installer, mentre MAX_LIMITED_AGENT_TOOL_CALLS (predefinito 20) li limita per gli altri agent. Un turno può chiamare diversi tools. I valori da 1 a 5 vengono portati a 6, e 0 o meno significa il predefinito.
  • Rilevamento delle ripetizioni (sempre attivo) — a partire dalla terza chiamata consecutiva allo stesso tool con gli stessi argomenti, il tool non viene eseguito di nuovo: l'agent riceve la risposta precedente con la richiesta di cambiare strategia. La settima chiamata di questo tipo termina la catena.
  • Reflector (sempre attivo) — interviene la prima volta che un modello risponde senza una tool call e riporta l'agent a effettuarne una; dopo tre tentativi falliti la catena si interrompe.
  • Monitoraggio dell'esecuzione (beta, EXECUTION_MONITOR_ENABLED) — per primary_agent, pentester, coder, installer e assistant quando lavora con gli agent, l'adviser agisce come mentore quando l'agent chiama lo stesso tool EXECUTION_MONITOR_SAME_TOOL_LIMIT volte di fila (default 5) o effettua EXECUTION_MONITOR_TOTAL_TOOL_LIMIT tool calls dall'ultimo consiglio (default 10). Il trigger conta le chiamate invece di rilevare un blocco; l'adviser quindi rivede i progressi dell'agent e raccomanda se continuare, cambiare approccio o fermarsi.
  • Pianificazione intelligente dei task (beta, AGENT_PLANNING_STEP_ENABLED) — l'adviser definisce 3–7 passaggi concreti prima che gli specialisti avviino un subtask.

Il monitoraggio dell'esecuzione e la pianificazione dei task raddoppiano all'incirca la qualità dei risultati per i modelli con meno di 32B parametri, al costo di 2–3× più token e tempo. Sono disattivati per impostazione predefinita.

In Enterprise, il planner viene sempre eseguito e il monitoraggio dell'esecuzione è attivo per impostazione predefinita con limiti di 20 e 40 — vedi Agent profiles.

Ultimo aggiornamento il