SuperAPI AI 工具集

guardrails-developer-guide

安全与审计

查看项目

更新于 10-16 02:33

技能介绍

用途:回答 NVIDIA NeMo Guardrails 库的产品使用问题,不重复整篇产品文档,而是把智能体引导到官方文档并总结与用户任务相关的指引。

文档来源规则:始终使用 https://docs.nvidia.com/nemo/guardrails/ 下的 Markdown 文档;为智能体加载上下文时使用 llms.txt 和以 .md 结尾的页面 URL;向用户展示引用时使用不带 .md 的规范可读链接。

检索顺序:客户端支持 MCP 时优先使用文档 MCP 服务器;否则先获取索引 https://docs.nvidia.com/nemo/guardrails/llms.txt,定位相关页面后以页面 URL 加 .md 获取干净 Markdown。若用户在克隆仓库中且远程文档不可用,回退到本地 docs/**/*.mdx。若已安装该包且存在版本化文档,则对齐已安装的 nemoguardrails 版本;无法确定版本时询问是否使用最新文档。不要硬编码 staging,生产文档为规范来源,仅在用户明确要求检查 staging 或验证迁移行为时使用 staging URL。

意图路由:安装或验证环境对应 Get Started → Installation;添加有害内容、越狱、主题、PII、自检、事实核查或智能体安全护栏对应 Configure Guardrails → Guardrail Catalog;配置 config.yml、模型、提示、追踪、流式或异常对应 YAML schema 与配置参考;编写或调试 Colang 流程对应 Colang;使用 Python API 对应 Run Guardrailed Inference → Python API;运行 Guardrails API 服务器或 actions 服务器对应 Guardrails API Server;与 LangChain、LangGraph、RunnableRails 或工具集成对应 Integration with Third-Party Libraries;评估护栏或漏洞扫描对应 Evaluation;追踪、指标或日志对应 Observability;Docker 或 NeMo 微服务部署对应 More Deployment Options;排错对应 Troubleshooting;遥测与隐私对应 Resources → Telemetry and Privacy。

安全与凭据:绝不要求用户把真实 API 密钥、令牌、密码或提供商凭据粘贴到聊天中;示例使用 <NVIDIA_API_KEY>、<OPENAI_API_KEY>、<YOUR_ENDPOINT> 等占位符;说明应在本地 shell 环境变量、密钥管理器、本地配置或提供商控制台设置密钥;不在生成的命令或摘要中打印、存储或回显密钥。

回复风格:先给出用户当前任务与相关文档来源,优先最小可用路径,仅在相关时补充生产加固、可选扩展或替代集成;示例使用真实提供商时提醒贡献者测试必须 mock LLM 与提供商调用。相关技能:创建或修改护栏配置时使用 guardrails-developer-create-guardrails;编辑本仓库时遵循 AGENTS.md 及适用的子树 AGENTS.md。