Valet|Docs
Sign up

Dashboard: Interacting with Your Agent

An agent's page has three tabs: Blueprint — how it is set up — Sessions, and Source. This page is about the last two, and about changing an agent by talking to it.

Sessions

A session is one conversation with the agent, wherever it happened. The Sessions tab lists them all — where each one came from, how many messages it holds, its status, and when it was last active — with a search box across the loaded list.

This is the record of what your agent has been doing. A Slack thread, a scheduled run at 6am, an email that arrived overnight, and a chat you started yourself all show up here as sessions you can open and read.

Talking to it

New Session starts a conversation from the dashboard. No channel setup is needed — this surface always works, which makes it the right place to try an agent before anyone else meets it.

Opening a session shows the conversation streaming live as the agent works. You can reply in the composer, and you can attach files: drop them onto the page or add them from the composer, and the agent works with what you sent.

Revising it with chat

Revise with chat, on the Blueprint's Objectives section, is how you change what an agent does without editing anything by hand. It opens a draft and a conversation with Valet's architect: describe the behavior to adjust or the new skill the agent should learn.

The edits stream into a read-only file viewer beside the chat — SOUL.md, channel prompts, and skills updating as you talk — so you can see exactly what is changing. Deploy when you are happy with it, or discard the draft and nothing happens to the running agent.

  • The live agent keeps running the old version until you deploy.
  • Deploying produces a new version, and the status pill counts up: v12, v13.
  • One draft at a time per agent, so two people revising the same agent do not overwrite each other.

Reading the source

The Source tab is a read-only browser of what the agent is actually running, at the deployed version's commit, opening on SOUL.md. Use it to confirm what changed. To edit, use Revise with chat, or work from the CLI draft workflow.

Sharing an agent's shape

Share agent, in the header menu, creates a link (valet.dev/s/<id>) that lets anyone build their own copy of the agent. It gives no access to yours. The link carries the creation prompt — editable in the popover — plus the integrations and skills to seed. It carries no instructions, files, configuration values, or credentials: the recipient's agent is regenerated in their own organization, connected to their own accounts.

  • The popover shows how many agents have been created from the link.
  • A recipient without an account sees a preview, signs up, and lands one click from their own draft.
  • A share link is unlisted: anyone holding it can use it, and it cannot be revoked.
  • Sharing is available for agents created from a prompt or a template. Agents created from the CLI or Git have no recorded creation prompt to share.

Restarting and destroying

The header menu also holds Restart agent, which brings the agent back up without changing anything, and Destroy agent, which stops it for good.