Atoms Agents を使うと、プロジェクトの Chat から計画、構築、調査、分析、改善を行えます。チームモードをオフにすると Alex への集中的な依頼になり、オンにすると Mike と専門チームに依頼できます。このガイドでは、モードの切り替え、エージェントへのメンション、質問やプランの進行確認、フォローアップのキュー登録、バージョンの確認、誤った結果からの復旧方法を説明します。

エージェントのチームワークの仕組み

チームモード がオフの場合、Alex がリクエストを処理します。作業に Mike による複数段階の調整が必要な場合や、Product Manager、Architect、Data Analyst、または利用可能な他の専門担当者にメンションしたい場合は、チームモードをオンにしてください。

チームモードでは、作業があるエージェントから別のエージェントへ引き継がれることがあります。アクティブな作業がなくなるまで、Working Processとエージェントのメッセージを確認してください。結果によって Version カードが作成された場合は、Previewを選択してApp ビューアーで開き、公開したり別の変更を依頼したりする前にテストしてください。

チームモードをオンまたはオフにする

チームモード の切り替えは、Chat 入力欄の横にある + メニュー内にあります。スイッチがオフのときは Alex がリクエストを処理します。オンのときは、Chat で Mike と利用可能な専門エージェントを使用できます。

切り替える前に: ディープリサーチまたは Atoms クラウド がアクティブな間は、チームモードを変更できません。ディープリサーチでは Iris のみを使用するため、通常の Group Members リストは利用できません。現在の Chat に表示されているエージェントを使用してください。チームモードがオンに固定されていて Alex が表示されている場合は、エンジニアリング作業のために Alex を直接メンションしてください。標準のチームモードの選択肢を使うには、その専用ワークフローを離れて通常のプロジェクト Chat を開いてください。

1. プロジェクト Chat を開きます。
2. メッセージボックスの横にある + を選択します。
3. メニューで、チームのワークフローを使う場合は チームモード をオンにします。Alex にリクエストを処理させたい場合はオフにします。
4. メニューを閉じて、リクエストを入力し、送信します。

チームモードがオフの状態で @ を入力すると、Chat に Switch to team mode to mention Agent と表示されます。Teamを選択するとチームモードがオンになり、Group Membersが開きます。Engineerを選択するとピッカーが閉じ、メンションなしで引き続き Alex と作業できます。

チームモードをオンまたはオフにする

Mike に作業を調整してもらう

チームモード がオンで、Mike が Group Members に表示されている場合、どのエージェントが作業を担当すべきかを Mike に判断してほしいときは、@ メンションなしでメッセージを送信してください。これは、複数の段階にまたがる成果を得るための最も簡単な方法です。ディープリサーチがアクティブな場合は、代わりに Iris を使用してください。

1. Mike が利用可能であることを確認します。スイッチが利用可能な場合は チームモード をオンにします。スイッチがロックされている場合は、Mike が Group Members に表示されているときのみこのワークフローを使用してください。
2. 最終的な成果、プロジェクトの現在の状態、重要な制約、結果をどのように評価するかを説明します。
3. Mike が調整できるように、@ メンションなしでリクエストを送信します。明示的に Mike 宛てにするには、@ を入力して Group Members の下にある Mike を選択します。
4. Working Process とエージェントのメッセージを確認します。質問が表示されたら回答してください。Plan カードの準備ができたら、続行するには Approve を選択し、プランの修正が必要な場合はその矢印メニューを開いて Decline を選択します。

この種類のリクエストでは、各ステップを自分で割り当てなくても、Mike が作業を計画するのに十分な情報を提供できます。

エージェントに直接メンションする

誰に集中的なタスクを渡すべきか分かっている場合は、そのエージェントにメンションしてください。

1. 通常のプロジェクトでは、Chat 入力欄の横にある + を選択して チームモード をオンにします。専用ワークフローによってモードが固定されている場合は、この手順をスキップし、現在の Chat に表示されているエージェントのみを使用してください。
2. メッセージボックスに @ を入力します。
3. Group Members の下でエージェントを選択します。
4. メンションの後に、タスク、重要なコンテキスト、変更してはいけない点、期待する結果を説明します。
5. メッセージを送信します。

Group Members からエージェントを選択する

通常、Group Members には Alex、Bob、David、Emma、Mike が含まれます。Sarah と Adrian は、対応している shadcn/ui または Atoms クラウド のプロジェクトで表示されます。ディープリサーチが有効な場合、メンションピッカーには Iris のみが表示されます。Chat に表示されているリストを正しい情報源として使用してください。

