プロジェクトチャット

Atoms とチャットしてアプリを構築する

タスクを開始し、変更を重ね、途中で中断しても中断したところからそのまま再開できます。このページでは、メッセージで利用できるすべての操作と、問題の報告 が表示されたときの対処方法についても説明します。

チャットでエージェントチームと一緒に構築する

チャットパネルは、あなたとエージェントが作業を進める場所です。やりたいことを普段の言葉で伝えれば、あとはチームが対応します。チームリーダーの Mike がリクエストを読み取り、具体的な作業指示に落とし込み、Engineer の Alex のような適切な専門担当に引き継ぎます。引き継ぎの流れはすべて目の前で行われるため、誰が何をしているのかを常に把握できます。

チャットは構築リクエストのためだけのものではありません。なぜ何かがそのように動作するのか、用語の意味は何か、あるいはチームが今何を変更したのかを尋ねれば、そのまま会話の中で回答を得られます。

タスクを開始する

チャット下部のプロンプトボックスに入力して Enter キーを押します。実装方法ではなく、望む結果に焦点を当ててください。

医療機器を宣伝するためのランディングページを作ってください。

送信すると、作業はすぐに可視化されます。Mike が「Processed N steps」というラベルの付いたアクティビティカードを投稿します。展開すると、アクティビティの説明をステップごとに読めます。

その後、Mike はセクション、制約、品質ルールを含む詳細な作業指示を書き、@ メンションで専門担当に委任します。作業指示の全文と、専門担当が引き継ぎを受ける様子が表示されます。

Project チャットで、Mike がランディングページの構築を Alex に割り当てています。

作業の進行をリアルタイムで追う

各エージェントの返信にはアクティビティカードが付いています。展開すると、各ステップのアクティビティ説明に加え、ファイルの読み取り、コードの記述、ターミナルコマンドの実行、画像生成、レンダリングされたページの確認など、具体的な操作を示すツールカードを確認できます。

Alex が構築を進めている様子: 各ステップには説明が付き、「Read file」や「Generate Images」のようなツールカードで何が起きたかが正確に示されます。

タスクが完了すると、最後の返信で何が変更され、どのように検証されたかが要約されます。たとえば「Version 1: Launch publishing hero」のような バージョン カードは、納品されたビルドを固定表示するため、プロジェクト内の各マイルストーンに後から参照できる名前が付きます。

Version 1 カード付きの、Mike による完成したビルドの要約。

その場で変更を追加する

反復作業のために最初からやり直す必要はありません。次の考えをそのままフォローアップメッセージとして送信してください。違いだけを説明すれば、チームが既存の内容の上に適用します。

テーマを緑にする必要があります。

エージェントがまだ作業中でもフォローアップを送信できます。処理を中断することはなく、メッセージはキューで待機し、現在のタスクが終わり次第実行されます。メッセージがキューにある間も、あなたはそのメッセージを管理できます。

• 実行前に表現をより明確にしたい場合は編集できます。
• 気が変わった場合は削除できます。
• 後のリクエストを先に実行したい場合は、キューの順序を変更できます。

Version 1 が納品された直後に、すでにフォローアップの変更が進行中です。

フォローアップも他のタスクと同じ流れで処理されます。Mike が範囲を定めた作業指示に変換し、専門担当が適用と検証を行い、その結果が次のバージョンとして届きます。

フォローアップが完了: Version 2 では、他のすべてを維持したまま緑のテーマが適用されています。

タスクを中断して続行する

構築の途中で重要なことを忘れていたと気づきましたか？ 終わるまで待つ必要も、作業を捨てる必要もありません。

1. エージェントの作業中に生成を停止します。そこまでに完了した内容はすべて保持されます。
2. 抜けていた内容、制約、または修正点を入力します。
3. もう一度送信します。Mike が新しい情報を反映した更新版の作業指示を作成し、チームはゼロから作り直すのではなく現在の状態から続行します。

Alex の構築を途中で止めて、忘れていた要件「その機器は主に心臓関連です」を追加しているところ。

再送信後、Mike は新しい詳細を反映した更新版の作業指示を発行し、作業が再開されます。

