在你的 app 中使用 AI
使用 Atoms 雲 的 AI 區段來選擇 AI 模型、在你的 app 中使用它，並檢視 app 的 AI 使用情況。
本頁說明使用者在你的 app 內會互動到的 AI 功能。Atoms 雲 提供模型庫與專案使用資訊，而 Atoms Agent 在 Chat 中負責建立與更新這些功能。
了解 Atoms 雲 中的 AI
在 Atoms 桌面版中開啟專案，並確認其處於 Web 模式。AI Library 包含目前可供此專案使用的模型，而 AI Usage 則顯示專案積分使用情況與啟用中的模型。
如果 Atoms 雲 尚未連線，或 AI 無法使用，請要求智能體連接 Atoms 雲，或先參考 Atoms 雲 再繼續。
在 Atoms 雲 中開啟 AI Library
- 在與 App 預覽 所在相同的工作區工具列中，選取 Atoms 雲。
- 在側邊欄中，選取 AI。
- 開啟 AI Library。
AI Library 會顯示目前可供你的專案使用的模型。你可以瀏覽分類篩選條件，或使用 Search 尋找合適的模型。
模型庫可能會隨時間變動。請以其中顯示的模型與資訊為準，而不要依賴較舊的模型或供應商清單。
將模型加入你的請求
- 在 AI Library 中找到模型。
- 在其卡片上選取 # Add。Atoms 會將模型標籤插入目前的 Chat 訊息中。
- 在標籤後補充功能需求，然後將訊息傳送給 Atoms Agent。
選取 # Add 是為了告訴智能體你想使用哪個 AI 模型。該模型會以標籤形式出現在你的 Chat 訊息中。接著你就可以描述你希望智能體建立或變更的內容。
你也可以直接從 Chat 附加模型：輸入 #，選取 AI，然後從目前可用的模型中選擇一個。
選取 # Add，將模型標籤插入你的 Chat 請求中。
清楚描述功能
附加模型後，請從使用者的角度告訴智能體你希望此功能如何運作。請包含以下細節：
| 要描述的內容 | 要告訴智能體的內容 |
|---|---|
| Purpose | 說明此功能應協助使用者完成什麼。 |
| User journey | 描述使用者會輸入、上傳或選取什麼，以及應該在哪裡看到結果。 |
| Information used | 指定 AI 應使用哪些資訊，以及絕對不能包含哪些內容。 |
| Expected result | 描述偏好的格式、語氣、語言、長度，以及任何重要限制。 |
| Loading and errors | 說明在等待期間、資訊缺失或無效時，以及請求失敗時，使用者應看到什麼。 |
你不需要說明此功能應如何編碼。請專注於使用者會做什麼、應收到什麼結果，以及 app 在每個階段應如何回應。
不同專案產生的版面配置可能不同。請檢查你所要求的行為，而不要預期每個 app 都會採用相同設計。
所選的 AI 模型會以標籤形式出現在 Chat 編輯器中。
在 App 預覽 中測試功能
智能體完成後，請在 App 預覽 中測試完整的使用者流程。請使用無害的範例內容，且不要包含個人或敏感資訊。
| 測試 | 要做什麼 | 預期結果 |
|---|---|---|
| Normal input | 提交此功能設計要處理的一般範例。 | 請求的輸出會以正確的位置與格式顯示。 |
| Empty input | 嘗試在未提供必要內容的情況下繼續。 | app 會說明使用者需要提供什麼，且不會送出不必要的請求。 |
| Invalid input | 提供不受支援格式的內容，或不符合此功能預期需求的內容。 | app 仍可正常使用，並清楚說明問題所在。 |
| Loading state | 提交請求，並在處理期間觀察 app。 | app 會顯示請求正在進行中，並防止意外重複提交。 |
| Failed response | 如果在一般測試期間請求失敗，請檢查 app 的回應方式。 | app 會顯示有用的訊息、允許使用者重試，且不會暴露技術細節或私人資訊。 |
不要刻意使用敏感資料、耗盡所有可用積分，或干擾服務來製造錯誤。如果你無法安全地重現緩慢或失敗的回應，請改為告訴智能體 app 應如何處理該情況。
在 Atoms 雲 中檢視 AI 使用情況
- 返回 Atoms 雲 → AI。
- 開啟 AI Usage。
- 在 Overview 下，檢視此專案的 Total Credits Used 與 Active Models。
- 檢視列在 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 金鑰、存取 Token，或非必要的個人或機密資訊。請確保使用者了解其內容何時會被傳送至 AI 模型，並遵循你組織的隱私與資料處理要求。
在依賴 AI 產生的結果做出重要決策之前，務必先進行審查。更多資訊請參閱 Atoms Terms of Service。
如果你的 app 需要來自外部供應商的私人憑證，請使用 Keys and secrets 進行儲存。切勿將憑證貼到 Chat 中，也不要將其包含在瀏覽器中執行的程式碼裡。