CreateCommands - 创建自定义指令
创建自定义指令。
服务接入点与授权信息
请求语法
POST https://{domain}/oapi/v1/lingma/organizations/{organizationId}/commands
请求头
| 参数 |
类型 |
是否必填 |
描述 |
示例值 |
| x-yunxiao-token |
string |
是 |
个人访问令牌。 |
pt-0fh3****0fbG_35af****0484 |
请求参数
| 参数 |
类型 |
位置 |
是否必填 |
描述 |
示例值 |
| organizationId |
string |
path |
是 |
所属企业 ID。 |
|
| - |
object |
body |
是 |
|
|
| operatorId |
string |
body |
是 |
指令操作人id |
|
| commands |
array[] |
body |
是 |
|
|
| - |
object |
body |
是 |
自定义指令详情 |
|
| displayName |
string |
body |
是 |
指令名称。 |
|
| name |
string |
body |
是 |
指令英文名称。 |
|
| description |
string |
body |
是 |
指令描述。 |
|
| imageUrl |
string |
body |
是 |
指令图标。 |
|
| type |
string |
body |
是 |
指令类型。 |
prompt |
| visibility |
string |
body |
是 |
可见性。 |
public/private |
| contexts |
array[] |
body |
是 |
指令上下文。 |
|
| - |
object |
body |
是 |
|
|
| identifier |
string |
body |
是 |
上下文id。 |
|
| optional |
string |
body |
是 |
是否必选。 |
N/Y |
| config |
string |
body |
是 |
指令配置(prompt对应JSON字符串)。 |
|
请求示例
curl -X 'POST' \
'https://test.rdc.aliyuncs.com/oapi/v1/lingma/organizations/{organizationId}/commands' \
-H 'Content-Type: application/json' \
-H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
--data '{
"operatorId": "",
"commands": [
{
"displayName": "",
"name": "",
"description": "",
"imageUrl": "",
"type": "",
"visibility": "",
"contexts": [
{
"identifier": "",
"optional": ""
}
],
"config": ""
}
]
}'
返回参数
| 参数 |
类型 |
描述 |
示例值 |
| - |
array[] |
|
|
| - |
string |
自定义指令id。 |
|
返回示例
[
"commandId1",
"commandId2"
]
错误码
访问错误码中心查看 API 相关错误码。