遵循以下建议，以获得更可靠的 Cloud Agent 运行效果。
先完成环境设置¶
请使用云端代理设置，确保 Cursor 的环境已正确配置。和人类开发者一样，如果环境设置得当，Cursor 往往能表现得更好。
确保 Agent 能访问所需资源¶
在运行 Cloud Agent 之前，请确认已满足以下前提条件：
- Secrets：通过控制台中的 Secrets 选项卡，确保 Agent 能访问所需的机密信息 (API key、数据库凭证等) 。对于云端角色，优先使用 OIDC token，而非长期有效的访问密钥。
- 出口访问控制 (Egress controls) ：如果你启用了网络访问限制，确保本地开发所需的所有 URL 都已加入白名单。
- 本地可测试性：你的代码仓库应配置为能够在本地良好运行，且不依赖虚拟机 (VM) 无法访问的外部服务。如果对人类开发者来说本地难以测试，对 Agent 来说也会同样困难。
使用 skills 和 agents.md 来配置你的 agent¶
如果 cloud agent 在测试其更改时遇到困难，我们建议使用 skills 和 agents.md 来配置你的 agent。
可以把 agent 想象成一个聪明但上下文信息有限的人类开发者。要让它正确完成任务，最好的方式是提供足够的上下文，让它明白该做什么。
例如，在 Cursor，我们的 agents.md 会列出在 mono-repo 中运行和调试最常用微服务的技巧。我们还有很多关于如何测试和调试关键服务的 skills，并为每个 skill 提供了何时使用的清晰说明。
这些 skills 包含深入的细节，例如如何调试某个特定微服务，或者在测试需要时如何设置第三方依赖。
使用规则落实规范¶
Cloud Agents 可以在三个层级读取并遵循规则：
- 用户规则：在 Cursor 设置中设置，适用于你在所有仓库中的会话。最适合仅对你个人生效的规则。
- 团队规则：在规则、命令、钩子仪表盘中设置，适用于所有团队成员在所有仓库中的使用。最适合组织范围内的规范。
- 仓库规则：提交到仓库中的
.cursor/rules/*.mdc文件，适用于使用该仓库的所有智能体。最适合仓库/项目特定的规范。
为 Agent 提供所需的工具¶
我们经常发现，Agent 的能力会受限于其可用的工具。我们建议使用 MCP 并创建自定义工具，让 Agent 能访问与人类开发者相同的系统。
根据 agent 调整工具¶
为 agent 创建其擅长使用的工具非常重要。我们建议先创建工具，再根据观察 agent 实际使用情况进行迭代改进。
例如，在 Cursor，我们为模型创建了一个自定义命令行界面（CLI）工具，用于在我们的代码库中运行微服务。我们发现，当运行自定义开发命令（例如来自 package.json 文件的命令）时，一些模型经常会漏掉参数，或者 agent 会被嘈杂的构建日志分散注意力，而这些日志是人类开发者通常会忽略的。