各メッセージでできること

チャット内のメッセージは単なるテキストではありません。各メッセージの下にある操作列を使えば、文字を入力しなくても対応できます。

エージェントのメッセージでできること

• Revert（戻る矢印）: そのメッセージによる変更前の状態にプロジェクトを戻します。使用前に対象のバージョンを確認し、削除される可能性がある内容を確認してください。
• Copy: メッセージ本文をコピーします。説明や要約を保存したいときに便利です。
• Helpful / Not helpful: 納品結果を高評価または低評価して、チームに受け止められ方を伝えます。
• More options（…）: 追加の操作を開きます。問題が発生したときにサポートチームへ直接つながる Feedback も含まれます。
• Activity card: 「Processed N steps」を展開または折りたたんで、進行状況の詳細や返信の裏で使われたツールを確認します。
• Version card: 完了したタスクに付属する名前付きのビルドです。
• Identity label: 各メッセージには、Mike | Team Leader、Alex | Engineer のように誰が話しているかが表示されるため、複数エージェントでの作業も追いやすくなります。

自分のメッセージでできること

• 自分のメッセージはチャットの右側に表示され、チームの返信と視覚的に区別されます。
• メッセージはいつでも送信できます。チームが待機中ならすぐに実行され、タスク進行中ならキューに入ります。

問題の報告: 問題を確認して復旧する

構築中に問題が発生することがあります。問題の報告 を使うと、失敗内容を確認し、復旧方法を選べます。エージェントが問題に遭遇すると、画面左下に 問題の報告 の通知が表示されます。

通知で確認できること

• 何が問題だったのかの短い説明。
• AI が報告された問題を分析し、修正を適用しようとする Resolve ボタン。
• 右側パネルで 問題の報告 の詳細を開く展開コントロール。エラーログ、スタックトレース、システム情報を確認できるため、対応前に失敗内容を理解できます。

Resolve を選んで修正を試みることも、先に 問題の報告 の詳細を読んでから判断することもできます。

問題の報告 カード: 中央の青い Resolve ボタンと、右側の展開コントロール。

シナリオ 1: ページが固まり、Resolve ボタンがない場合

ページがフリーズしたり応答しなくなったりして、問題の報告 が表示されない場合は、手動で報告してください。

1. エージェントとのチャットを開きます。
2. 最新のメッセージにある「…」（その他のオプション）をクリックします。
3. Feedback を選択し、Chat Link と問題のスクリーンショットを添付します。

これはサポートチームに直接送られ、担当者があなたに直接フォローアップします。

シナリオ 2: Resolve ボタンが表示されている場合

ステップ 1 — Resolve をクリックする

Resolve を 1 回だけ選択します。AI エージェントが報告されたエラーを分析し、修正を適用しようとします。試行が完了するまで待ち、その後で結果を確認してから続行してください。

1 回クリックしたら待ってください。 試行が終わる前に Resolve を繰り返しクリックすると、重複した修正タスクが発生し、全体が遅くなります。

ステップ 2 — 結果を確認する

修正が完了すると、プレビューは自動的に更新されます。変化がないように見える場合は、まず ブラウザ を更新してください。通常の原因は古いキャッシュです。

ステップ 3 — 問題が解決しない場合

技術的な詳細は右側パネルのエラーログで確認できます。自分で対応したくない範囲の修正であれば、サポートに引き継いでください。

1. エージェントとのチャットを開き、最新メッセージの「…」→ Feedback をクリックします。
2. Chat Link とエラーのスクリーンショットを添付します。
3. サポートチームが調査し、解決するまで一緒に対応します。

完全なリファレンス: 問題の報告 — Atoms ヘルプセンター.

FAQ

この FAQ で使われる用語: Preview は、現在のプロジェクト状態をエディター内で表示するビューです。 latest version は最新の保存済みビルド、 last working version は使用可能であることを確認した直近のビルドです。 published site または live site は、デプロイ後に訪問者が見るものです。 Chat Link を取得するには、該当するチャットを開き、Support に連絡する前にチャットの共有メニューまたはその他のオプションメニューからリンクをコピーしてください。

