Atoms 在你的应用中使用 AI
使用 Atoms 云中的 AI 部分来选择 AI 模型，在你的应用中使用它，并查看应用的 AI 使用情况。
本页说明用户在你的应用内与之交互的 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 查找合适的模型。
该库会随时间变化。请使用其中显示的模型和信息，而不要依赖较旧的模型或提供商列表。
将模型添加到你的请求中
选择 # Add 是为了告诉智能体你想使用哪个 AI 模型。该模型会作为标签显示在你的 Chat 消息中。然后你可以描述希望智能体构建或更改的内容。
你也可以直接从 Chat 附加模型：输入 <strong>#</strong>，选择 AI，然后从当前可用模型中选择一个。
选择 # Add 将模型标签插入你的 Chat 请求中。
清楚描述该功能
附加模型后，从用户视角告诉智能体你希望该功能如何工作。请包含以下细节：
| 要描述的内容 | 要告诉智能体的内容 |
|---|---|
| 目的 | 说明该功能应帮助用户完成什么。 |
| 用户流程 | 描述用户将输入、上传或选择什么，以及他们应在何处看到结果。 |
| 使用的信息 | 明确 AI 应使用哪些信息，以及绝不能包含哪些内容。 |
| 预期结果 | 描述期望的格式、语气、语言、长度以及任何重要限制。 |
| 加载和错误 | 说明用户在等待时、信息缺失或无效时，以及请求失败时应看到什么。 |
你不需要解释该功能应如何编码。重点说明用户做什么、他们应收到什么结果，以及应用在每个阶段应如何响应。
生成的布局在不同项目之间可能不同。请检查你所请求的行为，而不要预期每个应用都使用相同的设计。
所选 AI 模型会作为标签显示在 Chat 输入框中。
在 App 预览 中测试该功能
智能体完成后，在 App 预览 中测试完整的用户流程。请使用无害的示例内容，不要包含个人信息或敏感信息。
| 测试 | 操作方式 | 预期结果 |
|---|---|---|
| 正常输入 | 提交该功能设计要处理的典型示例。 | 所请求的输出会以正确的位置和格式显示。 |
| 空输入 | 在未提供所需内容的情况下尝试继续。 | 应用会说明用户需要提供什么，并且不会发送不必要的请求。 |
| 无效输入 | 提供不受支持格式的内容，或提供超出该功能预期要求的内容。 | 应用保持可用，并清楚说明问题所在。 |
| 加载状态 | 提交请求并在处理期间观察应用。 | 应用会显示请求正在进行中，并防止意外重复提交。 |
| 失败响应 | 如果请求在正常测试期间失败，请检查应用如何响应。 | 应用会显示有用的信息，允许用户重试，并且不会暴露技术细节或私人信息。 |
不要故意使用敏感数据、耗尽所有可用积分，或干扰服务来制造错误。如果你无法安全地复现缓慢或失败的响应，请改为告诉智能体应用应如何处理这种情况。
在 Atoms 云中查看 AI 使用情况
- 返回 Atoms 云 → AI。
- 打开 AI Usage。
- 在 Overview 下，查看该项目的 Total Credits Used 和 Active Models。
- 查看 Active Models 下列出的模型。
AI Usage 显示项目级概览。有关钱包余额、充值以及更广泛的 Cloud 或 AI 使用详情，请参阅 Cloud \& AI Wallet。
要查看特定 智能体 响应所使用的积分，请选择该响应下方的 <strong>...</strong>，然后查看 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。
如果你的应用需要来自外部提供商的私密凭证，请使用 密钥 and secrets 进行存储。切勿将该凭证粘贴到 Chat 中，也不要将其包含在浏览器中运行的代码里。