使用 Admin API 管理自定义代理

如果你是企业版管理员，就可以使用 Admin API 管理工作空间中的 自定义代理。你的团队无需逐个点击设置，即可将代理和使用数据拉取到你自己的工具中，并同时对多个代理应用相同的规则。Admin API 仅供使用组织专用的管理员令牌的企业组织管理员使用。

• 查看工作空间中的每一个 自定义代理。 获取所有代理的列表，包括每个代理的创建者、是否处于活动状态、使用的模型、上次运行时间以及它有权访问的内容。

• 跟踪谁有权访问自定义代理。 更新代理的 共享权限。

• 跟踪已使用积分。 查看每个代理已使用的积分，并批量 跟踪已使用积分。

• 设置积分限制。 为单个代理设置或更改积分限制，或者为所有自定义代理设置工作空间默认值。

• 选择谁可以创建代理。 设置工作空间的代理创建策略，并在需要时暂停工作空间内的所有代理。

• 关闭或开启代理。停止特定代理的运行而不删除其设置，并可在稍后重新开启。

• 删除代理。停止使用某个代理。其设置会被保留，以便在需要时恢复。

• 你的工作空间必须使用企业版。

• Admin API 使用你组织设置的组织级管理员访问权限，而非个人集成令牌。有关设置步骤，请参阅 开发者文档 →

Admin API 执行的每项操作在 Notion 中都有对应的控制项：

• 自定义代理目录（设置 → Notion AI → 自定义代理）可用于查看和管理工作空间中的代理。

• Notion 积分管理面板显示代理的积分使用情况。

• 创建控制项用于设置谁可以创建代理。

对于单次更改，请使用“设置”。当你需要自动化这些任务、同时管理多个代理或将使用数据导入你自己的报告工具时，请使用 Admin API。

• 将已使用积分数据导入内部报告，这样每个团队都可以查看自定义代理的成本。

• 同时对多个代理应用相同的限制或规则。

• 将需要继续运行的代理转移所有者；关闭或移除不再需要的代理。