Skip to content
Browse the docs

Agent settings

Change an agent you own: name, ACP agent, session defaults, access, packs, secrets, knowledge, runtime, automations, startup tasks, hooks, and activity.

Updated 2 min readView as MarkdownOpen in Nested

Agent settings is where the owner of an agent edits it and manages its deployment. Other people can chat with a shared agent but see “You can chat with this agent, but only its owner can change settings.”

Before you start#

  • You must own the agent.
  • Open settings from any of these places: Settings for {name} on the agent’s row in the sidebar Agents group, Agent settings in the composer’s agent picker, Agent settings in the task panel’s Agent section, the agent’s row in Settings → Agents, or Cmd/Ctrl+Enter on the agent in the command palette.

Sections#

The settings rail lists these sections. Startup tasks, Lifecycle hooks, and Activity sit under Advanced.

SectionWhat you change
AgentName, ACP agent (takes effect on redeploy), Session defaults for every new task, Access (“Who can send tasks”: Only me or Anyone signed in), Resource usage, and Delete agent.
PacksAttach or remove packs from the catalog. Explore previews a pack. Each attached pack shows whether its required secrets are attached.
SecretsVariables the packs declare, marked Required or Optional, with Attach secret or Change secret. Add extra variables that no pack declares.
KnowledgeShared knowledge centers the agent can read or write. See Shared knowledge centers.
RuntimeStatus plus Start, Stop, Deploy, and Undeploy. An Isolated VM badge marks an agent that runs in its own virtual machine. Also the Accounts card for vendor sign-ins. See Agent sign-in and accounts.
AutomationsThis agent’s automations, New automation, and links to the raw bindings: Schedules, Webhooks, Slack, and GitHub.
Startup tasksMessages that run each time the agent process starts. See Startup tasks and lifecycle hooks.
Lifecycle hooksShell or HTTP callbacks before and after sessions and prompts.
ActivityTimeline of lifecycle events, Metrics (turns, tokens), and the agent’s day, week, and month Reports.

Steps#

  1. Open the agent’s settings and select a section.
  2. Make your change. A save bar shows Unsaved changes, or Unsaved · this change restarts the agent when the change needs a restart.
  3. Select Save & redeploy to apply the change now, Save only to apply it on the next deploy, or Discard.
  4. Watch the status line. If a task is still running, Nested does not restart the agent and tells you the change was not applied; try again when the work finishes.

Example#

Rename research to briefing, switch Access to Only me, and select Save only. Later, on Runtime, select Stop to free the cluster overnight and Start in the morning.

Questions

Why can’t I open settings for an agent I use every day?
Only the agent’s owner can change its settings. A shared agent you did not create is chat-only for you.
What is the difference between Stop and Undeploy?
Stop scales the running agent down and keeps its deployment, so Start brings it back. Undeploy removes the deployment; you can Deploy it again later.