AI セクションの Atoms クラウド を使用して AI モデルを選択し、アプリで使用し、アプリの AI 使用状況を確認します。

このページでは、ユーザーがアプリ内で操作する AI 機能について説明します。 Atoms クラウド はモデルライブラリとプロジェクトの使用状況情報を提供し、 Chat 内の Atoms Agent がそれらの機能を構築および更新します。

Atoms クラウドの AI を理解する

Atoms デスクトップ版でプロジェクトを開き、 Web モードになっていることを確認します。 AI Library には現在そのプロジェクトで利用可能なモデルが含まれ、 AI Usage にはプロジェクトのクレジット使用量とアクティブなモデルが表示されます。

Atoms クラウド が接続されていない場合、または AI が利用できない場合は、続行する前に Agent に Atoms クラウドの接続を依頼するか、 Atoms クラウド を参照してください。

Atoms クラウドで AI Library を開く

1. App ビューアー がある同じワークスペースのツールバーで、 Atoms クラウド を選択します。
2. サイドバーで AI を選択します。
3. AI Library を開きます。

AI Library には、現在プロジェクトで利用可能なモデルが表示されます。カテゴリーフィルターを参照するか、 Search を使用して適切なモデルを見つけることができます。

ライブラリは時間の経過とともに変わることがあります。古いモデルやプロバイダーの一覧に頼るのではなく、そこに表示されているモデルと情報を使用してください。

リクエストにモデルを追加する

1. AI Library でモデルを見つけます。
2. そのカードで # Add を選択します。Atoms は現在の Chat メッセージにモデルタグを挿入します。
3. タグの後に機能リクエストを完成させてから、そのメッセージを Atoms Agent に送信します。

# Add を選択して、使用したい AI モデルを Agent に伝えます。モデルは Chat メッセージ内にタグとして表示されます。その後、Agent に構築または変更してほしい内容を説明できます。

Chat から直接モデルを添付することもできます。 # と入力し、 AI を選択してから、現在利用可能なモデルの 1 つを選びます。

Chat リクエストにモデルタグを挿入するには # Add を選択します。

機能を明確に説明する

モデルを添付した後、ユーザーの視点からその機能をどのように動作させたいかを Agent に伝えます。次の詳細を含めてください。

説明する内容	Agent に伝える内容
目的	その機能によってユーザーが何を達成できるようになるべきかを説明します。
ユーザージャーニー	ユーザーが何を入力、アップロード、または選択するのか、そして結果をどこで確認できるべきかを説明します。
使用する情報	AI が使用すべき情報と、含めてはならないものを指定します。
期待される結果	望ましい形式、トーン、言語、長さ、および重要な制限を説明します。
読み込み中とエラー	待機中、情報が不足しているまたは無効な場合、そしてリクエストが失敗した場合に、ユーザーに何を表示すべきかを説明します。

機能をどのようにコーディングすべきかを説明する必要はありません。ユーザーが何をするのか、どのような結果を受け取るべきか、そして各段階でアプリがどのように応答すべきかに集中してください。

生成されるレイアウトはプロジェクトによって異なる場合があります。すべてのアプリで同じデザインが使われると期待するのではなく、依頼した動作を確認してください。

選択した AI モデルは Chat composer にタグとして表示されます。

App ビューアーで機能をテストする

Agent が完了したら、 App ビューアー で完全なユーザージャーニーをテストします。個人情報や機密情報を含まない無害なサンプルコンテンツを使用してください。

テスト	実施内容	期待される結果
通常入力	その機能が処理するよう設計されている一般的な例を送信します。	依頼した出力が正しい場所と形式で表示されます。
空の入力	必要な内容を入力せずに続行してみます。	アプリはユーザーが何を入力する必要があるかを説明し、不必要なリクエストを送信しません。
無効な入力	サポートされていない形式、またはその機能で想定される要件の範囲外の内容を入力します。	アプリは引き続き使用可能で、問題について明確な説明を表示します。
読み込み状態	リクエストを送信し、処理中のアプリの状態を確認します。	アプリはリクエストが進行中であることを示し、誤って重複送信するのを防ぎます。
失敗した応答	通常のテスト中にリクエストが失敗した場合、アプリがどのように応答するかを確認します。	アプリは有用なメッセージを表示し、ユーザーが再試行できるようにし、技術的な詳細や個人情報を公開しません。

エラーを発生させるために、意図的に機密データを使用したり、利用可能なクレジットをすべて消費したり、サービスを妨害したりしないでください。遅い応答や失敗した応答を安全に再現できない場合は、代わりにその状況でアプリがどのように処理すべきかを Agent に伝えてください。

Atoms クラウドで AI Usage を確認する

1. Atoms クラウド → AI に戻ります。
2. AI Usage を開きます。
3. Overview の下で、このプロジェクトの Total Credits Used と Active Models を確認します。
4. Active Models の下に一覧表示されているモデルを確認します。

AI Usage にはプロジェクトレベルの概要が表示されます。ウォレット残高、チャージ、およびより広範な Cloud または AI の使用状況の詳細については、 Cloud & AI Wallet を参照してください。

特定の エージェント 応答で使用されたクレジットを確認するには、その応答の下にある ... を選択し、 Credits used を確認します。このメッセージレベルの値は、 AI Usage のプロジェクト概要とは別です。

その Agent 応答で使用されたクレジットを確認するには、メッセージメニューを開きます。

追加するスクリーンショット: AI Usage をクリーンなテストプロジェクトで表示し、 Overview 、 Total Credits Used 、および Active Models を見せてください。 AI Usage タブはオレンジ色で強調表示してください。一覧が理解しやすいように現在のモデル名は見えるように保ちつつ、アカウント詳細、ワークスペース情報、および不要な残高情報はマスクしてください。キャプション: 「Open AI Usage to review project credit usage and active models.」 Alt テキスト: 「AI Usage tab showing project credits used and active models.」

ユーザーデータと認証情報を保護する

AI 機能を通じて送信されたコンテンツは、処理のために選択したモデルプロバイダーへ送信される場合があります。リクエストを完了するために必要な情報のみを送信してください。

パスワード、API キー、アクセストークン、または不要な個人情報や機密情報は絶対に送信しないでください。ユーザーのコンテンツが AI モデルに送信されるタイミングをユーザーが理解できるようにし、組織のプライバシーおよびデータ取り扱い要件に従ってください。

重要な判断に利用する前に、AI が生成した結果を必ず確認してください。詳細については、 Atoms Terms of Service を参照してください。

アプリで外部プロバイダーの非公開認証情報が必要な場合は、 Keys and secrets を使用して保存してください。認証情報を Chat に貼り付けたり、ブラウザで実行されるコードに含めたりしないでください。