用途:帮助按 NVIDIA NeMo Fabric 公开南向契约构建、迁移、审查与维护第三方适配器,适配器保持轻薄,仅负责目标转换与生命周期状态,规划与面向消费者行为交由 NeMo Fabric 处理。
主要能力与用法:先读当前适配器契约与已提交的 adapter-contract JSON Schema,勿从示例重建 schema。确定边界:adapter_id、选择 harness/shared framework/dedicated custom-agent 适配器、列出可强制字段、区分 harness.settings、workflow.settings 与类型化扩展。先写自包含 *.fabric-adapter.json:设 contract_version、adapter_id、adapter_kind、runner 绑定,仅声明实现可执行的 config.accepts,按需声明 config.system_instruction_modes、mcp.auth、settings_schema、model_schema、tool_definition_schema、extension_schemas,capabilities.streaming 仅在实现 invoke_openai_stream 原生 OpenAI 流式时置真。打包放在 share/nemo-fabric/adapters 与 targets 下,依赖 nemo-fabric-adapter-contract;TypeScript 同样从包根导入类型并校验边界数据。映射 AgentConfig:解析模型角色、指令、MCP、工具与技能,从 RuntimeContext 读身份与遥测,拒绝不支持值时用稳定错误码且不记录敏感信息。实现恰一个 start、零或多个有序 invoke、一个 stop;可选 async invoke_openai_stream(request, context, emit),支持续会话时保留运行时会话状态并有界保留历史,会话状态与每次调用状态分离。自定义智能体经 workflow.target_id 选择目标并用 spec.entrypoint 解析。移交前在隔离环境安装 wheel,验证发现、doctor、start/失败/清理/两运行时隔离,声明原生流式时测试空流与多块流等边界。限制:不得静默接受不支持字段;未声明能力不得声称支持;NeMo Fabric 自动化一致性测试须待官方套件发布并通过后方可声明。