チームがまだ作業中でも新しいリクエストを送れますか？

はい。新しいメッセージはキューに入り、現在のタスクが完了すると順番に実行されます。キューに入ったメッセージが実行されるまでは、編集、削除、またはキュー内で前後に移動できます。

途中でタスクを止めた場合、作業内容は失われますか？

いいえ。停止する前に完了していた内容は保持されます。足りなかった詳細を追加して再送信すれば、チームは現在の状態から続行します。

メッセージによる変更を元に戻すにはどうすればよいですか？

そのエージェントメッセージの下にある戻る矢印の操作を使って、変更前の状態に戻してください。対象バージョンを確認し、削除される内容を確認したうえで、より明確な指示でリクエストを再送信してください。

Resolve をクリックしましたが、まだエラーが残っています。どうすればよいですか？

まず右側パネルのエラーログを確認してください。それでも解決しない場合は、エージェントの最新メッセージにある「…」→ Feedback を使い、Chat Link とスクリーンショットを添付してください。そこからはサポートが対応します。

タスクの途中で ブラウザ を閉じたらどうなりますか？

ブラウザ を閉じている間も、タスクはクラウド上で継続する場合があります。戻ったらタスクの状態を確認し、最新の結果を確認してください。バックグラウンド作業を止める必要がある場合は、プロジェクトを再度開き、利用可能になったら Stop を選択してください。

AI エージェントが応答しなくなった場合はどうすればよいですか？

症状に応じて次の復旧手順を使ってください。同じプロンプトを繰り返し送信するのは避けてください。

1. 問題の報告 が表示されている場合は、詳細を展開してエラーを確認してから Resolve を 1 回だけ選択します。
2. タスクがまだ実行中の場合は、 Stop を 1 回だけ選択し、状態が落ち着くまで待ちます。
3. ページがフリーズしている場合は、更新するか新しいタブでプロジェクトを開き、タスクの状態を確認します。
4. 出力が繰り返されたり誤っていたりする場合は、 Preview と最新バージョンを確認してください。使える結果を残すか、最後に正常に動作したバージョンから リミックス を使います。
5. モデルエラーが表示される場合や複数のプロジェクトに影響が出ている場合は、表示されている詳細を記録し、Atoms のステータスページを確認してください。

問題が続く場合は、Chat Link、最後のプロンプト、表示されている状態、スクリーンショット、時刻とタイムゾーン、影響範囲を添えて Support に連絡してください。パスワード、トークン、その他の秘密情報は削除してください。

エージェントがループしたり同じことを繰り返したりするのはなぜですか？

1. まず上記の共通復旧手順を使ってください。実行中の処理を停止し、Preview と最新バージョンを確認し、結果が使えない場合は リミックス を使います。

その手順の後もループが再発する場合は、Chat Link、繰り返されている操作、最後のプロンプト、時刻とタイムゾーン、スクリーンショットを添えて Support に連絡してください。パスワード、トークン、秘密の値は含めないでください。

エージェントが指示に従わないのはなぜですか？

エージェント があなたの指示を無視したり誤って解釈したりする場合は、次の 4 つの手順を試してください。

1. プロンプトを改善する — 明確かつ具体的にしてください。具体的な基準を使います（例: 「ボタンを改善して」ではなく、「メインボタンの背景色を #0055FF に変更し、モバイル表示では中央揃えにしてください」）。

2. Design Mode を使う — Design Mode に切り替え、変更したい UI コンポーネントを直接クリックします。これにより、エージェント はその特定の要素にのみ変更を適用します。

3. 複雑なタスクを分解する — 一度に 1 つの変更だけをプロンプトで指示し、結果を確認してから次の要件に進みます。

4. 期待結果と実際の結果のスクリーンショットを提供する — 実際の結果のスクリーンショットを撮り、期待する結果の参照画像を共有します。視覚的な比較により、エージェント はすぐに意図を理解できます。

エージェントは完了したと言っていますが、実際には何も変わっていません。何が起きたのでしょうか？

