关于 Openlayer
Openlayer Skills 为编码 Agent 提供将应用接入 Openlayer 的指导,适用于 AI 评估与可观测性工作。它涵盖追踪、评估、测试、护栏、CI/CD 门禁及通过 Openlayer MCP 服务调试。
主要功能
- 01配置追踪与监控
- 02设置离线评估
- 03创建测试与护栏
- 04依据评估结果设置 CI/CD 门禁
- 05通过 MCP 调试失败测试
- 06查询项目与评估数据
适用场景
- 01为 LLM 应用添加追踪
- 02配置离线评估文件
- 03依据评估结果阻止 CI/CD
- 04排查 Openlayer 中的失败测试
MCP 相关
它将 Agent 连接到托管的 Openlayer MCP 服务。Agent 可读取工作区项目、追踪、测试、结果和治理规则,也可创建或更新这些内容;写入和删除操作需要确认。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.openlayer.com/mcpclaude mcp add --transport http com-openlayer https://mcp.openlayer.com/mcp{"mcpServers":{"com-openlayer":{"type":"http","url":"https://mcp.openlayer.com/mcp"}}}在 Cursor 中打开{"servers":{"com-openlayer":{"type":"http","url":"https://mcp.openlayer.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-openlayer":{"type":"http","url":"https://mcp.openlayer.com/mcp"}}}{"mcpServers":{"com-openlayer":{"serverUrl":"https://mcp.openlayer.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
原文在翻译后有更新,译文可能不是最新。
Openlayer 技能
Agent Skills 可教会 AI 编码助手(Claude Code、Cursor、GitHub Copilot 等)如何将应用与 Openlayer 集成——这是一个 AI 评估与可观测性平台。
安装该技能后,编码 Agent 能显著提升工作效果,因为它们会遵循 Openlayer 当前的最佳实践,而不是凭记忆猜测(例如过时的 SDK 调用、错误的环境变量或臆造的测试配置)。
技能
| 技能 | 描述 |
|---|---|
| openlayer | 主技能。为代码添加追踪(监控),设置离线 openlayer.json + tests.json 评估(开发),创建测试/防护栏,设置 CI/CD 门禁,运行 MCP 修复循环,并访问数据和文档。 |
安装
Claude Code 插件
claude plugin marketplace add openlayer-ai/openlayer-skills
claude plugin install openlayer@openlayer
Cursor 插件
/add-plugin openlayer
GitHub Copilot
GitHub Copilot 会读取 .github/plugin/plugin.json、与 Claude Code 相同的技能,以及 .mcp.json。
在 VS Code 中,将市场添加到 settings.json,然后从扩展视图安装 Openlayer(搜索 @agentPlugins):
{
"chat.plugins.marketplaces": ["openlayer-ai/openlayer-skills"]
}
在 Copilot CLI 中:
copilot plugin marketplace add openlayer-ai/openlayer-skills
copilot plugin install openlayer@openlayer
其他 Agent
Codex、Gemini CLI、Windsurf、opencode 等数十种工具可通过 skills CLI 安装:
npx skills add openlayer-ai/openlayer-skills --skill "openlayer"
关于 claude.ai、Copilot 的云端编码 Agent 和代码审查、手动符号链接或其他内容,请参阅安装指南——这是权威信息来源,并会随着这些工具的变化持续更新。
前提条件
一个 Openlayer 账户和一个 API 密钥:
export OPENLAYER_API_KEY=...
# self-hosted / local only:
export OPENLAYER_BASE_URL=https://api.openlayer.com/v1
在 Openlayer 应用中,前往 工作区设置 → API 密钥查找 API 密钥(参见 https://docs.openlayer.com/workspace-and-projects/find-your-api-key)。
用法
安装后,Agent 会在相关情况下自动使用该技能,例如:
- 为 LLM 或 Agent 应用添加 Openlayer 追踪/监控
- 设置离线评估(
openlayer.json+tests.json)并推送提交 - 从目录创建测试并配置防护栏
- 根据评估结果设置 CI/CD 门禁
- 通过 Openlayer MCP 修复循环调试失败的测试
- 查询项目、流水线、测试结果,或查找 Openlayer 文档
MCP 服务
该插件还会将你的 Agent 连接到托管的 Openlayer MCP 服务,地址为 https://mcp.openlayer.com/mcp。首次使用工具时,你需要通过 OAuth 登录 Openlayer 并选择一个工作区。随后,Agent 可以读取该工作区中的项目、数据源、追踪记录、测试、结果和治理规则,并可按你的要求创建或更新这些内容。写入和删除工具会请求确认。
工具调用只会发送到 Openlayer 的 API,不会发送到其他任何地方。请参阅隐私政策。可自托管的部署应将服务指向自己的 URL,具体说明请参阅 MCP 文档。
反馈与需求
遇到未按预期运行的情况,或希望支持新的用例?请在 https://github.com/openlayer-ai/openlayer-skills/issues 提交问题,或发送邮件至 [email protected]。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。