AssetAnswerSSE - 进行资产问答的SSE接口

更新时间:
复制 MD 格式

MetaAgent 资产问答 SSE 接口

接口说明

基于 SSE 流式返回资产问答结果。传入 dbId 时在指定库内问答(asset_answer_agent);不传 dbId 时为租户级跨库全局问答(tenant_answer_agent)。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dms:AssetAnswerSSE

none

*全部资源

*

请求语法

POST / HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

DbId

string

数据库 ID,可选。传入时在指定库内问答;不传时为租户级跨库全局问答。可调用 ListDatabases 接口获取。

78459741

Query

string

用户自然语言问题

帮我找一下用户表

Model

string

选用的模型名称,仅可用千问系列

qwen-max

QueryId

string

本轮问答请求 ID,用于 SSE 事件中的 requestId 字段

test_001

SessionId

string

会话 ID,用于多轮对话上下文关联

48363552-225c-4c93-aeab-ea9b9d064b96

返回参数

名称

类型

描述

示例值

object

SSE 流式返回,每行格式为 data: {json}\n\n。正常流式为 requestId/output;RAM 鉴权失败时为 POP 标准错误体(含 AccessDeniedDetail)。

AccessDeniedDetail

object

RAM 鉴权失败详情

AuthAction

string

接口名。

xx

AuthPrincipalDisplayName

string

请求中用于鉴权的身份标识。

xx

AuthPrincipalOwnerId

string

授权主体所有者 ID。

xx

AuthPrincipalType

string

授权主体类型。

xx

EncodedDiagnosticMessage

string

加密后的完整诊断信息。

AQEAAAAAaJQJ5zhGNzBCNzFGLUJEODctNTAzQi1CNTUxLUMwODI2NzhFRDRERA==

NoPermissionType

string

导致鉴权失败的原因。

xx

PolicyType

string

策略类型

System

Code

string

错误码

200

Data

any

表资产分页结果

1001

ErrorCode

string

错误码。

200

ErrorMessage

string

错误信息。

UnknownError

HostId

string

主机 ID

100.127.196.34

Message

string

错误信息

UnknownError

Recommend

string

是否设置为推荐服务发布到服务目录。

true

RequestId

string

请求 ID。

7FAD400F-7A5C-4193-8F9A-39D86C4F0231

Success

boolean

  • true:禁用成功

  • false:禁用失败

true

TraceId

string

用于跟踪服务请求。

0a06e1e316757357507896067d3780

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": {
    "AuthAction": "xx",
    "AuthPrincipalDisplayName": "xx",
    "AuthPrincipalOwnerId": "xx",
    "AuthPrincipalType": "xx",
    "EncodedDiagnosticMessage": "AQEAAAAAaJQJ5zhGNzBCNzFGLUJEODctNTAzQi1CNTUxLUMwODI2NzhFRDRERA==",
    "NoPermissionType": "xx",
    "PolicyType": "System"
  },
  "Code": "200",
  "Data": "1001",
  "ErrorCode": "200",
  "ErrorMessage": "UnknownError",
  "HostId": "100.127.196.34",
  "Message": "UnknownError",
  "Recommend": "true",
  "RequestId": "7FAD400F-7A5C-4193-8F9A-39D86C4F0231",
  "Success": true,
  "TraceId": "0a06e1e316757357507896067d3780"
}

错误码

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

变更历史

更多信息,参考变更详情