使用 AI 部分和 Atoms 云 来选择 AI 模型，在你的应用中使用它，并查看应用的 AI 使用情况。

本页说明用户在你的应用内与之交互的 AI 功能。Atoms 云 提供模型库和项目使用信息，而 Atoms Agent 在 Chat 中构建并更新这些功能。

了解 Atoms 云中的 AI

在 Atoms 桌面版中打开项目，并确保其处于 Web 模式。AI Library 包含当前可用于该项目的模型，而 AI Usage 显示项目积分使用情况和活跃模型。

如果 Atoms 云 未连接或 AI 不可用，请让智能体连接 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 模型。该模型会作为标签显示在你的 Chat 消息中。然后你可以描述希望智能体构建或更改的内容。

你也可以直接从 Chat 附加模型：输入 #，选择 AI，然后从当前可用模型中选择一个。

选择 # Add 以将模型标签插入你的 Chat 请求中。

清晰描述功能

附加模型后，请从用户视角告诉智能体你希望该功能如何工作。请包含以下细节：

需要描述的内容	要告诉智能体的内容
目的	说明该功能应帮助用户完成什么。
用户流程	描述用户将输入、上传或选择什么，以及他们应在何处看到结果。
使用的信息	明确 AI 应使用哪些信息，以及绝不能包含哪些内容。
预期结果	描述偏好的格式、语气、语言、长度以及任何重要限制。
加载和错误	说明用户在等待时、信息缺失或无效时，以及请求失败时应看到什么。

你无需解释该功能应如何编码。请专注于用户做什么、他们应获得什么结果，以及应用在每个阶段应如何响应。

生成的布局在不同项目之间可能有所不同。请检查你所请求的行为，而不要期待每个应用都使用相同的设计。

所选 AI 模型会作为标签显示在 Chat 编辑器中。

在 App 预览 中测试该功能

智能体完成后，请在 App 预览 中测试完整的用户流程。使用不包含个人或敏感信息的无害示例内容。

测试项	要做什么	预期结果
正常输入	提交一个该功能设计用于处理的典型示例。	请求的输出会出现在正确的位置，并采用正确的格式。
空输入	在未提供所需内容的情况下尝试继续。	应用会说明用户需要提供什么，并且不会发送不必要的请求。
无效输入	提供不受支持格式的内容，或提供不符合该功能预期要求的内容。	应用仍可正常使用，并清楚说明问题所在。
加载状态	提交一个请求，并在处理过程中观察应用。	应用会显示请求正在进行中，并防止意外重复提交。
响应失败	如果请求在正常测试期间失败，请检查应用如何响应。	应用会显示有用的信息，允许用户重试，并且不会暴露技术细节或私人信息。

不要故意使用敏感数据、耗尽所有可用积分，或干扰服务来制造错误。如果你无法安全地复现缓慢或失败的响应，请改为告诉智能体应用应如何处理这种情况。

在 Atoms 云中查看 AI 使用情况

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 中的项目概览是分开的。

打开消息菜单以查看该智能体响应所使用的积分。

要添加的截图：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 中，也不要将其包含在浏览器中运行的代码里。