The project is the boundary
An agent belongs to one project, and that decides what it can reach: the connections it authenticates with, the flows it can call, the tables and files it looks things up in. Two projects with the same Gmail connection name are two different mailboxes. The Agents page spans every project you can see, so the card tells you which project each agent belongs to. The project filter beside the search box narrows the list, and it also moves the destination under the prompt box to that project. Whatever you pick in New agents go to wins, so check that line before you create anything.Move it to another project
From the... menu on a card, or from Project in the agent’s own Advanced section, pick Move to another project.
The agent takes its instructions, tools and conversations with it. Before you confirm, the dialog says what the move costs:
Tools that stop working
A pinned connection is matched by name in the new project. Anything without a counterpart there stops working until you connect it, and the same is true for a flow or a file the new project does not have.
Accounts change under it
Tools that keep working now use the new project’s accounts. Moving an agent between two clients points it at the second client’s data.
People who lose access
An agent shared with someone who is not in the new project loses that share, and moving it back does not restore it.
Only the person who created the agent, or a project admin, can move or delete it. Everyone else in the project can use and edit it.
Delete it
Delete sits in the same... menu, and in a danger zone at the bottom of the agent’s Advanced section.
Deleting is permanent: the instructions, the tools and every conversation held with the agent go with it. A draft flow step pointing at the agent will break, and the dialog says so.
If a published flow still runs the agent, deleting is refused and the flows are named. Take the agent out of those flows first.
Who can see it
An agent is visible to everyone in its project. A restricted agent, shared with you and named colleagues instead, shows a lock beside its name in the list.There is no screen for restricting an agent yet. Visibility is set through the API, with
visibility and sharedWithUserIds on the agent create and update calls, and only the creator or a project admin can change who can see one. Everyone you share it with has to be a member of its project already, and a move drops the shares that do not hold in the new project.