跳到主要内容

AI Agent 的账号、Provider 与插件边界

AI Agent 的账号、Provider 和插件解决的是不同问题。把它们分开理解，可以减少切换服务配置时的误操作，也能更准确地定位权限和网络问题。

三层关系​

  1. 账号（Account）：表示当前登录的身份、会话和权限。
  2. Provider：决定请求发送到哪个兼容接口、使用什么模型和认证配置。
  3. 插件（Plugin）：提供本地安装的能力定义、工具或工作流，不等同于账号，也不等同于 Provider。

账号负责“谁在使用”，Provider 负责“请求发往哪里”，插件负责“客户端能做什么”。三者可以相互依赖，但生命周期并不相同。

切换 Provider 时会发生什么​

切换 Provider 通常不要求退出账号。应先按照客户端支持的方式更新 Provider、端点、模型和认证配置，再验证插件所依赖的远程能力是否可访问。

  • 依赖 OAuth 登录、官方账号权限或托管能力的插件，切换后可能需要重新授权或暂时不可用。
  • 只调用兼容模型接口、只读本地文件的插件，通常可以继续使用，但仍受模型能力、工具协议和权限配置影响。
  • 插件仍然安装，不代表它依赖的远程能力仍然可用；应分别检查安装状态和运行时连接状态。

故障排查顺序​

遇到问题时，可以按以下顺序缩小范围：

  1. 确认插件是否仍然安装并被客户端加载。
  2. 确认 Provider 的端点、模型和认证配置是否有效。
  3. 确认账号或 OAuth 会话是否仍有必要权限。
  4. 查看脱敏后的日志，区分网络、权限、模型能力和工具协议错误。

不要为了切换 Provider 反复退出账号，也不要把完整请求日志直接复制到文档或提交记录中。

内容安全边界​

文档和文章只能使用抽象示例或占位值，不应出现真实的代码托管地址、访问令牌、API 密钥、Cookie、私钥、认证请求头或个人电脑的绝对路径。需要说明配置格式时，使用环境变量名、相对路径和不可用的示例值，并在发布前检查 front matter、正文、代码块和日志片段。