保存智能体data semantics
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AgentName |
string |
是 |
智能体名称 |
bakehouse_agent |
| Metrics |
array |
否 |
SQL 表达式知识。传入时保存本次内容，未传入时清空；最多 100 项，单类知识最大 16KB |
|
|
AgentDataSemanticsMetric |
否 |
单条 SQL 表达式知识 |
||
| Joins |
array |
否 |
数据关联知识。传入时保存本次内容，未传入时清空；最多 100 项，单类知识最大 16KB |
|
| AgentDataSemanticsJoin |
否 |
单条数据关联知识 |
||
| Examples |
array |
否 |
SQL 示例知识。传入时保存本次内容，未传入时清空；最多 50 项，单类知识最大 16KB |
|
| AgentDataSemanticsExample |
否 |
单条 SQL 示例知识 |
||
| Text |
AgentDataSemanticsText |
否 |
Markdown 格式的文本知识。传入时保存本次内容，未传入时清空；单类知识最大 16KB |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Message |
string |
响应消息；失败时为错误信息 |
Invalid data semantics request. |
| RequestId |
string |
阿里云为该请求生成的唯一标识符 |
5DAF96FB-A4DF-548C-B8A1-F2A8D2F4**** |
| Data |
object |
更新结果；保存成功时为空对象，不包含额外业务字段。四类知识均未传入时目标为四类全空：已有非空当前版本时发布全空版本，当前已全空或没有当前版本时幂等成功，并结束本轮待保存的生成结果 |
{} |
| Code |
string |
接口返回码 |
Success |
| Success |
boolean |
是否调用成功 |
true |
示例
正常返回示例
JSON格式
{
"Message": "Invalid data semantics request.",
"RequestId": "5DAF96FB-A4DF-548C-B8A1-F2A8D2F4****",
"Data": {},
"Code": "Success",
"Success": true
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter | Invalid data semantics request. | |
| 500 | InternalError | Internal Server Error | |
| 403 | ServiceNotEnable | Service not enable | |
| 403 | EventHouseServiceNotEnable | EventHouse service not enable | |
| 404 | AgentNotFound | Agent not found. | |
| 409 | DataSemanticsGenerationRunning | Data semantics generation task is already running. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。