1. 最新バージョンを開き、変更されたページまたはファイルを、依頼した結果と比較してください。
2. Preview が正しいのに公開サイトが古い場合は、Publish を開いて Update を選択してください。デプロイが最新になるまで待ってから、ライブサイトを強制再読み込みしてください。
3. ブラウザ だけが古い状態に見える場合は、強制再読み込みまたはシークレットウィンドウを使ってください。
4. 関連する変更が存在しない場合は、対象ページ、要素、期待する結果、保護すべき領域、受け入れ基準を明記して再試行してください。

エージェントが対応する変更なしに成功を繰り返し報告する場合は、Chat Link、対象ページ、期待結果と実際の結果、バージョン番号、スクリーンショットを添えて Support に連絡してください。

会話の前半で伝えた内容をエージェントが忘れてしまうのはなぜですか？

長いスレッドや目的が混在したスレッドでは、以前の要件の影響が弱くなることがあります。自然な区切りのタイミングで、最後に正常に動作したバージョンから リミックス を使い、次の短い引き継ぎ情報で新しいスレッドを始めてください。

• 目標と現在の状態
• 完了済みの作業
• 維持しなければならない要件
• 重要なファイル、ページ、またはスクリーンショット
• 次の単一タスクとその受け入れ基準

新しいスレッドでは、続行する前に最初の結果を確認してください。無関係な作業は別々のスレッドに分け、エージェントが競合する指示を調整しなくて済むようにしてください。

AI エージェントの現在の機能と制限は何ですか？

エージェントは、アプリケーション UI の作成と修正、範囲を限定した動作の実装、接続されたサービスの利用、そしてあなたが提供するプロジェクトコンテキストを使ったエラー調査を支援できます。対象、制約、期待する結果が明確なときに最も効果を発揮します。

エージェントは、明示されていない要件を推測できること、生成されたすべての変更が正しいこと、または外部の本番サービスが正常であることを保証できません。また、長いスレッドや目的が混在したスレッドでは重要なコンテキストを失うこともあります。

信頼できる結果を得るには、一度に 1 つの検証可能なタスクを与え、変更してはいけないものを保護し、Preview と最新バージョンを確認し、重要なフローをテストし、公開前にセキュリティ、請求、本番データの変更を確認してください。

エージェントが応答せず、モデルが過負荷だと思います。どうすればよいですか？

応答しないエージェントだけでは、モデルが過負荷であるとは断定できません。上記の共通復旧手順を使ってください。複数のプロジェクトやモデルに影響が出ている場合は、Atoms のステータスページを確認してください。それ以外の場合は、結果を確認して、より小さなリクエストを 1 つだけ再試行するか、最後に正常に動作したバージョンから リミックス を使ってください。

問題が続く場合は、Chat Link、モデル、最後のプロンプトの要約、時刻とタイムゾーン、スクリーンショット、影響範囲を添えて Support に連絡してください。機密のプロンプトデータや秘密情報は削除してください。

タスクが止まっているように見え、ページもフリーズしています。どう復旧すればよいですか？

フリーズしたページについては、上記の共通復旧手順を使ってください。更新するか新しいタブでプロジェクトを開き、タスクの状態を確認し、実行が続いている場合は Stop を選択してください。それでもフリーズしたままの場合は、完全な Chat Link、アカウントのメールアドレス、スクリーンショット、発生時刻、最後に成功したメッセージを添えて Support に連絡してください。

ページがまだフリーズしている場合は、完全な Chat Link、アカウントのメールアドレス、スクリーンショット、発生時刻、最後に成功したメッセージを提供してください。

モデルエラーが表示されています。これは何を意味しますか？

1. 正確なエラーテキストまたはコード、選択したモデル、タスク、プロジェクト、時刻を記録してください。その後、1 回だけ再試行するか、最後に正常に動作したバージョンから リミックス を使ってください。同じリクエストを繰り返し送信しないでください。

エラーが続く場合は、正確なコード、Chat Link、モデル、再現手順、個人情報を除いたスクリーンショットを添えて Support に連絡してください。パスワード、トークン、個人データ、機密のプロンプト内容は削除してください。