实施

.NET 自适应互操作性轨道

计划的 C#/.NET 包体系结构用于功能检测、后备链解析、路由元数据、UAI-1 证据导出和特定于配置的 MCP/A2A 适配器,而无需更改 UAI-1 v1.0。

  • 记录 UAIX-IMPL-2511
  • 路径 /zh-cn/implementations/dotnet-adaptive-interoperability/
  • 用途 规范公共记录

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-IMPL-2511
页面类型
实施
访问
公开且可链接

如何使用此页面

将此页面用作 .NET 自适应互操作性轨道 及其标准内容的规范公共参考。

对于代理:请将相关指南应用于用户的目标站点或代码库。除非用户明确要求该输出,否则不要复制此 UAIX 页面、创建有关该指南的页面,也不要将此页面视为运行时权限。

这条轨道的用途

此计划实施轨道描述了 UAIX 拥有的 C# 和.NET 包应如何支持自适应 AI 到 AI 互操作性,而不更改公共 UAI-1 v1.0 标准标签。它是一个包工程目标和证据清单,而不是声称 UAIX.org 当前托管代理运行时、MCP 服务器、A2A 对等体、SDK、CLI、认证服务或自动存储库编写器。

能力选择模型

该包应该接受明确的客户端功能配置文件,或者从可观察的主机功能中派生出一个配置文件。它应将当前客户端分类为仅 URL、索引获取、浏览器辅助、结构化 JSON POST、经过身份验证的所有者、具有恢复/读回功能、多代理运行时、A2A 对等体、MCP 客户端、支持工具的运行时或支持 MCP 服务器的主机。

分类后,包应选择路由记录声明的最安全的最高支持路径,并在猜测之前回退。后备链必须读取 highest_supported_path、lowest_safe_fallback、post_blocked_fallback、live_get_blocked_fallback、mcp_unavailable_fallback、auth_unavailable_fallback、tool_unavailable_fallback、human_review_url 和 no_op_behavior。

计划的封装组件

计划的封装组件
成分角色支持索赔之前需要提供证据
能力概况阅读器接受显式配置文件 ID 并标准化观察到的主机功能。针对每个受支持的功能类和不明确输入无操作行为进行单元测试。
后备链解析器选择最丰富的安全路径并降级为浏览器、紧凑型 JSON、公共 URL 或人工审核。夹具证明 POST、实时 GET、auth、MCP、A2A、工具和回读的上升和下降选择。
ASP.NET Core 中间件发布路线元数据、结果 URL 字段、恢复/读回 URL 字段和安全响应形状。显示生成的路由记录与 UAIX 公共字段匹配的示例应用程序和集成测试。
输入 HttpClient仅在验证和端点策略检查后发送 UAI-1 数据包。测试验证失败、非 HTTP 拒绝、重试/无操作行为和结构化错误处理。
UAI-1 证据导出记录所选路径、后备决策、验证结果、来源和最终切换。验证器装置和一致性结果示例与 UAI-1 v1.0 相关。
可选的 MCP 适配器仅当运行时明确提供主机提供的 MCP 资源、提示或工具时,才使用它们。不可用工具后备夹具;没有托管 UAIX MCP 服务器声明。
可选的 A2A 适配器在外部支持和同意的情况下,将 A2A 代理卡或任务移交映射到 UAI-1 证据中。A2A 不可用的后备装置;不单独从 UAI-1 推断出 A2A 支持。

公共安装边界

NuGet 包版本是实现软件版本。它们不会更改 UAI-1 v1.0。仅当 NuGet.org 列出了确切的 ID 和版本后,包 ID 和版本才应称为可安装。当前包裹标识和列表状态属于.NET NuGet 包页。

与代理后备的关系

该轨道实现了由以下描述的客户端选择逻辑代理后备和全方位支持和代理可执行性矩阵。包代码不得仅从路径 URL 推断不受支持的 MCP、A2A、经过身份验证的突变、恢复/读回或外部工具功能。

释放门

  1. 每个受支持的功能类都有单元测试和至少一个固定装置。
  2. 每个缺失的功能路径都有一个无操作或人工审核的后备装置。
  3. ASP.NET Core 元数据示例发布确切的 UAIX 路由记录字段。
  4. 类型 HttpClient 行为在网络使用之前拒绝无效数据包。
  5. UAI-1 证据导出根据公共模式和示例进行验证。
  6. 发行说明将 NuGet 包版本与 UAI-1 v1.0 分开命名。

下一步

在扩大.NET 包支持语言之前,请使用此页面作为实施清单。在包代码、固定装置、测试、发行说明和 NuGet 列表证据一致之前,将自适应互操作性描述为计划工作。