Customize an AI persona
Save reusable system prompts and tool instructions for different kinds of work.
What this is
An agent profile is a saved persona: a system prompt, optional tool instructions, and a name you can select when starting a new chat. Instead of re-typing "You are a senior Rust reviewer who..." every time, you save it once and pick it from a dropdown.
Profiles come in three scopes:
- Personal — only you see it. This is the default for anything you create.
- Workspace-shared — shared with members of one or more workspaces. Once you share a profile, this is a one-way promotion from personal.
- Platform — curated by a super-admin and available to everyone in the organization.
Before you start
You need the
agent_profiles_use capability to select profiles, and
agent_profiles_create to author your own. Your admin controls both.
Step by step
- Open Agents. Click Agents in the top nav (visible when the capability is enabled). You'll see your personal profiles, any shared with you, and any the platform offers.
- Create a new profile. Click New. Give it a short, descriptive name (e.g. Legal-Reviewer) and write a system prompt that fully captures the persona — tone, output format, things to check for, things to avoid.
- (Optional) Add tool instructions. If the profile should behave differently with tool-using features, put those hints here. Otherwise leave it blank.
- Use the profile in a chat. When you start a new chat, pick your profile from the dropdown. The chat header shows the profile name and version so it's obvious which persona is driving the replies.
- (Optional) Share it with a workspace. From the profile's page, share it into one or more workspaces. The scope promotes from Personal to Workspace-shared on the first share — after that, other workspace members can select it too.
Good to know
- Profiles are versioned. When you edit one, a new version is recorded. Chats remember which version they started with so edits don't retroactively change past conversations.
- The promotion from personal to workspace-shared is one-way — once shared, the profile can't be made fully personal again.
- Super-admins can promote a workspace-shared profile into a platform-wide one from the admin Agents catalog.