Multica Docs

コメントでエージェントを @メンションする

コメントで @ を使ってエージェントをメンションし、ちょっと見てもらいましょう — 担当者の変更も、ステータスの変更もなく、割り当てより軽い操作です。

コメントエージェント@メンションするのは、より軽いトリガーです — 担当者の変更も、ステータスの変更もなく、ただエージェントに現在のイシューを見てもらうよう軽く促すだけです。割り当て(エージェントを担当者にしてイシューを渡すこと)と比べると、@メンションは「この部分をちょっと見て」「別の角度から分析して」「ちょっと呼び込んで一緒に議論しよう」といった場面に向いています。

コメントでエージェントをメンションする

メンバーをメンションするのと同じです — @ を入力してピッカーを開き、エージェントを選んでください。コメントが投稿されると、Multica はメンションされた各エージェントに対してそのコメントをトリガーコンテキストとして、すぐに task をキューに入れます。エージェントがタスクを受け取ると、次のものを読めます。

  • イシュー全体(説明 + すべての過去のコメント)
  • トリガーコメント自体 — 今回の実行の起点として

@mention の Markdown 構文、ピッカー、そして @all のセマンティクスは コメントで扱います。

コメントでスクワッド@メンションすることもできます。 同じピッカーがメンバーやエージェントと並べてスクワッドも表示します。スクワッドを選ぶと [@SquadName](mention://squad/<uuid>) が挿入され、スクワッドのリーダーエージェントが応答を調整するようトリガーされます — 担当者とステータスはそのまま維持されます。

割り当てとどう違うか

どちらもエージェントを働かせますが、仕組みはまったく異なります。

観点割り当て@メンション
assignee の変更
status の変更
task のキュー追加すぐに(Backlog 以外)すぐに
トリガーコメント ID任意常に現在のコメントを含む
1 回の操作あたりの対象エージェント1(担当者 1 名)複数(1 つのコメントで複数を @ 可能)
優先度イシューから継承イシューから継承

判断の目安は単純です。エージェントに「これからこのイシューを所有してほしい」なら割り当てを、「現在のコンテキストをちょっと見てほしい」なら @メンションを使ってください。

複数のエージェントを @ するとどうなるか

1 つのコメントで複数のエージェントを @メンションすると、各エージェントは自分のランタイムで独立した task をキューに受け取ります — 互いをブロックすることなく並列に実行されます

同じイシューで、あるエージェントがすでに queued または dispatched 状態の task を持っている場合(たとえば、たった今メンションされてまだ開始していない場合)、今回のメンションは重複排除され、重複した task はキューに追加されません。重複排除は単一のコメント単位で適用されます — 数秒間隔で投稿された別々の 2 つのコメントが両方とも同じエージェントを @ すると、どちらも task をキューに入れます。

コメントを編集して @ を追加しても、再トリガーされません。 投稿した後で @agent を追加しなければと気づいた場合、編集で入れた @ は表示される内容を変えるだけで、そのエージェントに新しい task届けません。トリガーするには、新しいコメントを投稿するか、イシューをそのエージェントに割り当ててください。

@all はどのエージェントもトリガーしない

@all で全員を呼ぶとき、ワークスペースのメンバーだけがインボックスに入り、エージェントは @all の展開に含まれません。 これは意図された設計です。エージェントはインボックス通知を受け取らないため、@all はエージェントにとって意味を持ちません。エージェントを働かせるには、名前で直接メンションしてください。

エージェントが自分自身を @メンションしてもループしない

エージェントは実行中にコメントを投稿でき、そのコメントには @mention が含まれることがあります。Multica にはハードコードされたガードがあります。コメントの作成者が @ メンションの対象エージェントと同じ場合、そのメンションはスキップされます — 「エージェント A がエージェント A を @ → 新しい task → 再びエージェント A を @」のような無限ループは発生しません。

このガードは直接的な自己参照だけをブロックします。 エージェント A がエージェント B を @メンションするのは正常に動作し、その後 B が応答で A を @メンションすると A が再びトリガーされます — つまり間接的な再帰はブロックされません。エージェントの指示を書くときは、複数のエージェントが互いを @メンションして循環を作らないよう注意してください。

次へ

  • スクワッド — スクワッドを @メンションすると、リーダーが質問を適切なメンバーにルーティングします
  • チャット — イシューと無関係な 1 対 1 の会話
  • オートパイロット — エージェントがスケジュールに沿って自動的に作業を開始するようにする
  • コメント@mention の構文、ピッカー、そして @all のセマンティクス