首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Muse 连接器工作原理分析

Muse 连接器工作原理分析

原创
作者头像
DifficultWork
发布于 2026-11-06 10:29:10
发布于 2026-11-06 10:29:10
1400
举报
文章被收录于专栏:阶梯计划阶梯计划

0 前言

在介绍连接器之前需要介绍下 Sentinel 的管控入口:

  • 第一个入口:网络出口管控(eBPF cgroup 钩子) 当 Agent 真正发起网络连接时,connect4/connect6 才会触发。此时 Sentinel 检查的是目标地址、端口、方法、路径,以及发起进程的污点状态。这是“提案已经被批准、请求即将离开虚拟机”时的关卡。
  • 第二个入口:连接器动作提案(应用层通道) Agent 想创建连接器、想调用某个已保存的 skill 时,它向 Sentinel 提交的是一个动作提案,包含方法、范围、任务上下文等信息。这个提交不经过 connect(),因此不依赖 eBPF 网络钩子。Sentinel 收到提案后,依据用户策略做出允许、拒绝或升级给用户审批的决定。这个通道大致技术路径应该是:Unix 域套接字 + SO_PEERCRED 内核级对端身份认证: 运行时单元(容器内)与宿主域服务之间的所有通信都走 Unix 域套接字,并使用 SO_PEERCRED 和对端 ACL 进行鉴权。SO_PEERCRED 是 Linux 内核提供的一种机制,允许接收方在 accept() 或 getsockopt() 时获取连接发起进程的 PID、UID 和 GID,由内核保证身份的真实性,不依赖应用层声明的身份。

1 连接器介绍

1.1 实现机制

Muse 连接器的本质,是让运行在云端 Linux 虚拟机里的 AI 智能体,能够安全地调用外部服务。它的实现有几个关键特征:

  • 1 存在于nspawn容器内 连接器是存在于 nspawn 内部,简单可以理解为一个 C/S 模式的客户端工具包。
  • 2 基于标准协议与 API 的调用 连接器主要依赖两种技术路径: MCP(Model Context Protocol):对于支持 MCP 的服务,Muse 作为客户端连接远程服务器(通常是 HTTP 传输)。 REST API / OpenAPI:对于传统服务,可以由用户自定义提供或者更激进一些由 Agent 通过理解 API 文档进行生成。
  • 3 连接器即“Skill”,具备持久性 一旦某个连接器被创建并测试通过,它就会被保存为 Skill。

1.2 安全与凭证隔离

连接器要访问用户的 邮箱、日历、支付账户,安全是核心。设计遵循“最小权限”和“机密分离”原则,具体实现如下:

  • 1 凭证从不进入 nspawn 容器 当连接器需要 API Key 或 OAuth 令牌时,不会让用户把密钥贴在聊天框里。它会触发一个安全凭证录入流程。用户输入的密钥进入虚拟机内的凭证守护进程(Authd),而 Agent 本身只能拿到一个代理令牌(Surrogate Token)。真正的密钥在请求离开虚拟机、到达网络边界时,由网络代理的组件注入并替换。
  • 2 网络出口管控 为避免智能体同时具备“访问私有数据 + 接触不可信内容 + 对外通信”这三项能力,连接器作为对外通信的通道,受到严格管控: 出站限制:连接器默认只允许出站连接,降低被劫持风险。 连接器审批策略:用户可以在设置中对每个连接器设定权限(只读、每次操作需批准、或完全允许)。对于搜索类只读服务可以放开,但对于会发送、发布或花钱的连接器(如邮件、支付),默认保持审批开启。

2 端到端具象化流程

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 0 前言
  • 1 连接器介绍
    • 1.1 实现机制
    • 1.2 安全与凭证隔离
  • 2 端到端具象化流程
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档