エージェント	役割	このエージェントを使う場面
Mike	チームリーダー	タスクに、複数のエージェントにまたがる計画、割り当て、または調整が必要な場合。
Emma	Product Manager	ユーザー、優先順位、スコープ、ワークフロー、または機能のトレードオフを明確にする必要がある場合。
Bob	Architect	システム構造、データモデル、連携、または技術的制約について支援が必要な場合。
Alex	Engineer	プロジェクト実装を構築、変更、修正、またはテストしたい場合。
David	Data Analyst	データ、ファイル、指標、または傾向を分析したい場合。
Iris	ディープリサーチ担当	根拠に基づく市場、競合、オーディエンス、または技術調査が必要な場合。
Sarah	SEO Specialist	対応している Web プロジェクト向けに SEO コンテンツを計画・改善したい場合。
Adrian	Ads Specialist	対応している公開済み Web プロジェクト向けに Google Ads を準備または分析したい場合。

Group Members に表示されていないエージェントにはメンションできません。Mike に利用可能なチームとの調整を依頼するか、必要な専門担当者を有効にする専用ワークフローを使用してください。

複数のエージェントと作業する

同じ チームモード のメッセージ内で、複数のエージェントにメンションできます。これは、互いに上書きしない独立したタスクに使用し、各エージェントが担当すべき部分を明確に示してください。

各割り当てを明確に分け、そのエージェントがプロジェクトを変更してよいのか、それともレビューのみ行うべきかを明記してください。

依存関係のある作業では、すべての段階を一度に複数のエージェントへ送らないでください。順序の調整は Mike に依頼し、あなたの承認が必要になるポイントも含めてください。

成果に必要なエージェントだけを使用し、作業完了後に Credits used を確認してください。

タスク、承認、引き継ぎを確認する

プロジェクトの Chat で作業を確認します。Working Process にはアクティブなエージェントのステップが表示され、質問カードはあなたの回答を待ち、Plan カードは承認待ちとなり、プレビュー可能なバージョンが生成されると Version カードが表示されます。

表示されるもの	意味	行うこと
Working Processにエージェントがアクティブとして表示される	現在のステップがまだ実行中です。	結果を待ってください。Queue が有効な場合は、次の指示を入力して Return を押すと、進行中の作業を止めずにキューに追加できます。
質問カード	ワークフローを続行する前に Mike が情報を必要としています。	各質問に回答し、別のページがある場合はNextを使用して、最後にSubmitを選択します。
Plan カード	提案されたプランの確認準備ができており、実行はまだ開始されていません。	続行するにはApproveを選択します。修正を依頼するには、Approve の横の矢印を開いてDeclineを選択します。
エージェントの最終応答	そのエージェントは割り当てられたステップを完了しました。	リクエスト全体が完了したと判断する前に、Working Processとその後のメッセージを確認してください。
別のエージェントが作業を開始する	作業が別の専門担当者に引き継がれました。	新しいエージェントのメッセージを確認し、情報や承認を求められたら対応してください。
Version カード	プロジェクトで確認可能なバージョンが生成されました。	最新バージョンの場合はPreviewを選択します。過去のバージョンの場合は、まずLoad previewを選択し、その後View Previewを選択します。

文章による回答、Plan、または調査の要約だけでは、プロジェクトが変更されたことは確認できません。リクエストに実装が含まれる場合は、生成された Version カードを確認し、Previewを選択して、App ビューアーでユーザージャーニー全体をテストしてください。

役立つフォローアップを送信する

役立つフォローアップでは、何が変わったか、何をそのまま維持すべきか、結果をどう確認するかをエージェントに伝えます。

エージェントが作業中の間は、次の指示を Chat 入力欄に入力します。入力欄に Press Return to queue the message と表示されたら、Return を押してください。メッセージは入力欄の上にある Queue パネルに追加され、進行中の作業を中断せずに待機します。

Queue パネルは、最初のメッセージがキューに追加されると自動的に表示されます。折りたたまれている場合は展開してください。メッセージをドラッグして順序を変更できます。個々のメッセージでは Send now、Edit、Remove を使用できます。添付ファイル付きのキュー済みメッセージは編集できません。Queue ヘッダーには、Clear queue、Pause processing queued messages、Resume processing queued messages もあります。

Queue が利用できない場合は、現在のタスクが完了するまで待ってからフォローアップを送信してください。同じ指示を繰り返し送信しないでください。重複したリクエストは競合する作業を生む可能性があります。

キューに入れたフォローアップを確認する

