获取APP ID和Workspace ID

调用阿里云百炼API时,需要使用 APP ID 来指定应用。若应用位于子空间内,还需提供 Workspace ID。本文介绍如何在控制台中快速获取这两个ID,为后续构建API请求做好准备。

适用范围

目前只能通过控制台手动获取APP IDWorkspace ID,不支持通过 API 或命令行工具(CLI)查询。

如何获取

获取APP ID

在通过 API 调用任一应用(智能体、工作流)时,都需要提供其唯一的APP ID

1. 登录阿里云百炼控制台。

2. 在左侧导航栏,选择应用管理

3. 在应用列表中找到目标应用,其对应的应用ID列即为APP ID

image

获取Workspace ID

Workspace ID是业务空间的唯一标识。仅在调用子业务空间下的应用时,API 请求中才必须包含Workspace ID。如果应用位于默认业务空间,则调用时无需提供此参数。

以下介绍两种获取Workspace ID的场景。

场景一:获取当前所在业务空间的 ID

此方法适用于快速查找当前登录并使用的业务空间的 ID。

  1. 前往阿里云百炼控制台首页

  2. 单击界面左下角的image图标,再单击业务空间详情

  3. 在弹出的对话框中即可查看并复制业务空间ID

RAM 子账号默认只能查看其已加入的业务空间的 ID。

image

场景二:获取主账号下所有业务空间的 ID

此方法适用于需要管理或查询主账号下全部业务空间 ID 的场景,通常由管理员操作。

1. 使用主账号或授权子账号登录阿里云百炼控制台;

2. 单击右上角的image图标,访问业务空间管理界面;

3. 在业务空间列表中,即可在Workspace ID列查看并复制各空间的Workspace ID

此操作要求使用主账号,或已授予AliyunBailianFullAccess/AliyunBailianControlFullAccess权限的 RAM 子账号。若无相应权限,访问页面将提示权限不足。关于如何授权,请参考管理权限(全局管理)

下一步

获取 ID 后,即可参考DashScope API 参考Responses API 参考文档,构建并发送 API 请求。

常见问题

Q:调用 API 时,是否总是需要提供 Workspace ID?

A:不是。当您调用的应用位于一个子业务空间时,必须在 API 请求中提供Workspace ID。当您调用的应用位于默认业务空间时,API 请求中无需包含Workspace ID参数。

Q:为什么 RAM 子账号访问“业务空间管理”页面会报错?

A:访问业务空间管理页面需要权限。如果 RAM 子账号未获得相应授权,访问时会收到权限不足的错误。解决方案:请联系主账号管理员,为该 RAM 子账号授予AliyunBailianFullAccessAliyunBailianControlFullAccess权限策略。具体授权操作,请参考管理权限(全局管理)