集成
打开管理面板集成中心以连接 EventHub、数据仓库连接器和 API 控制台。可用性取决于计划和部署。
管理面板中的 Integrations 中心是管理员将 PetroBench 连接到公司数据系统并为组织打开 API Console 的地方。
此管理面板界面正在推出,可能尚未出现在每个组织中。当您的计划启用它时,您将在Admin Panel > API & Integrations 下找到它。深度设置指南位于 企业集成。
开放集成
1.切换到Admin Panel 2. 打开API & Integrations > Overview(标签可能显示为Integrations) 3. 查看特色连接器和类别列表(石油和天然气、云和数据、身份和访问以及相关组)
当您的组织有权访问时,中心会显示可用和已连接集成的总数。
你在这里管理什么
| 面积 | 目的 |
|---|---|
| Connector catalog | 浏览您的组织可用的集成 |
| Connection status | 查看哪些连接器已启用或即将推出 |
| EventHub | 打开活动仓库连接的同步配置和日志 |
| API Console | 服务令牌、Webhook、使用情况和客户端连接配置 |
个人 API 密钥仍然位于 设置 下。管理面板中心是组织级开发人员界面。
EventHub 和仓库同步
对于 EventHub、Snowflake 和相关同步工作流程,请使用企业指南:
在管理面板中,您通常:
1.打开已连接的集成卡 2. 查看字段映射、同步计划和最近的同步日志 3. 当连接器排队低置信度匹配时解决设备匹配审核
来自入站同步的可信度较低的设备匹配将排队等待管理员审核,因此工程师不会默默地获得错误的抽油机或抽油杆等级。
API 控制台
API Console 是用于组织 API 访问的应用内主页。打开 Admin Panel > API & Integrations > API Console。
它包括四个选项卡:
| 选项卡 | 目的 |
|---|---|
| Service Tokens | 为服务器和作业铸造和管理部门拥有的代币 |
| Webhooks | 为平台事件注册 HTTP 端点 |
| Usage | 实时请求量、计划限制和每月配额 |
| Connect | CLI、MCP 客户端和 REST 的复制就绪配置 |
### 用法
Usage 显示本期API请求量、配额、Token消耗情况。
典型的卡片包括:
- 组织和个人请求计数、平均响应时间和错误率
- Plan limits - 每分钟请求数、分区聚合、并发运行、每日代币上限
- Monthly quotas - 读取、写入、模拟运行和 webhook 交付
- Daily activity 加上存在流量时的顶级端点和消费者
诊断速率限制、配额压力或意外 API 错误时使用此选项卡。另请参阅速率限制。
服务令牌
Service Tokens 是division 而非个人拥有的长期凭证。他们在创作者离开后继续工作。
创建服务令牌
- 前往Admin Panel > API & Integrations > API Console
- 打开Service Tokens选项卡
- 点击Create service token
- 输入Token name(例如
Nightly Snowflake Sync) - 选择Expiration(30天、90天或1年)
- 可选择设置IP allowlist
- 为油井、模拟、设备和组织选择Permissions(范围)
- 点击Create service token
- 立即复制明文令牌 - 它仅显示一次
从行菜单中,您可以重命名、旋转或撤销令牌。每个部门的活跃代币数量都有上限(显示为列表中使用的总数)。
优先选择用于计划作业和集成的服务令牌。仅当单个工程师交互调用 API 时,才首选 个人 API 密钥。
完整的身份验证详细信息:API 身份验证。
网络钩子
Webhooks 注册 PetroBench 在事件发生时调用的 HTTP 端点(例如,well.created 或 simulation.failed)。
- 打开Webhooks选项卡
- 点击Add Webhook
- 输入端点 URL 并选择事件 4.保存,然后使用发送/测试控件来验证发送
连接
Connect 选项卡可帮助您将 CLI、MCP 客户端(Claude、ChatGPT、Cursor)、cURL 或 Python 指向工作区。复制客户端的配置,然后将 API 密钥占位符替换为服务令牌或个人密钥。
谁可以访问
| 行动 | 总部管理员 | 部门管理 | 区域管理员 |
|---|---|---|---|
| 查看集成中心 | 是的 | 因计划而异 | 没有 |
| 配置EventHub | 是的 | 因计划而异 | 没有 |
| 打开 API 控制台(使用、连接) | 是的 | 是(自己的部门) | 没有 |
| 管理服务令牌 | 是的 | 是(自己的部门) | 没有 |
| 管理 Webhooks | 是的 | 是(自己的部门) | 没有 |
## 有关的