osFoundry / Platform
连接器配置
每条连接的权威来源——范围、密钥、OAuth 配置。
简介
连接器配置是 osFoundry Studio 中用于定义并存储工作区如何连接外部一切的部分，也就是你的智能体和应用所要访问的 API、工具与服务。每个连接器都把一个连接的完整信息保存在一条权威记录里：它的 OAuth 客户端配置、该连接被允许使用的确切权限范围、它所通信的端点，以及它用来认证的密钥或令牌。你不必再把同一份凭据这里粘到聊天、那里粘到智能体、别处又粘到某个应用，而是让一份连接器配置成为定义该连接的唯一地方，工作区中的一切都引用它。
由于 osFoundry 是自带密钥（BYOK）、本地优先的桌面工作区，连接器配置里的密钥是你自己的密钥和令牌，而不是通过经销商租来的东西，而且它们可以留在你的设备上，而不必存放在别人的服务器上。当某个连接需要 OAuth 时，正是在连接器配置里设置客户端信息与重定向，并记录已授予的权限范围，因此你能够精确看到一个连接获得了哪些访问权限，而不必靠猜。当需要轮换令牌或收紧某个权限范围时，你只需在连接器配置里改一次，使用该连接的每个聊天、智能体和应用都会采用这一变更。
这种单一来源的设计正是关键所在。连接往往会蔓延失控：同一个服务用着不同的密钥、被遗忘的令牌、含糊不清的权限。分散的配置既是维护负担，也是安全风险。把权限范围、密钥和 OAuth 配置一起放在同一条连接器记录里，意味着你随时都能对以下问题给出准确答案：什么被连上了、拥有哪些访问权限、用的是哪份凭据。而这恰恰是你在审计访问、把工作区交接给同事，或匆忙撤销某项权限时最要紧的问题。
主要功能
- 把每个外部连接作为连接器配置定义一次，然后从工作区的任何聊天、智能体或应用中引用它
- 存储 OAuth 客户端配置，并记录一个连接被授予的确切权限范围
- 在自带密钥模式下，把 API 密钥、令牌和密钥本地优先地保存在你的设备上，没有经销商加价
- 在一处轮换令牌或收紧权限范围，让该连接的每一个使用方都采用这一变更
- 一眼看清什么被连上、用的是哪份凭据，以及每个连接实际拥有哪些访问权限
使用场景
- 独立开发者：通过设置一份带有正确权限范围的连接器配置，把智能体接到第三方 API，而不必把密钥粘进每一条提示词
- 注重隐私的团队负责人：借助连接器配置把工作区的所有密钥都留在设备上，并在共享访问前审计已授予的 OAuth 权限范围
- 自动化维护者：在单一连接器配置里轮换即将过期的令牌，依赖该连接的每个应用和智能体都能继续运行
常见问题
连接器配置里的密钥实际存放在哪里？
osFoundry 是本地优先的桌面工作区，因此连接器密钥，也就是自带密钥模式下你自己的 API 密钥和令牌，可以留在你的设备上，而不是存放在托管服务器上。在你和所连接的服务之间，没有经销商介入。
除了密钥，连接器配置还包含什么？
连接器配置是一个连接的权威记录：它的 OAuth 客户端配置、被授予的具体权限范围、它所通信的端点，以及它用来认证的凭据。正是把这些放在一起，才让你能够精确看到一个连接拥有哪些访问权限。
如果我修改了一个连接，是否要在用到它的每个地方都更新一遍？
不用。因为一切都引用同一份连接器配置，在那里更新令牌或调整权限范围，都会流向使用该连接的每个聊天、智能体和应用。正是这种唯一可信来源，才是连接器配置存在的意义，而不是在每处使用里各自复制凭据。