Skip to main content

认证

Managed Agents API 的 API Key 鉴权与凭证配置

Managed Agents API 采用阿里云百炼 API Key 鉴权。全部请求通过 HTTP Header 携带 API Key，一个 Key 可访问其归属工作空间下的全部资源。 
Authorization: Bearer <your-api-key>

获取凭证

1

开通百炼并进入控制台

打开阿里云百炼控制台，使用阿里云账号登录并开通服务。
2

创建 API Key

在 API-KEY 页面创建并复制 API Key，以 sk- 开头。
API Key 具有账号级权限，请妥善保管，不要在公开渠道分享或提交到代码仓库。

使用方式

将 API Key 配置到环境变量： 
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxx"
每个请求携带 Authorization Header： 
curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/agents" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

权限说明

  • 阿里云主账号：可直接调用全部接口
  • RAM 子账号：需获得相应权限授权后调用
  • API Key 的权限范围由控制台配置
配置完成后，从创建 Agent开始调用。