火山引擎扣子智能体平台API

密钥仅在浏览器端存储,易源不做转发

查看空间列表

查看当前账号加入的空间列表,包括个人空间和工作空间。

空间列表结果

请点击上方按钮获取空间列表

功能示例

查看我的空间列表

空间管理 列表查询

输入:

  • 分页页码:1
  • 每页显示数量:10

输出:

  • 空间总数:3
  • 空间列表:
    • 名称:个人工作空间,类型:个人,角色:所有者
    • 名称:产品研发团队,类型:团队,角色:成员
    • 名称:市场部协作空间,类型:团队,角色:管理员

查看团队空间的智能体列表

智能体管理 团队协作

输入:

  • 团队空间名称:产品研发团队
  • 分页页码:1

输出:

  • 智能体总数:2
  • 智能体列表:
    • 名称:需求分析助手,描述:自动解析产品需求文档生成功能清单,发布时间:2025-04-10
    • 名称:代码审查小助手,描述:辅助检查Python代码规范和潜在漏洞,发布时间:2025-04-12

创建新智能体

智能体开发 配置管理

输入:

  • 智能体名称:客户服务助手
  • 所在空间:市场部协作空间
  • 智能体人设:专业的客户服务助手,快速解答产品咨询、售后问题及退款流程指引
  • 描述:7x24小时自动化客户服务响应,提升咨询处理效率

输出:

  • 智能体ID:CS-20250415-001
  • 创建状态:成功(草稿已保存,可在智能体列表查看)

发布智能体到API渠道

API集成 部署发布

输入:

  • 智能体名称:客户服务助手
  • 发布渠道:API接口

输出:

  • 发布状态:成功
  • 版本号:V1.0.0
  • 发布时间:2025-04-16 09:30

使用场景

团队协作管理

统一管理企业内部多个团队空间,清晰查看成员角色和权限分配,提升团队协作效率。

智能体开发流程

支持从创建智能体到发布API的完整开发流程,实现自动化部署和版本管理。

企业资源整合

集中管理企业内所有智能体资源,实现跨部门智能体调用和数据共享,避免重复开发。

多端应用集成

通过API接口将智能体快速集成到网站、APP、小程序等多端应用,提供一致的智能服务体验。

智能数据分析

利用智能体API获取各空间数据,进行多维度分析,为企业决策提供数据支持和洞察。

权限精细控制

基于角色的访问控制,确保不同用户只能访问其权限范围内的空间和智能体资源,保障数据安全。

价格信息

价格由API服务商设定,请到服务商官网查看详细定价方案

查看火山引擎官网价格

常见问题

如何获取访问API所需的Authorization令牌?

您需要先在火山引擎扣子平台注册账号并创建应用,在应用管理页面可以生成Access Token。具体步骤请参考火山引擎官方文档中的"获取访问令牌"章节。生成的令牌格式为"Bearer {Access_Token}",需要在API请求头中携带。

API支持哪些分页参数?默认分页大小是多少?

API支持page_num(分页页码)和page_size(分页大小)两个分页参数。page_num默认为1,page_size默认为20,最大可设置为50。您可以通过调整这两个参数来控制返回结果的数量和页码。

创建的智能体默认是什么状态?如何使其在API中可见?

通过API创建的智能体默认为"草稿"状态,此时无法通过"查看智能体列表"接口看到。您需要调用"发布智能体"接口将其发布到指定渠道(如API渠道)后,才能在相应的API中查询到该智能体。发布后,智能体状态变为"已发布"。

如何区分个人空间和工作空间?

API返回的空间信息中包含"workspace_type"字段,该字段值为"personal"表示个人空间,"team"表示工作空间。此外,个人空间中用户角色通常为"owner"(所有者),而工作空间中用户可能有"owner"、"admin"(管理员)或"member"(成员)等不同角色。

API调用有频率限制吗?如何处理调用超限的情况?

是的,火山引擎API有默认的调用频率限制,具体限制根据您的账号类型和服务套餐可能有所不同。当调用频率超限时,API会返回429状态码。建议在开发时实现请求重试机制,并在重试前检查响应头中的X-RateLimit-Reset字段,了解限制重置时间。对于高频调用需求,可联系火山引擎客服申请提高配额。

如何删除不再需要的智能体或空间?

目前API暂不直接支持删除智能体或空间的功能。您需要登录火山引擎扣子平台网页版,在相应的智能体或空间管理页面进行删除操作。请注意,删除操作不可逆,请谨慎操作。对于工作空间,只有拥有"owner"角色的用户才能执行删除操作。