技术参考

Oz CLI、API 和 SDK 的技术参考文档。使用这些程序化接口，无需 Warp 桌面应用即可在 CI 流水线、脚本、后端服务和自定义工具中运行和管理代理。

CLI

[Oz CLI](/reference/cli/) 让您可以在任何环境中运行和配置代理——无论是本地、CI 流水线还是远程机器。

• API 密钥 - 创建并管理 API 密钥，以便在无需人工交互的情况下对 Oz CLI 进行身份验证，非常适合 CI 流水线、无头服务器和容器。
• 代理配置文件 - 使用代理配置文件来控制代理可以访问的内容、其行为方式以及它可以在何处执行操作，包括文件访问、命令执行和 MCP 服务器使用。
• MCP 服务器 - 通过 --mcp 标志（使用 UUID、内联 JSON 或文件路径）将 MCP 服务器配置传递给代理运行。
• 技能 - 使用 --skill 标志，通过存储在存储库中的可重用指令集来运行代理。
• Warp Drive 上下文 - 在 CLI 代理命令中直接引用存储在 Warp Drive 中的提示词、笔记本、工作流和规则。
• 集成设置 - 配置环境并连接 Slack 和 Linear 等外部工具，以便在终端之外触发代理。
• 故障排除 - 查找常见 CLI 错误的解决方案，包括身份验证问题、代理失败、环境问题和 Docker 镜像问题。

API 与 SDK

[Oz API](/reference/api-and-sdk/) 让您可以通过 HTTP 创建和监控云端代理运行。官方的 Python 和 TypeScript SDK 提供了带有内置重试和错误处理功能的类型化客户端。

• 演示：使用 SDK 进行 Sentry 监控 - 集成示例