RunSkill - 异步触发技能执行

更新时间:
复制 MD 格式

异步触发技能执行,立即返回 RunId。

接口说明

请求说明

本接口仅支持异步模式:提交后立即返回 RunId 和 Status=Running,客户端通过 GetSkillRun 轮询最终结果。

  • TenantId:可选公共参数,由网关透传到后端 Header。

  • SkillCode / SkillName:二选一;SkillCode 优先;SkillName 不唯一时返回 ERR.SkillHub.SkillNameAmbiguous。

  • Arguments:必填,技能入参对象,结构由 GetSkill 返回的 inputConfig 描述。

  • ClientToken:可选幂等键;当前版本仅记录到任务元数据,不做强幂等去重。

注意:同步模式(Async=false)、Stream、CallbackUrl 一期不支持,将在后续版本提供。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /openapi/runSkill HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

tenantId

string

否

租户 ID,公共参数,缺省时使用调用方默认租户。

10000

skillCode

string

否

技能编码(全局唯一),优先级高于 skillName。

string_value

skillName

string

否

技能名称,未传 skillCode 时使用;租户范围内必须唯一。

string_value

arguments

object

否

保存错误信息的占位变量值。

string_value

operatingObjectName

string

否

数字员工名称;用于按绑定关系计算 CodeAgent allowedSkills 白名单。

string_value

model

string

否

抽象模型名(模型档位),不传默认 standard。

quick

clientToken

string

否

幂等 token,调用方自行生成;当前版本仅记录到 metadata,未做去重。

string_value

返回参数

名称

类型

描述

示例值

object

异步入队成功。

code

string

响应状态码。

200

message

string

提示信息。

The current zone list is illegal.

requestId

string

请求 ID

019FF406-1B10-0065-A97D-2D1920C2A03D

runId

string

异步任务 ID,用于 getSkillRun 查询。

exampleRunId

skillCode

string

实际执行的技能编码。

string_value

skillName

string

技能名称。

string_value

status

string

任务状态:提交即返回 Running。

READY

createdAt

string

任务创建时间,ISO8601 UTC 格式。

string_value

示例

正常返回示例

JSON格式

{
  "code": "200",
  "message": "The current zone list is illegal.",
  "requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
  "runId": "exampleRunId",
  "skillCode": "string_value",
  "skillName": "string_value",
  "status": "READY",
  "createdAt": "string_value"
}

错误码

访问错误中心错误中心查看更多错误码。

变更历史

更多信息,参考变更详情变更详情。