Browse Platform
Platform · Project

Agents

Configure reusable project agents with identity, memory, security, and Workspace defaults.

3 min read

An Agent is a reusable project identity and configuration that can be assigned to Workspaces and automated work. Open Advanced → Agents to review each agent's memory, security mode, status, description, and health.

Usually managed automatically

Workspace setup automatically creates and configures the default Agent. Most teams manage its day-to-day behavior through Personalization in the Workspace UI. Use this page when you need to inspect how that Agent connects memory, session records, permissions, and execution Flows, or when you are creating an additional project Agent.

The light-mode Agents page with the active default Workspace agent
Screenshot previewThe light-mode Agents page with the active default Workspace agent
The light-mode Agents page with the active default Workspace agent

Select an agent name to edit it. Select New Agent to create another agent.

Agent settings

SectionWhat it controls
Agent Name, icon, and DescriptionIdentify the agent to users and administrators. Use the description to state its role and boundary.
AGENT.mdSupplies the agent's durable operating instructions. Keep credentials out of this text.
Persisted MemoryLinks an Index used to search long-term memory. The Agent's Documents folder stores durable memory files and per-session logs that can be indexed for later retrieval. The page can create or repair the folder and Index.
SecurityDefines the Agent's permission boundary and chooses whether execution uses the initiating user's access or an independent agent identity.
Workspace DefaultsSelects the Flow used for Agent execution, the scheduled Flow, primary Skill Collection, and Flow-property defaults used when the Agent works in a Workspace.

The list summarizes Memory, Security, and Status. Health warnings can identify an agent with no Flow, no background approver, or no mapped identity user.

Agent identity and security

ModeIdentity and accessChoose it when
Use initiating user's security (copilot style)Each run uses the initiating user's effective Connection, Skill, and project permissions. Different users can therefore give the same Agent different access. Actions that require user approval remain tied to that interactive user's security context.The Agent assists a signed-in person and should never have broader access than that person.
Use independent agent identityThe Agent runs as a dedicated identity with its own groups, resource permissions, status, background approver, and notification configuration. Its access remains consistent regardless of which user or schedule starts the work.The Agent performs scheduled, shared, or unattended work that needs a stable, explicitly reviewed permission boundary.

Independent identity does not mean unrestricted access. Administrators must keep the identity active, map its identity user correctly, choose a background approver, and grant only the required resources. Connection tool enablement and approval policies still apply in both modes.

Only account or project administrators and owners can manage the sensitive security controls. Suspend an identity before investigating unexpected access; archive an Agent only after checking Workspaces, API keys, queues, templates, and scheduled work that reference it.