# Agent profiles

> Ruoli come dati: un prompt, un preset di modello e una lista ordinata di tool per ogni agent.

In Enterprise, un [agent](https://pentagi.com/it/docs/glossary/#agent) è definito da un **profilo**: il suo ruolo, il prompt di base, il preset del modello e i [tools](https://pentagi.com/it/docs/glossary/#tool) che può utilizzare. Un agent planner sceglie l'[agent profile](https://pentagi.com/it/docs/glossary/#agent-profile) per ogni [subtask](https://pentagi.com/it/docs/glossary/#subtask), in modo che l'agent specialista che viene eseguito corrisponda al lavoro da svolgere.

## [Profili integrati](https://pentagi.com/it/docs/enterprise/agent-profiles/#built-in-profiles)

| Gruppo           | Profili                                                                                                                |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Agents operativi | `universal`, `pentester`, `coder`, `installer`, `researcher`, `recon`                                                  |
| Interattivi      | `assistant`                                                                                                            |
| Pipeline         | `planner`, `subagent_planner`, `generator`, `refiner`, `reporter`, `enricher`, `report_planner`, `composer`, `reviser` |

I [plugins](https://pentagi.com/it/docs/glossary/#plugin) possono includere i propri agent profiles e tu puoi crearne di personalizzati in **Settings → Agent Profiles** — gli amministratori per tutti, gli altri utenti per se stessi.

I profili attivi hanno gli interruttori **On**, **Default** e **Off**: gli amministratori impostano il valore predefinito per gli utenti in **Default for users** e ogni utente può sovrascriverlo in **My state** per i profili integrati o in **My override** per quelli personalizzati. **Default** segue `PROFILES_ENABLEMENT_MODE` — `auto`, l’impostazione predefinita, offre il profilo al planner, mentre `manual` lo offre solo quando è attivato con **On**. Se nessun profilo attivo è abilitato, il [task](https://pentagi.com/it/docs/glossary/#task) si interrompe con un errore.

![Agent profiles nelle impostazioni](https://pentagi.com/images/product/ee-agent-profiles.webp)

## [Planner e monitor di esecuzione](https://pentagi.com/it/docs/enterprise/agent-profiles/#planner-and-execution-monitor)

Prima di ogni subtask, l'`planner` sceglie il profilo di lavoro, i plugin e una breve checklist. Viene sempre eseguito — Enterprise non ha `AGENT_PLANNING_STEP_ENABLED` — sul modello `adviser` del [provider](https://pentagi.com/it/docs/glossary/#provider) del [flow](https://pentagi.com/it/docs/glossary/#flow) e, dopo tre risposte non valide, ripiega su `universal`.

Il monitoraggio dell'esecuzione è attivo per impostazione predefinita (`EXECUTION_MONITOR_ENABLED`). Dopo 20 chiamate consecutive allo stesso tool (`EXECUTION_MONITOR_SAME_TOOL_LIMIT`), 40 [tool call](https://pentagi.com/it/docs/glossary/#tool-call) dall'ultimo controllo (`EXECUTION_MONITOR_TOTAL_TOOL_LIMIT`), oppure a metà e tre quarti del budget di tempo del subtask, un breve controllo sul modello `simple_json` decide se l'agent è bloccato. Solo allora l'adviser rivede il lavoro dell'agent — per i profili che includono il tool `advice` e mentre rimangono almeno cinque minuti del budget.

## [Sub-agents e budget](https://pentagi.com/it/docs/enterprise/agent-profiles/#sub-agents-and-budgets)

Gli agents operativi possono avviare dei [sub-agents](https://pentagi.com/it/docs/glossary/#sub-agent) per lavorare in parallelo all'interno di un subtask con `spawn_agent`, seguirli con `agent_status`, `agent_wait` e `agent_log`, e fermarli con `agent_stop`. I budget di tempo assegnati dal task a ogni subtask, il limite di subtasks per task e il tetto ai sub-agents concorrenti mantengono la delega sotto controllo. Impostali quando avvii un flow, insieme a un preset di contesto — Compact, Balanced o Spacious — che il summarizer cercherà di rispettare.

I valori predefiniti di un nuovo flow provengono da `AGENT_TIME_BUDGET_SECONDS` (10800, tre ore di lavoro degli agent per ogni task), `AGENT_MAX_SUBTASKS` (15 per task), `AGENT_MAX_CONCURRENT_SUBAGENTS` (10) e `SUMMARIZER_PRESET`. Su un flow in esecuzione, modificali sotto **Preferences**; le modifiche si applicano dal task successivo. Impostando **Concurrent sub-agents** su **Disabled** vengono rimossi gli strumenti sub-agent da ogni agent del flow, incluso l'[assistant](https://pentagi.com/it/docs/glossary/#assistant).