agent-plugins

<p align="center"> <img src="assets/banner-build-with-ai.png" alt="A banner representing building with Ping using AI."> </p> # Ping Identity 插件（技能、MCP 等） [](LICENSE) Ping Identity 插件为 AI 编码代理提供 Ping Identity 平台的深入了解，通过一组专门设计的技能：使用哪个产品，如何配置它，以及如何将其集成到您的应用程序中。停止 Ping 上下文的提示工程，让技能帮助您。 > [!NOTE] > 插件正在定期更新。请回来查看更新！ **[功能](#功能) | [安装](#安装) | [手动安装](#手动安装) | [MCP 服务器](#mcp-服务器) | [技能](#六项核心技能) | [示例提示](#示例提示) | [工作原理](#工作原理) | [贡献](#贡献) | [反馈](#反馈) | [相关资源](#相关资源) | [许可证](#许可证)** --- ## 功能 - **Ping Identity 平台专业知识** - 技能为 AI 代理提供正确的上下文，以便他们可以回答问题、生成配置和编写集成，而无需猜测。 - **与所有主要 AI 编码代理兼容** - Claude Code、Cursor、GitHub Copilot、Gemini CLI 等。 - **MCP 服务器集成** - 在 Claude Code 或 Cursor 中安装插件会自动注册 AIC 和 DaVinci MCP 服务器，以便实时访问租户。 - **6 项核心技能** - 提供 Ping Identity 平台的配置、身份验证编排、共享服务（风险、KYC、MFA、治理）、应用程序集成和 AI 代理安全等方面的帮助。 - **渐进式上下文加载** - 技能仅加载代理完成任务所需的上下文，从而保持令牌使用率低和响应聚焦。 - **可组合设计** - 技能协同工作。一个完整的解决方案通常涉及 2-3 个技能，而 `ping-quickstart` 会自动引导您找到正确的组合。 --- ## 安装 | 代理 | 命令 | |---|---| | **Claude Code** | `/plugin marketplace add https://github.com/pingidentity/agent-plugins` | | **Cursor** | 设置 → 插件 → 搜索并添加 `https://github.com/pingidentity/agent-plugins` | | **GitHub Copilot** | 克隆此仓库，然后将相关的 `SKILL.md` 文件添加到项目中的 `.github/copilot-instructions.md` | | **Gemini CLI** | 添加到 `GEMINI.md`：`plugins: [https://github.com/pingidentity/agent-plugins]` | | **OpenCode / 其他** | `npx skills add pingidentity/agent-plugins`（通过 Skills CLI）；参见 [skills.sh](https://skills.sh) 以获取特定于代理的设置 | --- ## 手动安装 您也可以使用 Skills CLI 安装： ```bash npx skills add pingidentity/agent-plugins ``` 或安装特定技能： ```bash npx skills add pingidentity/agent-plugins/plugins/ping-identity/skills/ping-quickstart npx skills add pingidentity/agent-plugins/plugins/ping-identity/skills/ping-foundation npx skills add pingidentity/agent-plugins/plugins/ping-identity/skills/ping-orchestration npx skills add pingidentity/agent-plugins/plugins/ping-identity/skills/ping-universal-services npx skills add pingidentity/agent-plugins/plugins/ping-identity/skills/ping-app-integration npx skills add pingidentity/agent-plugins/plugins/ping-identity/skills/ping-identity-for-ai ``` > [!TIP] > 技能协同工作。建议安装整个插件以获得最大收益。 --- ## MCP 服务器 当您在 **Claude Code** 或 **Cursor** 中安装插件时，会自动注册两个本地托管的 MCP 服务器： | MCP 服务器 | 用途 | |---|---| | [**AIC MCP 服务器**](https://github.com/pingidentity/aic-mcp-server) | 访问 PingOne Advanced Identity Cloud（AIC），用于旅程创作、租户管理、脚本节点开发等。仅在开发和沙箱环境中可用。 | | [**DaVinci MCP 服务器**](https://github.com/pingidentity/davinci-mcp-server) | 访问 PingOne DaVinci，提供流管理、应用程序配置等的只读访问权限。 | 这些 MCP 服务器有必须设置的变量，以便连接到您的 AIC 或 PingOne 环境。Claude 或 Cursor 将提示您输入这些变量。 要直接添加 MCP 服务器而无需完整插件，请访问 [使用 AI 构建](https://www.pingidentity.com.cn/resources/developer/build-with-ai.html) 网站。 --- ## 六项核心技能 | 技能 | 功能 | 使用场景 | |---|---|---| | `ping-quickstart` | Ping Identity 工作的入口。确定您所在的平台、要完成的任务，并引导您到正确的技能 | 平台未知；“我该从哪里开始”；评估或比较 Ping 产品；不确定哪个产品处理您的用例 | | `ping-foundation` | PingOne、AIC、PingFederate、PingAccess、PingDirectory 和 PingID 的平台设置、管理和核心配置。涵盖环境、应用程序注册、SSO、目录、策略和品牌 | 设置或管理任何 Ping 平台；注册应用程序；配置登录策略、目录或自定义域 | | `ping-orchestration` | 设计和构建身份验证流程、旅程和编排逻辑，涵盖 DaVinci、AIC/PingAM 和 PingFederate。涵盖登录、注册、MFA、无密码、逐步身份验证、渐进式配置文件、社会登录和 CIBA | 设计或构建任何身份验证或注册流程；询问“需要哪些节点”；排查旅程或 DaVinci 流程问题 | | `ping-universal-services` | 配置和调用 Ping 的共享服务：PingOne Protect（风险）、PingOne Verify（KYC/身份验证）、PingOne MFA、PingOne Credentials（可验证凭证）、PingOne IGA（治理）和 PingOne Authorize（细粒度授权） | 在流程或应用程序中添加风险评分、身份验证、MFA 服务、可验证凭证、访问治理或细粒度授权 | | `ping-app-integration` | 将 Ping 集成到 Web、移动和服务器端应用程序中。涵盖 Android、iOS、React、JavaScript SDK；OIDC/OAuth2 连接；后端令牌验证；本地代理集成；SDK 故障排除 | 编写代码将应用程序连接到 Ping；在 UI 中嵌入 DaVinci 流程或 AIC 旅程；排查重定向、 CORS 或令牌错误 | | `ping-identity-for-ai` | 使用 Ping 保护 AI 代理和 LLM 驱动的应用程序。涵盖代理身份注册、机器对机器身份验证、Verified Trust 信号、PingGateway 作为 MCP 网关、CIBA 人机审批和机器人/代理检测 | 为 AI 代理提供验证身份；保护 MCP 服务器；为帮助台 AI 委托令牌；应用 Identity for AI 5 柱架构 | 技能是可组合的。完整的解决方案通常涉及 2-3 个技能。`ping-quickstart` 告诉您需要加载哪些组合。 --- ## 示例提示 | # | 提示 | 技能 | |---|---|---| | 1 | “我是 Ping Identity 的新手，需要在我的应用程序中添加登录功能。我该从哪里开始？” | ping-quickstart | | 2 | “PingOne 和 PingOne Advanced Identity Cloud 有什么区别？我应该使用哪一个？” | ping-quickstart | | 3 | “帮助我在 PingOne 环境中注册一个 OIDC 应用程序。” | ping-foundation | | 4 | “如何在我的登录流程中添加基于风险的逐步 MFA 挑战？” | ping-universal-services | | 5 | “我需要在我的 React 应用程序中将 Ping JavaScript SDK 集成到 DaVinci 流程中。” | ping-app-integration | | 6 | “帮助我使用 FIDO2/通行密钥在 AIC 中构建无密码登录旅程。” | ping-orchestration | | 7 | “构建渐进式配置文件流程时需要哪些节点来收集登录后的电话号码？” | ping-orchestration | | 8 | “如何从 PingOne Credentials 向用户颁发可验证凭证？” | ping-universal-services | | 9 | “为我的 AI 代理提供客户端凭证身份，以便它可以安全地调用我们的内部 API。” | ping-identity-for-ai | | 10 | “列出我的 AIC 租户中的所有旅程，并显示哪些旅程启用了 MFA。” | AIC MCP 服务器 | | 11 | “在我的 AIC 沙箱中创建一个新的登录旅程，收集用户名和密码，然后发送电子邮件 OTP。” | AIC MCP 服务器 | | 12 | “更新我的 AIC 租户中的品牌主题，使用我们公司的主要颜色和徽标。” | AIC MCP 服务器 | | 13 | “显示我的环境中的所有 DaVinci 流程以及使用它们的应用程序。” | DaVinci MCP 服务器 | | 14 | “列出我的 DaVinci 环境中配置的连接器及其当前连接状态。” | DaVinci MCP 服务器 | | 15 | “拉取我的 DaVinci 中的主要登录流程配置，以便我可以查看 MFA 步骤的设置。” | DaVinci MCP 服务器 | 提示 10-15 需要在 Claude Code 或 Cursor 中安装插件并配置 MCP 服务器。 --- ## 工作原理 每个技能都遵循三层渐进式披露模型： ``` 第 1 层 - 元数据（约 100 个令牌） 技能名称 + 描述 - 在发现时加载所有技能 第 2 层 - SKILL.md（<5k 令牌） 路由决策树：意图 -> 平台 -> 参考 在技能激活时完全加载 第 3 层 - 参考资料（按需） 包含代理执行指定任务所需的技术细节的文件。 ``` 代理在第一个回答问题的层停止运行。它永远不会一次性加载所有锚点。 --- ## 仓库布局 ``` plugins/ping-identity/ skills/ ping-quickstart/ SKILL.md + 参考资料 ping-foundation/ ping-orchestration/ ping-universal-services/ ping-app-integration/ ping-identity-for-ai/ plugin-map.md 技能索引和选择规则 references/index.json 所有策划的锚点路径 rules/ authoring-rules.md 前言合同、正文长度、命名 routing-rules.md 技能选择优先级 runtime-selection.md 沙盒与生产决策规则 shared/ taxonomies/ 平台家族、能力图、服务图 schemas/ 前言 JSON 架构 templates/ SKILL.md 和策划参考模板 evals/ prompts/ 触发器 / 非触发器 / 模糊提示集，每个技能 harness/ 层 1 + 层 2 运行器，Claude + OpenAI 适配器 results/ 已记录的评估运行输出 ``` --- ## 贡献 我们欢迎贡献！无论是新技能、现有技能的改进还是错误修复，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取完整的指南，包括技能结构要求、编写规则以及如何提交拉取请求。 ## 评估状态 > [!NOTE] > 我们的内部测试一致显示 **显着的令牌节省**，当加载 ping-identity 技能时，与基准相比，跨所有六个技能和多个模型层。加载技能为代理提供正确的上下文，因此它花费较少的回合来探索、自我纠正和对 Ping API 进行错误假设。 > > 完整的评估结果与每个技能和模型的具体明细将被审查并在此发布后公布。 --- ## 反馈 如果您有反馈、问题或希望请求新技能： - [打开问题](https://github.com/pingidentity/agent-plugins/issues/new) 并添加适当的标签（`enhancement`、`bug`、`question` 或 `skill-request`） - 使用拇指图标为现有问题投票，以帮助我们确定优先级 ## 相关资源 - [Ping 开发者门户](https://developer.pingidentity.com/) - [Ping 开发者博客](https://developer.pingidentity.com/blog/) - [Ping Identity 文档](https://docs.pingidentity.com/) - [使用 AI 构建](https://www.pingidentity.com.cn/resources/developer/build-with-ai.html) - [代理技能标准](https://agentskills.io/) - [技能 CLI](https://skills.sh) --- ## 免责声明 > **本代码由 Ping Identity Corporation（“Ping”）按“现状”提供，不作任何形式的保证。** > Ping Identity Corporation 不对该代码的任何使用、实施或配置产生的任何责任承担，包括但不限于任何商业目的的使用。 > 任何与代码使用相关的诉讼只能在 Ping Identity Corporation 所在的司法管辖区的法院提起，并且根据该司法管辖区的法律，不包括其冲突法条款。 ## 许可证 该软件根据 MIT 许可证的条款进行修改和分发。有关详细信息，请参见 [LICENSE](./LICENSE) 文件 &copy; 版权 2026 Ping Identity Corporation。保留所有权利。