在您的 app 中使用 AI
使用 Atoms 雲 的 AI 區段來選擇 AI 模型、在您的 app 中使用它，並檢視 app 的 AI 使用情況。
使用 AI 區段中的 Atoms 雲 來選擇 AI 模型、在您的 app 中使用它，並檢視 app 的 AI 使用情況。
本頁說明使用者在您的 app 內會互動到的 AI 功能。Atoms 雲 提供模型庫與專案使用資訊，而 Chat 中的 Atoms Agent 會建置並更新這些功能。
了解 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 請求中。
清楚描述功能
附加模型後，請從使用者的角度告訴智能體您希望該功能如何運作。請包含以下細節：
要描述的內容 | 要告訴智能體的內容 |
|---|---|
目的 | 說明此功能應協助使用者完成什麼。 |
使用者流程 | 描述使用者會輸入、上傳或選取什麼，以及他們應該在哪裡看到結果。 |
使用的資訊 | 明確指出 AI 應使用哪些資訊，以及絕對不可包含哪些內容。 |
預期結果 | 描述偏好的格式、語氣、語言、長度，以及任何重要限制。 |
載入與錯誤 | 說明使用者在等待期間、資訊缺失或無效時，以及請求失敗時應看到什麼。 |
您不需要說明此功能應如何編碼。請專注於使用者會做什麼、他們應收到什麼結果，以及 app 在每個階段應如何回應。
產生的版面配置可能因專案而異。請檢查您所要求的行為，而不要預期每個 app 都使用相同的設計。
所選的 AI 模型會以標籤形式出現在 Chat 編輯器中。
在 App 預覽 中測試功能
智能體完成後，請在 App 預覽 中測試完整的使用者流程。請使用不含個人或敏感資訊的無害範例內容。
測試項目 | 要做什麼 | 預期結果 |
|---|---|---|
一般輸入 | 提交此功能設計要處理的典型範例。 | 所要求的輸出會出現在正確的位置與格式中。 |
空白輸入 | 嘗試在未提供必要內容的情況下繼續。 | app 會說明使用者需要提供什麼，且不會送出不必要的請求。 |
無效輸入 | 提供不支援格式的內容，或不符合此功能預期要求的內容。 | app 仍可正常使用，並清楚說明問題所在。 |
載入狀態 | 提交請求，並觀察 app 在處理期間的狀態。 | app 會顯示請求正在進行中，並防止意外重複提交。 |
回應失敗 | 如果在一般測試期間請求失敗，請檢查 app 的回應方式。 | app 會顯示有用的訊息、允許使用者重試，且不會暴露技術細節或私人資訊。 |
請勿刻意使用敏感資料、耗盡所有可用積分，或干擾服務來製造錯誤。如果您無法安全地重現緩慢或失敗的回應，請改為告訴智能體 app 應如何處理該情況。
在 Atoms 雲 中檢視 AI 使用情況
- 返回 Atoms 雲 → AI。
- 開啟 AI Usage。
- 在 Overview 下，檢視此專案的 Total Credits Used 與 Active Models。
- 檢視列在 Active Models 下的模型。
AI Usage 顯示的是專案層級總覽。若要查看錢包餘額、儲值，以及更廣泛的 Cloud 或 AI 使用詳情，請參閱 Cloud & AI Wallet。
若要檢視特定 智能體 回應所使用的積分，請選取該回應下方的 ...，然後查看 Credits used。此訊息層級的數值與 AI Usage 中的專案總覽是分開的。
開啟訊息選單以檢視該智能體回應所使用的積分。
要新增的截圖：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 中，也不要將其包含在瀏覽器中執行的程式碼裡。