作業が止まったり、誤った方向に進んだりしたときに復旧する

まず手順 1 から始め、前の手順で問題が解決しない場合にのみ次へ進んでください。

1. 現在の状態を確認する。 最新のエージェントメッセージと Working Process を確認します。まだアクティブなエージェント、あなたの入力待ちの質問または Plan、または Queue で待機中のフォローアップがないか確認してください。
2. 方向性を修正する。 明確な修正を 1 つ送信します。意図する成果、必要な最小限の変更、変更してはいけない点を説明してください。必要に応じて、それを担当すべきエージェントにメンションします。
3. 必要な場合にのみ進行中の作業を停止する。 Chat 入力欄の右側にある四角い Stop コントロールを選択します。ツールチップには Click if you want to stop all tasks と表示されます。確認画面で Yes, I'm Sure を選択します。これにより、その Chat 内のすべてのアクティブなタスクが停止し、中断された応答には Response stopped と表示されます。
4. 正常だった既知のバージョンを復元する。 完了済みの変更によってプロジェクトの状態が悪化した場合は、プロジェクトヘッダーの Versions を選択します。最後に正常だったバージョンを選びます。必要に応じて、Load preview を選択してから View Preview を選択します。バージョンプレビューで Restore to this version を選択します。確認する前に:
   • Sync database が表示された場合は、慎重に確認してください。これはデフォルトで選択されています。バージョンと一緒にデータベースも復元したい場合はそのままにし、現在のデータベースを保持したい場合は選択を外してください。
   • 確認するには Restore を選択します。プロジェクトは選択したバージョンに戻ります。後のバージョンも Versions に残り、必要に応じて再適用できます。
5. Atoms の問題を報告する。 Atoms 自体が期待どおりに動作していない場合は、最新の関連するエージェントメッセージで ... を開き、Feedback を選択します。現在の chat ID と message ID は自動的に添付されます。正確な手順、期待していたこと、実際に起きたことを説明し、有用であれば分かりやすいスクリーンショットを添えてください。

停止または復元の前に。 タスクが予想より長くかかっているという理由だけで、これらの操作を行わないでください。停止すると進行中の作業が失われる可能性があります。復元は現在のプロジェクト状態を変更し、Sync database が選択されている場合はデータベースも変更される可能性があります。

すべてのアクティブなタスクを停止する

結果、クレジット、機密情報を確認する

公開、更新、または結果を利用する前に、次の点を確認してください:

• 別のエージェントへの引き継ぎを含め、依頼したすべての段階が完了している。
• 最終バージョンが App ビューアー で正しく開く。
• 主要なユーザージャーニーが最初から最後まで機能する。
• エージェントが、変更しないよう依頼した情報、機能、デザインを維持している。
• 結果に個人情報、認証情報、または内部専用コンテンツが含まれていない。

使用したクレジットを確認する

完了したターンの最後のエージェントメッセージで、... を開きます。メニューには Worked for が表示されます。ターン完了後に使用状況が利用可能になると、Credits used が表示されます。ワークスペースの残高を確認するには、プロフィールメニューを開き、デスクトップでは Plans、モバイルでは Plans and credits を選択します。Plans and credits パネルで Credits remaining を確認してください。

完了した各ターンの後に Credits used を確認し、大量の作業を承認する前にプランとスコープを確認してください。

Worked for と Credits used を確認する

パスワード、API キー、認証トークン、支払い情報、または不要な個人情報・機密情報を Chat に貼り付けないでください。

FAQ

有害である可能性があるために Atoms がリクエストを拒否した場合はどうすればよいですか？

要求された結果が安全でない可能性がある場合、Atoms はリクエストを拒否したり、明確化を求めたりすることがあります。その応答を回避するために、有害なリクエストを隠したり、偽装したり、分割したりしないでください。

1. 目的が正当なものである場合は、安全な目的、誰がその作業を承認したか、そして結果が何をしてはいけないかを説明してください。
2. 実在の個人データ、認証情報、機密情報、および他人やシステムに害を与える可能性のある指示を削除してください。
3. 悪用を可能にする指示の代わりに、防御的な説明、安全チェックリスト、または無害な例を求めてください。
4. 送信前に修正したリクエストを見直し、安全なタスクに必要な情報のみに限定してください。

明らかに正当で無害なリクエストがそれでも拒否される場合は、Chat Link と、リクエストの機密情報を伏せたコピーを添えて Atoms Support に連絡してください。意図した用途を説明してください。ただし、機密情報を含めたり、Support に安全制御の回避を依頼したりしないでください。