アプリで AI を使う

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

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

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

Atoms Cloud が接続されていない、または AI が利用できない場合は、エージェントに Atoms クラウドの接続を依頼するか、続行する前に Atoms Cloud を確認してください。

Atoms クラウドで AI Library を開く

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

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

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

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

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

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

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

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

機能を明確に説明する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

追加するスクリーンショット: AI Usage をクリーンなテストプロジェクトで表示し、 Overview 、 Total Credits Used 、および Active Models を示します。 AI Usage タブをオレンジ色で強調表示してください。一覧が理解しやすいように現在のモデル名は見えるように保ちつつ、アカウント詳細、ワークスペース情報、および不要な残高情報はマスクしてください。キャプション: 「プロジェクトのクレジット使用量とアクティブなモデルを確認するには AI Usage を開きます。」 代替テキスト: 「プロジェクトで使用されたクレジットとアクティブなモデルを表示する AI Usage タブ。」

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

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

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

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

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