Fabric AI Framework — 平台架构、计费与治理

Feature 全景 · Platform Feature Map (F1–F18)

Fabric AI Framework 的 specs/features/ 目录定义了 18 个 Feature 领域，覆盖从前端集成到后端治理的完整平台能力。以下是全景索引。

📄 specs/features/*.md

Copilot Item 与 Session · Copilot Item & Session Model

Copilot Item 是 Fabric AI Framework 中的核心 artifact，承担三个角色。

📄 specs/building-blocks/copilot-item.md · specs/features/09-copilot-item.md · engineering/010-architecture/010-!!-architecture.md

2.1 Copilot Item 的三重角色

2.2 Copilot Item 配置维度

2.3 Session 设计原则

• Session 与 Copilot Item 的关系：1 Copilot Item → N Sessions。Session 归属于创建时的 Copilot Item，不可迁移。
• Session 与 User 的关系：Session 绑定创建者 identity。其他用户无法访问（除非 admin 显式配置共享）。
• Session 状态隔离：每个 Session 有独立的 conversation history、tool state、agent context，互不干扰。

2.4 Session 生命周期状态机

服务架构与职责分工 · Service Architecture & Responsibilities

Fabric Copilot 的服务架构分为四层，每层有明确的职责边界。

📄 engineering/010-architecture/010-!!-architecture.md · engineering/010-architecture/011-sessions-responsibilities.md

3.1 四层架构

3.2 职责划分

3.3 通信路径与认证

Skills & Plugin 模型 · Skills & Plugin Architecture

Fabric AI Framework 采用 单一 Plugin 模型（Single Plugin Model），所有 skill 通过统一注册和路由机制加载到 agent。

📄 specs/building-blocks/plugin.md · specs/building-blocks/plugin-contribution.md · engineering/060-agent/066-skills-loading.md

4.1 单一 Plugin 模型（D-8）

这意味着：

• 所有 workload 贡献的 skills 被合并到单一 Plugin 中
• Agent 看到的是一个扁平的 tool 列表，不感知 skill 来源
• Skill 的启用/禁用通过 Copilot Item 配置控制

4.2 Context-Aware Skill 路由

4.3 SKILL.md 格式

每个 skill 通过 SKILL.md 文件定义，使用 YAML frontmatter + Markdown body：

---
name: fabric-sql-query
description: Execute SQL queries against Fabric SQL endpoints
version: 1.2.0
workload: data-warehouse
requires:
  - mcp-server: fabric-sql-endpoint
permissions:
  - read:warehouse
  - execute:query
---

# Fabric SQL Query Skill

You can execute SQL queries against any Fabric SQL endpoint
in the current workspace.

## Usage
- User asks to query data → use `execute_sql` tool
- Always validate query before execution
- Return results in markdown table format

4.4 Skills vs MCP Tools vs Agent Tools

Agent 运行时 & 工具 · Agent Runtime & Tools

Agent 运行在 ADC（Azure Data Container）sandbox 中，基于 GitHub Copilot SDK 构建。

📄 engineering/060-agent/063-agent-tools.md · engineering/060-agent/065-agent-design.md · specs/features/15-agent-execution-environment.md

5.1 默认工具清单（16 Tools）

5.2 执行环境详情

Runtime

ADC (Azure Data Container) — 隔离 sandbox 环境

SDK

GitHub Copilot SDK — conversation loop, tool invocation, streaming

Filesystem

FUSE-based Virtual Fabric Filesystem — 动态挂载 workspace 资源

Image

Versioned container image — 支持 rollback（tag-based versioning）

Networking

Egress-only via proxy — 无入站连接，所有外部调用通过 egress proxy

Lifecycle

Session-bound — container 随 session 创建分配，idle 后 suspend/释放

5.3 Virtual Fabric Filesystem (FUSE)

Container 内部通过 FUSE 挂载一个虚拟文件系统，将 Fabric 资源映射为文件路径：

/fabric/
├── workspace/
│   ├── artifacts/          # Workspace 中的 artifacts 列表
│   │   ├── notebook-1.ipynb
│   │   ├── report-1.pbix
│   │   └── ...
│   ├── skills/             # 已注册的 skills（SKILL.md 文件）
│   │   ├── sql-query/SKILL.md
│   │   ├── spark-execute/SKILL.md
│   │   └── ...
│   └── config/             # Copilot Item 配置
│       ├── models.json
│       └── governance.json
├── session/
│   ├── history/            # 当前 session 的对话历史
│   └── state/              # Session state（tool state, checkpoints）
└── user/
    └── profile.json        # 用户 profile 信息

Billing 计费架构 · Billing & Metering

Fabric AI Framework 的计费体系涵盖三类资源的成本归属和计量。以下内容基于 fabric-ai-framework 仓库中的 spec 文档。

📄 specs/building-blocks/billing.md · specs/features/16-billing-platform.md · engineering/900-fundamentals/904-fundamentals-billing.md

6.1 计费核心原则

6.2 三类计费资源 (Billable Resource Categories)

另外，Session Storage（会话历史存储）也产生计费，按 GB 计量，会话删除后停止计费。

6.3 模型获取策略 vs 计费路径

6.4 容量要求 & 准入控制

• 最低容量：Session 创建需要 workspace 所在 capacity 为 F0 (PAYG) 或 F64+
• 无 Capacity 时拦截：若 Copilot item 未分配 Fabric Capacity，session 创建被 HTTP 402 拒绝，并显示错误信息 + capacity 设置链接
• Copilot Capacity 是 tenant 级别的，跨 capacities 共享，admin 通过 security groups 映射

6.5 计费事件上报 (Feature Spec User Stories)

6.6 避免双重收费 (No Double-Charging)

这是计费设计中的 核心约束：

• MCP tool 触发的 Fabric API 操作 按现有规则计费（如 DW 查询消耗 CU），不额外加收 AI 附加费
• 只有 最近的 emitting operation 应该收费 — parent/child 或跨 API 调用不能重复计量
• BYOG Copilot 和 BYOM 路径 仅计 compute + storage，不计 LLM token 费用

6.7 Itemless / Workspace-less 挑战

Unified Copilot 的一大计费挑战是 session 不绑定单一 item 或 workspace：

• OneLake 目前是 item-centric → 对 session 级存储有摩擦
• 解决方案：引入 virtual artifact / virtual workspace 概念，用于在没有传统 Fabric item 的情况下进行计量
• 跨 workspace 操作必须显式处理 cost attribution

6.8 待解决问题 (Open Questions)

6.9 约束与要求

6.10 已确认决策 (2026-04-20 Meeting)

Governance & 模型管理 · Governance & Model Management

Fabric AI Framework 的治理体系覆盖从 tenant 到 workspace 的三层控制，以及模型获取的三条路径。

📄 specs/building-blocks/governance.md · specs/building-blocks/models.md · specs/features/17-copilot-governance.md

7.1 三层治理层级

7.2 治理域 (6 Domains)

7.3 模型获取策略 (3 Paths)

生态集成 & 边界 · Ecosystem Integration & Boundaries

Fabric AI Framework 定义了清晰的 Builder / Consumer 角色边界，以及与 GitHub Copilot 生态的集成关系。

📄 specs/building-blocks/ecosystem-integration.md · engineering/300-frontend/300-!!-frontend-dev-design.md

8.1 Builder vs Consumer 角色

8.2 与 GitHub Copilot 的边界 (D-7)

8.3 前端 CopilotHostService 架构

Fabric Portal 前端通过 CopilotHostService 为 workload 提供编程式 Copilot 集成：

通过 CopilotHostService，workload 前端可以：

• 打开/关闭 Copilot 面板，并传入特定上下文
• 发送预填充消息（如 "Diagnose this error" + error context）
• 监听 session 事件（创建、结束、approval 请求）
• 注入 artifact context（当前打开的 notebook/report/pipeline 信息）