Skip to main content

Peer Linking

Peer links create a direct channel between two agents. Once linked, the agents can coordinate with each other instead of relying on you to copy updates, files, and next steps between chats.

For programmatic setup, use REST peer-link management or the Remote MCP linking tools.

Use peer links when a workflow works better as a small team: one agent researches, another writes, another reviews, another updates a tracker, or another prepares a final handoff. Linked agents can communicate across the link to exchange information and keep the work moving.

A peer link lets linked agents:

  • Send direct messages to each other.
  • Coordinate work across separate roles.
  • Hand off context, status updates, and next steps.
  • Pass files or artifacts through peer messages when file attachments are available.
  • Wake a linked agent when coordination is needed.

Peer links do not merge the two agents. Each agent keeps its own identity, instructions, filespace, tools, apps, connected accounts, contacts, collaborators, budgets, and limits unless you configure those separately.

Peer links are useful when the same workflow has distinct responsibilities.

Examples:

  • A market research agent gathers sources, then links to a writing agent that drafts a brief.
  • A sourcing agent finds candidates, then links to a screening agent that reviews resumes.
  • A support triage agent summarizes escalations, then links to a customer themes agent.
  • A data cleanup agent prepares a spreadsheet, then links to a reporting agent that creates the summary.
  • A reviewer agent checks another agent's output before anything is shared externally.

If one agent can do the whole job cleanly, keep it simple. Use peer links when splitting the work makes the workflow clearer, safer, or more repeatable.

Open the agent you want to link from, then use the settings gear in the top toolbar.

In the quick settings panel, click More Settings.

On the full settings page, click Integrations.

The peer-link controls appear in Agent Contacts (Peer Links).

Choose the agent to connect, then review the communication limits.

Then:

  1. Open the Integrations section.
  2. Find Agent Contacts (Peer Links).
  3. Click Add Peer Link.
  4. Choose the agent to connect.
  5. Review or adjust Messages per Window and Window Hours.
  6. Save the peer link.

If no agents are available in the picker, there may not be another eligible agent for this account or organization yet.

After the link exists, ask one agent to work with the other by name and describe the handoff.

Examples:

Work with the Market Research Agent to gather current competitor notes, then use that input to draft a concise launch brief.

Ask the Candidate Sourcing Agent for its latest shortlist. Review the candidates and prepare interview notes for the top five.

Send the cleaned CSV to the Reporting Agent and ask it to build the weekly summary from that file.

Good peer-link requests include:

  • Which agent should be contacted.
  • What information or artifact should be shared.
  • Which agent owns the next step.
  • Whether either agent should wait for approval before sending messages, editing files, or contacting people.

You can also ask Meta Agent to connect agents as part of setup or cleanup work.

Example:

Connect the account research agent to the call prep agent, then brief them on how to hand off target account notes.

Meta Agent should show the proposed link and any briefing messages before making changes.

Message Quotas And Loops​

Peer links include message-window limits. These limits help keep linked agents from getting stuck in rapid back-and-forth loops.

When you create or edit a peer link, you may see settings such as Messages per Window and Window Hours. Keep the defaults unless you have a specific reason to allow more frequent coordination.

Removing a peer link stops future direct coordination between the two agents. Historical peer messages remain in the relevant timelines, so you can still review what happened.

Use removal when:

  • The workflow is finished.
  • The agents no longer need to coordinate.
  • You linked the wrong the platform.
  • You want to simplify a setup that became too noisy.

Troubleshooting​

I do not see another agent in the Add Peer Link picker. The other agent may not be eligible for linking from this account or organization, or it may already be linked.

The linked agent did not receive the message. Ask the sending agent to confirm it used the peer message channel. Plain chat text does not deliver a message to another agent by itself.

The agents are talking too much. Reduce the peer link quota, pause one agent, remove the link, or tell the active agent to summarize and stop after one handoff.

A file did not transfer. Ask the sending agent to attach or reference the specific file. Files do not automatically become shared just because two agents are linked.

Last updated on