# Team agents

Source: https://www.hyperagent.com/docs/concepts/teams/team-agents

> For AI agents: the documentation index is at https://www.hyperagent.com/llms.txt and the complete documentation in one file at https://www.hyperagent.com/llms-full.txt. Any docs page is also served as Markdown by appending `.md` to its URL.

Choose between a team-owned agent and a personal agent shared with a team for run-only access.

A team makes an agent available two ways: the **team owns** it, or a person **shares** their personal agent for run-only use. Both let every member run it. They differ in who may change it, which is the decision that matters after the first run.

Either model gets the agent in front of your team today. Only one of them
decides who fixes it next month.

The team's Agents tab keeps the two apart, so you can always tell which model an agent is on.



## Two ownership models [#two-ownership-models]

The agent belongs to the team. Owners and Editors edit its configuration; every member runs it.

* **Who maintains it:** Owners and Editors, together
* **What they can change:** instructions, skills, tools, connected integrations, and its [execution mode](https://www.hyperagent.com/docs/concepts/agents/configuration)
* **Choose it when** the agent's job belongs to the team's workflow rather than one person's

Team ownership also lets agents work as a system. Scout triages a case, [delegates](https://www.hyperagent.com/docs/concepts/agents/agent-delegation) to Scribe when the resolution should become documentation, and hands the approved result toward Press. That handoff lives in the shared configuration, so Owners and Editors maintain it once and Members use it without redefining it each run. How each agent gets started, on a schedule, from Slack, or by another agent, is covered in [Invocations](https://www.hyperagent.com/docs/concepts/agents/invocations).

Scout and Scribe fit here: support and documentation specialists maintain them together.

The agent stays personal and the team gets run-only access. Its owner keeps everything else.

* **Who maintains it:** the person who shared it, alone
* **What the team can do:** run it, and nothing more, whatever their role
* **Its context:** only what was already available to the agent, never its owner's wider library
* **Choose it when** teammates should benefit from the agent without becoming its maintainers

To share, use &#x2A;*Share…** on your agent and pick the team. Nothing transfers: no copy is made, and the team can't edit the source. If Press needs a new publishing connection, only its owner can add it.



Revoking the share is an access decision, not an ownership change: Press stops being runnable through that team, nothing is deleted, and the team keeps no frozen copy. Share it again later and the same relationship comes back rather than a duplicate.

A shared agent uses only the context already available to it. Press keeps its
linked publishing preference, gains nothing else from its owner's personal
library, and absorbs nothing from whoever runs it.

## Move an agent between personal and team [#move-an-agent-between-personal-and-team]

Sharing grants access; a **move** changes who owns the agent. Reach for it when maintenance should change hands: a personal agent whose job has become the team's, or a team agent that should go back to one person.

### Start the import [#start-the-import]

Open the team's **Agents** tab and choose **Import**, then pick the personal agent that should become the team's.

### Review what moves [#review-what-moves]

The confirmation lists what changes hands: the agent's configuration, its own memories, and its threads, which are re-stamped to the team workspace. It tells you how many threads that is before you commit. Linked documents get a per-document choice: copy into the team, or leave behind.



### Confirm [#confirm]

From then on Owners and Editors maintain the agent and every member can run it. The reverse move, demoting a team agent to one person, works the same way, and pauses the agent's automations so a schedule doesn't keep firing under changed ownership.

Whichever model an agent is on, the person who starts a run owns the resulting thread and its outputs. Agent ownership decides who maintains the capability, not who owns the work it produces.

## FAQs [#faqs]

Ask who fixes it next month. If several people should improve it, make it team-owned. If you should keep maintaining it and teammates only need to run it, share it.

No. A shared agent reaches only the context already available to it. It gains nothing from your wider personal library, and it doesn't absorb the context of whoever runs it.

The team stops being able to run the agent through that share. Nothing is deleted, and the team keeps no copy. Share it again later and the same relationship comes back rather than a duplicate.

They do. The thread and everything it produces belong to whoever started the run, on either ownership model. Agent ownership decides who maintains the capability, not who owns the work.

Sharing grants run access and leaves ownership alone. Importing moves the agent into the team, so Owners and Editors maintain it from then on. A move is heavier: threads are re-stamped to the new workspace, and Hyperagent tells you how many are affected before you confirm.
