hermes agent需通过dashscope阿里云百炼平台获取api key、agentkey及可选ram accesskey三类凭证配合使用:api key用于身份认证,agentkey(workspace_id)标识业务空间,accesskey仅用于跨服务集成调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您需要在DashScope阿里云百炼平台中使用HermesAgent相关能力,但尚未获取其所需的密钥,则可能是由于未正确创建或定位对应类型的API凭证。HermesAgent并非独立密钥类型,其调用依赖于百炼平台生成的API Key,并需配合特定业务空间与权限配置。以下是获取适用于HermesAgent调用的密钥的具体步骤:
一、创建百炼API Key(主账号或授权子账号)
该方法适用于拥有主账号权限,或已被授予“API-Key管理”权限的RAM子账号用户。创建的API Key将作为HermesAgent调用的身份凭证,归属业务空间决定其可访问的智能体与工作流资源。
1、登录阿里云控制台,进入阿里云百炼控制台首页。
2、确保右上角地域已切换为实际部署HermesAgent应用所在的地域(如华北2(北京)、新加坡等)。
3、在左侧导航栏点击API Key管理,进入API Key列表页。
4、单击创建API Key按钮,在弹窗中配置以下字段:
5、归属账号:选择主账号(显示为纯数字ID),不建议跨账号授权;若需隔离权限,可选择已授权的RAM子账号。
6、归属业务空间:选择HermesAgent所属的业务空间(例如默认业务空间,或已为HermesAgent单独创建的子业务空间)。
7、权限配置:勾选全部权限;若启用IP白名单,请确保调用方出口IP已加入IPv4/IPv6网段(如0.0.0.0/0)。
8、单击确定后,新API Key即生成;点击右侧复制图标获取完整密钥字符串(格式为sk-xxxxx)。
二、确认并获取AgentKey(用于HermesAgent专属调用)
AgentKey是百炼平台为特定智能体应用(如HermesAgent)分配的业务空间标识符,非独立密钥,但为调用其工作流接口所必需。该值用于构造请求头中的workspace-id或X-DashScope-Workspace-ID字段。
1、返回阿里云百炼控制台首页,点击页面左下角设置图标(齿轮形)。
2、在弹出菜单中选择业务空间详情。
3、在业务空间列表中,找到与HermesAgent绑定的业务空间名称(通常含“hermes”、“agent”等关键词或由管理员命名)。
4、点击该空间右侧的复制ID按钮,获取长度为32位的十六进制字符串,即AgentKey(亦称workspace_id)。
5、该AgentKey需与API Key配合使用,不可单独用于认证。
三、通过RAM用户AccessKey辅助验证(仅限调试与跨服务集成)
当HermesAgent需与阿里云其他服务(如OSS、函数计算FC)联动时,部分底层操作可能依赖RAM用户的AccessKey进行身份代理。此密钥不直接用于HermesAgent HTTP API调用,但可用于服务端签名或权限校验场景。
1、前往RAM访问控制控制台。
2、在左侧导航栏选择身份管理 > 用户,找到已授权操作百炼资源的RAM用户。
3、点击该用户名称,进入用户详情页。
4、在“AccessKey 管理”区域,单击创建AccessKey(若无可用AccessKey)。
5、系统生成AccessKey ID与AccessKey Secret后,立即点击下载CSV文件保存凭证;页面不再显示Secret明文。
6、确认该RAM用户已被授予AliyunBailianFullAccess或自定义策略中包含bailian:InvokeAgent权限。











