mirror of
https://github.com/getpaseo/paseo.git
synced 2026-10-24 18:22:38 +00:00
Mohamed Boudra
da8c1b5c94
* docs(orchestration): lead with capabilities and practical delegation * docs(orchestration): correct model requirements and agent list scope
55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
---
|
|
title: Agent profiles
|
|
description: Save agent settings for one-click selection and use notes to guide delegation for UI work, planning, and reviews.
|
|
nav: Agent profiles
|
|
order: 32
|
|
category: Orchestration
|
|
---
|
|
|
|
# Agent profiles
|
|
|
|
Save the settings you use together as a named profile. Choose **UI work**, **Planning**, or **Review** when creating an agent instead of selecting its model, thinking level, and mode each time.
|
|
|
|
- **For you:** one selection applies the saved provider, model, mode, thinking level, and available feature settings.
|
|
- **For an orchestrating agent:** profile notes explain when to choose those settings for delegated work.
|
|
|
|
## Create a profile
|
|
|
|
1. Open **Settings → your host → Agents → Agent profiles**.
|
|
2. Select **New profile** and give it a name, such as **UI work**.
|
|
3. Choose its provider, model, mode, thinking level, and any available features.
|
|
4. Fill in **When to use** with the kind of work this profile should handle.
|
|
5. Select **Save**.
|
|
|
|
Profiles are saved on that host. The available settings depend on the provider and model you choose.
|
|
|
|
## Apply settings in one click
|
|
|
|
When creating an agent, open the model picker and select a saved profile under **Profiles**. Paseo applies its settings together; you can still adjust them before sending your prompt.
|
|
|
|
Changing a saved profile affects future selections. It does not update agents you already launched.
|
|
|
|
## Guide delegation with notes
|
|
|
|
The **When to use** field is the profile's notes. Paseo exposes these notes through its tools so an orchestrating agent can read them before choosing how to launch a worker.
|
|
|
|
Give each profile a clear specialty:
|
|
|
|
| Profile | Example notes |
|
|
| -------- | -------------------------------------------------------------------------------------------- |
|
|
| UI work | Use for components, layout, styling, and visual polish. |
|
|
| Planning | Use for architecture, investigating root causes, and comparing implementation approaches. |
|
|
| Review | Use for independent review of diffs, correctness, missing tests, and unnecessary complexity. |
|
|
|
|
Each profile can use a different provider and model, or different settings for the same model.
|
|
|
|
After [enabling Paseo tools](/docs/orchestration#get-started), ask:
|
|
|
|
> Check my Paseo profiles and their notes. Choose one for the settings-page UI change, then use a review profile for an independent review of the diff.
|
|
|
|
The orchestrator reads the profiles, selects settings for each task, and launches the workers. Notes guide that choice; put the worker's actual assignment in its task prompt.
|
|
|
|
The bundled [Paseo skill](/docs/skills#paseo-paseo-reference) instructs agents to check profiles and read their notes before delegating. If none fit, it directs the agent to discover configured providers and models and tell you about the fallback.
|
|
|
|
See [Common workflows](/docs/orchestration-workflows) for delegation examples or the [MCP reference](/docs/mcp#agent-profiles) for the tool interface.
|