用途:该技能定义 AI 智能体协助用户通过 Microsoft Fabric CLI(fab)操作 Fabric 时的安全一致默认规则,覆盖工作区、语义模型、报表、笔记本等资源管理。
主要能力:将 Fabric 视为类文件系统层级(Tenant、Workspace、Folder、Item、OneLakeItem),路径使用点号实体后缀,如 /Workspace1.Workspace/Notebook1.Notebook;支持交互模式(REPL,无需 fab 前缀)与命令行模式(适合脚本自动化),模式在会话间保留;提供认证指引(交互登录 fab auth login、服务主体、联合凭据、托管标识);支持隐藏实体发现(.capacities、.gateways、.connections、.domains 及工作区级 .managedidentities 等),用 ls -a / ls --all 显示;涵盖常见项类型(.Workspace、.SemanticModel、.Report、.Notebook、.Lakehouse、.Warehouse、.DataPipeline 等),可用 fab desc .<ItemType> 探索。
使用方式:首次运行先执行 fab auth status 验证认证,未认证则运行 fab auth login;首次使用某命令先用 fab --help 和 fab <command> --help 了解语法;从简单命令开始,再考虑管道或链式;自动化场景使用命令行模式,可用 -f 跳过确认;操作前用 fab ls 或 fab exists 验证工作区或项名称。技能附带 scripts/ 目录下的 Python 脚本,如 health_check.py 用于验证 CLI 安装、认证状态与连通性:python scripts/health_check.py [--workspace WS]。
适用场景:需要以安全、可复现方式通过 fab 管理 Fabric 资源的自动化与智能体辅助操作。
限制与安全:不得记录或输出令牌、密码、客户端密钥或原始联合令牌;不要求用户粘贴密钥;删除、覆盖或更改权限的命令需先征得确认;权限错误应停止并询问,不得绕过;支持平台为 Windows、Linux、macOS,shell 为 zsh、bash、PowerShell、cmd,Python 3.10–3.13;配置文件位于 ~/.config/fab/,调试日志路径因平台而异。具体命令语法与示例参见技能内附的快速入门、完整命令参考等文档。