Multica Docs

@-mention agents in comments

@-mention an agent in an issue comment, or keep replying, to have it handle new information without changing the assignee.

@-mention an agent in a comment when you want it to look at a new piece of information, answer a question, or help the current assignee. The comment becomes the starting point for the run; the issue's assignee and status stay unchanged.

Assigning vs. @-mentioning

Assign to an agent@-mention in a comment
Best forMaking the agent own the whole issueHaving the agent handle the current comment
Changes the assigneeYesNo
Changes the statusNoNo
Targets per actionOne agent or squadMultiple agents or squads
Focus of the runThe whole issueThe triggering comment, plus comments merged in the same batch

Use assignment when the issue needs a clear owner; use an @-mention to bring an agent into the discussion temporarily.

Trigger preview

After you pick an agent or squad in the comment editor, a trigger preview appears under the input:

  • which agents will start working once you send;
  • whether each target comes from a direct @-mention, the issue assignee, or a squad leader;
  • whether a target is unavailable, or you lack permission to run it.

Unticking an agent skips this one trigger only — you don't need to delete its name from the comment, and the agent's Access is not changed.

Trigger preview before sending: lists the agents that will start working once the comment is sent

Once the comment is posted, an online runtime usually claims the task right away; if the runtime is offline, the task waits in the queue.

Automatic routing of replies

A plain comment (containing no @ at all) is routed by discussion context:

  1. Replying to an agent's comment hands it to that agent.
  2. Replying inside a discussion an agent already participates in keeps that discussion's agent.
  3. A top-level comment that matches neither case goes to the issue's agent assignee; when the assignee is a squad, the leader handles it. A plain reply directly to a member does not fall back to the assignee; @-mention an agent or squad explicitly when you want one to join.

When a comment explicitly @-mentions other targets (including members), the assignee fallback no longer applies.

When a reply triggers an agent other than the assignee, Multica schedules a delayed fallback run for the assignee: if the target agent replies within about 5 minutes, the fallback is cancelled automatically; otherwise the assignee starts a run too.

Coalescing consecutive comments

When the same agent already has a waiting task on the issue, new consecutive comments merge into the pending task; if the agent is already running, later comments wait for the current run to finish and merge into a single follow-up run. You can keep adding information without waiting for the agent to reply.

When one comment @-mentions several different agents, each agent gets its own task; multiple mentions resolving to the same agent keep only one.

Comments that don't trigger agents

Two ways:

  • Start the comment with /note: it's posted as a note between members and triggers no agent.
  • Use @all: it notifies every workspace member and switches off this comment's automatic trigger for the assignee.

If the trigger preview still lists an agent, untick it before sending.

@all does not include agents. Agents have no inbox; to put one to work, @-mention it explicitly, reply in its discussion, or assign the issue to it.

Access restrictions

An @-mention cannot bypass an agent's Access. When you lack permission to run the target, the target is archived, or it has no available runtime, the trigger preview explains that it won't start; the comment itself still posts normally. See Agents for the three Access levels.

Agents mentioning each other

Agents can @-mention other agents in their replies. When A @-mentions B and B @-mentions A back, the system merges duplicate runs at the same moment, but it does not decide when the collaboration should end — write the stop condition into the agent instructions.

Next steps

  • Comments — replies, resolving discussions, notifications, and subscriptions.
  • Agents — configure identity, Access, and runtimes.
  • Squads — have a leader coordinate multiple agents.