# Agent profiles

> 데이터로서의 역할 — agent별 프롬프트, 모델 프리셋 및 정렬된 tool 목록입니다.

Enterprise에서는 [agent](https://pentagi.com/ko/docs/glossary/#agent)가 **프로필**로 정의돼요. 여기에는 역할, 기본 프롬프트, 모델 프리셋 및 사용 가능한 [tools](https://pentagi.com/ko/docs/glossary/#tool)가 포함돼요. Planner가 각 [subtask](https://pentagi.com/ko/docs/glossary/#subtask)에 맞는 프로필을 선택하므로, 실행되는 전문가가 해당 작업에 적합하게 매칭돼요.

## [기본 제공 프로필](https://pentagi.com/ko/docs/enterprise/agent-profiles/#built-in-profiles)

| 그룹        | 프로필                                                                                                                    |
| --------- | ---------------------------------------------------------------------------------------------------------------------- |
| 작업 agents | `universal`, `pentester`, `coder`, `installer`, `researcher`, `recon`                                                  |
| 인터랙티브     | `assistant`                                                                                                            |
| 파이프라인     | `planner`, `subagent_planner`, `generator`, `refiner`, `reporter`, `enricher`, `report_planner`, `composer`, `reviser` |

[Plugins](https://pentagi.com/ko/docs/glossary/#plugin)는 자체 프로필을 제공할 수 있으며, **Settings → Agent Profiles**에서 사용자 지정 프로필을 만들 수도 있어요. 관리자는 모든 사용자를 위해, 일반 사용자는 자신을 위해 프로필을 생성할 수 있어요.

작동 중인 프로필에는 **On**, **Default** 및 **Off** 스위치가 있습니다: 관리자는 **Default for users**를 설정하며, 각 사용자는 기본 제공 프로필의 경우 **My state**에서, 사용자 지정 프로필의 경우 **My override**에서 이를 재정의할 수 있습니다. **Default**는 `PROFILES_ENABLEMENT_MODE`을 따릅니다 — `auto`인 기본값은 planner에게 프로필을 제공하며, `manual`은 **On**으로 전환된 경우에만 이를 제공합니다. 작동 중인 프로필이 활성화되어 있지 않으면 [task](https://pentagi.com/ko/docs/glossary/#task)가 오류와 함께 중단됩니다.

![Settings의 agent profiles](https://pentagi.com/images/product/ee-agent-profiles.webp)

## [플래너 및 실행 모니터](https://pentagi.com/ko/docs/enterprise/agent-profiles/#planner-and-execution-monitor)

각 subtask 전에 `planner`은 작업용 [agent profile](https://pentagi.com/ko/docs/glossary/#agent-profile), plugin 및 짧은 체크리스트를 선택합니다. 이는 항상 실행되며 — Enterprise에는 `AGENT_PLANNING_STEP_ENABLED`이 없습니다 — [flow](https://pentagi.com/ko/docs/glossary/#flow)의 [provider](https://pentagi.com/ko/docs/glossary/#provider)의 `adviser` 모델에서 실행되고, 세 번의 잘못된 응답 후에는 `universal`로 대체됩니다.

실행 모니터링은 기본적으로 켜져 있습니다 (`EXECUTION_MONITOR_ENABLED`). 동일한 tool에 대해 연속으로 20회 호출(`EXECUTION_MONITOR_SAME_TOOL_LIMIT`)이 발생하거나, 마지막 확인 이후 40회의 [tool call](https://pentagi.com/ko/docs/glossary/#tool-call)(`EXECUTION_MONITOR_TOTAL_TOOL_LIMIT`)이 이루어지거나, subtask의 시간 예산의 절반 및 4분의 3 시점에 도달하면, `simple_json` 모델을 사용하여 짧은 검사를 수행하여 agent가 막혀 있는지 여부를 판단합니다. 이때만 adviser가 agent의 작업을 검토합니다. 이는 `advice` tool을 갖춘 profile에 해당하며, 예산 중 최소 5분이 남아 있는 경우에 한정됩니다.

## [Sub-agents 및 예산](https://pentagi.com/ko/docs/enterprise/agent-profiles/#sub-agents-and-budgets)

작업 agents는 subtask 내에서 병렬 작업을 위해 `spawn_agent`로 [sub-agents](https://pentagi.com/ko/docs/glossary/#sub-agent)를 시작하고, `agent_status`, `agent_wait` 및 `agent_log`로 이를 추적하며, `agent_stop`으로 중지할 수 있어요. Task에서 각 subtask로 전달되는 시간 예산, task당 subtasks 수 제한, 동시 실행 sub-agents 상한선은 위임이 통제 범위 내에서 이루어지도록 보장해요. Flow를 시작할 때 요약기가 목표로 하는 컨텍스트 프리셋(Compact, Balanced 또는 Spacious)과 함께 이러한 항목을 설정하세요.

새 flow의 기본값은 `AGENT_TIME_BUDGET_SECONDS`(task당 agent 작업 시간 10800초, 3시간), `AGENT_MAX_SUBTASKS`(task당 15개), `AGENT_MAX_CONCURRENT_SUBAGENTS`(10) 및 `SUMMARIZER_PRESET`에서 가져옵니다. 실행 중인 flow에서는 **Preferences**에서 이러한 값을 변경할 수 있으며, 변경 사항은 다음 task부터 적용됩니다. **Concurrent sub-agents**를 **Disabled**로 설정하면 해당 flow의 모든 agent([assistant](https://pentagi.com/ko/docs/glossary/#assistant) 포함)에서 sub-agent 도구가 제거됩니다.