平台
集成
位于 /integrations 的集成中心把 ZenStudio 接到外部模型提供商与自动化工具上；/mcp 则把它接到工具服务上。密钥存在服务端、只由运行时使用——绝不回传给浏览器。
先说默认提供商
如果运维这个实例的人配置了共享的 OpenRouter 密钥，你不需要接入任何集成就能开始——每个账号都能零配置使用它。接入你自己的提供商密钥，会把调用改走你自己的账号与账单，并解锁共享密钥覆盖不到的提供商。
大模型提供商（自带密钥）
该 大语言模型提供商 页签是一组密钥表单，每个提供商一份，各自只列出它真正需要的字段：
- 直连 API 密钥 ——OpenAI（组织 ID 可选）、Anthropic（含 API 版本）、Google Gemini、Grok（xAI）、Groq、OpenRouter、NVIDIA、Qwen（DashScope）。多数都接受可选的自定义基础 URL。
- 云平台 ——AWS Bedrock、Google Vertex AI、Azure OpenAI（端点 + 部署名）和 OCI 生成式 AI，各有其平台专属的凭据字段。
- 自托管 ——自定义 Ollama 端点，以及 OpenAI 兼容的 vLLM 服务。
接入之后，该提供商就能在 智能体构建器 和集群节点检查器里选到。某些提供商的模型不支持工具调用——把带工具的智能体指向它时，构建器会给出提示。
大语言模型网关
该 大语言模型网关 页签把平台指向你自己的 OpenAI 兼容网关——LiteLLM 之类。你提供一个基础 URL 和一个密钥，并选择两种路由模式之一。
| 模式 | 什么会经它路由 | 适用场景 |
|---|---|---|
| 按智能体 | 只有在工具设置里打开了 通过网关路由 的智能体。其余一切都直连提供商。 | 在正式采用之前，先拿一个工作负载试试这个网关。 |
| 全部路由 | 该账号下的每一次大模型调用：对话、集群、BI 回答、嵌入、技能生成、笔记本、模型列表和向量嵌入。 | 「一个网关一份账单」的模式——集中限流、集中计费、单一审计痕迹。 |
启用任一模式都会先对网关做校验，因此密钥填错会在配置时就失败，而不是等到某人下一次提问。认证失败会阻止启用；而没有暴露 /models 的网关是允许的，因为并非所有网关都提供它。
「全部路由」是路由，不是出网边界
共享凭据（团队）
超级管理员可以在此把某个用户的大模型凭据授予其他用户或用户组： 管理 → IAM （资源类型为「大模型密钥」和「大模型凭据」）——这就是「一份统一开通的 Bedrock 或 OpenAI 凭据供整个团队使用」的企业模式。
到底哪把密钥付钱
这一点值得弄准确，因为它决定账单落到谁头上。按顺序，先匹配到的生效：
- 1
调用方自己的连接
如果你自己接入过该提供商，那就一定用你的密钥。授权永远不会顶替你自己的凭据。 - 2
被授予给你的凭据
在调用时由服务端解析，在集成页上显示为「已共享给你」。你可以使用它，但永远读不到它。 - 3
运维方的环境默认值
该实例配置的共享密钥（如果有的话）。全新账号在接入任何东西之前能用，靠的就是它。
共享一把密钥，并不共享其他任何东西
通知渠道
该 通知 页签可接入 Slack、Microsoft Teams、Discord 或任意自定义 Webhook。已接入的渠道会与应用内通知铃一起接收系统告警（凭据健康检查失败、定时刷新出错、BI 数据告警），并为 send_notification 这个智能体工具提供能力（在「智能体构建器 → 工具 → 自动化」下按智能体启用）。保存时会先发一条可见的测试消息；Webhook URL 属于能力型 URL，因此加密存储且不会再次显示。
n8n 工作流
该 n8n 工作流 页签通过 Webhook URL 和令牌接入一个 n8n 实例，让智能体能以工具的形式触发你的自动化流程。同样的模式也适用于智能体构建器里可按智能体配置的其他自动化平台（Activepieces、Node-RED、Windmill、Temporal、Airflow、Zapier、Make，或一个普通 Webhook）。
MCP 服务
/mcp 把 Model Context Protocol 服务挂到你的工作区上。接入时平台会探测该服务、发现它暴露的工具；随后可以在智能体构建器的工具区把特定服务的访问权授予智能体。
可以接入什么
| 类别 | 可接入 | 文档位置 |
|---|---|---|
| 模型提供商 | 14 家——OpenAI、Anthropic、Gemini、Vertex、Bedrock、Azure OpenAI、OCI、Grok、Qwen、Groq、NVIDIA、OpenRouter、Ollama、vLLM | 模型与提供商 |
| 数据源 | 22 种就地查询的数据库 / 数仓连接器，5 种同步成数据集的应用，另加对象存储与湖仓目录 | 数据目录与 SQL |
| 网页搜索 | Firecrawl（内置）、Brave、Tavily、SerpAPI；页面抓取用 ScrapingBee | 智能体构建器 → 工具 |
| 自动化 | n8n 工作流，由智能体工具触发 | 智能体构建器 → 工具 |
| 通知 | Slack、Microsoft Teams、Discord、自定义 Webhook——系统告警加上 send_notification 智能体工具 | 智能体构建器 → 工具 |
| MCP 服务 | 任意 Streamable HTTP MCP 端点 | MCP 服务 |
凭据的处理方式
- 每个密钥都 加密存储 ，保存后绝不回传给浏览器。
- 优先使用 密钥 引用，而不是粘贴具体值，这样轮换只需改一处，不必把每个连接翻一遍。
- 测试连接 会把结果与报错保存在该连接上，于是你能看出问题是从什么时候开始的，而不是通过一个坏掉的仪表板才发现。
- 定时健康检查 每 6 小时重跑一遍同样的实测（设置
INTEGRATION_HEALTH_HOURS可修改周期，0可关闭）。在上游被吊销的密钥会显示为「健康检查失败」徽标、发出应用内通知，并进入审计痕迹——都发生在某次智能体运行栽在它上面之前。健康检查结果绝不会自动停用某个连接。 - 接入、修改或删除任何凭据都会记录进 审计痕迹 ——包括名称、URL 以及某个密钥是否被轮换过；绝不含密钥本身。
- 断开连接 会先请你确认，并告诉你有什么依赖这个连接。
出网请求受防护