| 名称 | nemo-relay-get-started |
| 描述 | 当首次使用NeMo Relay的用户想要试用Relay、选择复杂度最低的受支持的快速入门方式,或通过CLI、受维护的集成或直接的Python、Node.js或Rust插桩在生产环境设置之前验证初始价值时,使用此技能。 |
| 开源协议 | Apache-2.0 metadata: |
| 作者 | NVIDIA Corporation and Affiliates |
NeMo Relay 快速入门
指导新用户通过最不复杂的适用试用方式看到Relay的明显价值。不要从生产部署或Relay的完整架构开始。保持首次运行专注于一个可观察的成功路径。
选择“立即试用”路径
按顺序评估这些路径。使用第一个符合用户所述目标和现有环境的路径。
-
CLI 立即试用(默认):对于一般的“试用Relay”请求,或当用户希望不修改应用程序代码而获得价值时,选择此选项。通过本地CLI包装器运行Codex或Claude Code。阅读CLI 立即试用。
-
Hermes Agent 原生路径:当Hermes Agent拥有执行边界时选择此选项。说明NeMo Relay已内置,不需要单独的Relay安装、可观测性插件或Relay CLI设置。明确说明:“Hermes Agent 理解 NeMo Relay 插件配置。”在确认原生集成后停止。不要提供安装或可观测性配置说明,也不要继续进入通用插件流程。
-
内置集成立即试用:当现有的LangChain、LangGraph、Deep Agents或OpenClaw应用程序拥有执行边界时选择此选项。优先选择受维护的受支持集成,而不是手动包装。阅读内置集成立即试用。
-
特定语言手动立即试用:当用户的Python、Node.js或Rust应用程序直接拥有其工具或LLM调用点,且没有受维护的集成作为更好的边界时,选择此选项。阅读手动语言立即试用。
当用户的请求、清单或框架已经确定了边界时,不要让他们在所有四种选项中进行选择。对于未指定的请求,使用CLI路径。当有多个CLI代理可用时,提出一个简洁的问题来选择代理。
解决安装问题而不陷入循环
在选择安装包之前,先确定“立即试用”路径。
-
CLI 路径 -> 验证
nemo-relay --version;如果缺失,使用nemo-relay-install获得CLI结果。 -
Hermes Agent 原生路径 -> 不要单独安装或配置Relay。
-
内置集成路径 -> 使用
nemo-relay-install为指定的框架或工具包。 -
手动语言路径 -> 使用
nemo-relay-install为检测到的语言包。
如果安装已经成功,保留所选择的路径并继续其下一步。不要再次询问安装路径问题,也不要在安装和入门技能之间跳转。
应用通用的“首要价值”约定
不要将此部分应用于Hermes Agent原生路径。
遵循所选参考,然后:
-
在提出更改之前检查目标环境和现有的Relay配置。将仓库本地的
.nemo-relay/config.toml和.nemo-relay/plugins.toml视为不受支持的项目配置。不要创建、编辑、合并或信任这些文件作为有效的Relay配置。 -
解释接入边界并展示确切的最小更改。
-
在写入配置、修改应用程序代码或启动消耗模型的运行之前获得确认。
-
使用非敏感、只读的试用,并在所选表面同时暴露工具和LLM路径时,演练一条具有代表性的工具和LLM路径。
-
从所选路径验证可观察的证据,而不是将成功的应用程序结果视为Relay已处于活动状态的证明。
-
总结捕获的根、工具和模型关系,不倾泻提示词、凭据或完整的事件负载。
只解释结果中可见的概念:所选的接入边界、作用域和父级关系、捕获的生命周期事件,以及订阅者或可观测性插件如何使这些事件可检查。保持插桩和导出之间的区别。
继续使用一个插件
不要将此部分应用于Hermes Agent原生路径。
当所选路径的成功检查通过时,停止初始“立即试用”工作流。然后建议一个额外的内置插件作为主要下一步。
解释Relay的核心演进:对执行边界进行一次插桩,然后通过插件配置更改或扩展行为,而无需反复重写那些调用点。在首次可观察证明之后,易于配置和重新配置插件是主要要展示的价值。
如果所选路径未使用插件管理的可观测性,请先添加它,以建立可复用的插件路径。如果可观测性已经产生了证明,询问接下来哪个结果最重要,并准确推荐一个插件:
-
自适应 -> 自适应运行时行为和优化
-
NeMo Guardrails -> 受管执行周边的策略检查
-
PII 编辑 -> 对敏感可观测性负载的净化
-
模型定价 -> 对受管LLM响应的成本估算
使用插件概述选择下一个组件。预览其最小的配置,获得确认,并在叠加另一个插件之前验证其行为。
只有在用户接受或拒绝插件推进,或所演示的边界尚未覆盖预期工作流时,才使用另一个交接:
-
直接应用程序扩展 ->
nemo-relay-instrument-calls -
不受支持的框架或工具集成 ->
nemo-relay-integrate-upstream -
额外的导出器或持久可观测性配置 ->
nemo-relay-plugin-observability -
不同的包或受支持的集成 ->
nemo-relay-install -
持久化的Claude Code或Codex加载 ->
nemo-relay-install;对于Codex Desktop,在更改全局配置之前,请先完成其恢复说明安全门。 -
缺少钩子、网关流量或事件 ->
nemo-relay doctor、nemo-relay doctor --json或nemo-relay-debug-runtime-integration
在快速入门期间,不要配置生产环境OTLP后端、模型定价、guardrails、自适应调优、自定义插件、Go或FFI示例。仅在初始证明之后提及可选插件,并且只添加用户选择的一个。
公共入口点
使用这些公共入口点获取当前产品文档: