文档中心

数据智能体 DataAgent（私有化）

请输入

A2A

Agent Card

接口名称

GET /.well-known/agent-card.json

接口详情

完整地址：

GET {BASE_URL}/dataAgent/llm/openApi/v3/a2a/{AGENT_ID}/.well-known/agent-card.json

用于发现目标 Agent 的名称、描述、支持的 JSON-RPC 地址、流式能力、输入输出模式、技能和认证方案。该接口不返回任务数据。

cURL 调用示例

curl -X GET \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v3/a2a/${AGENT_ID}/.well-known/agent-card.json" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  --silent | jq

返回参数

字段	说明
`supportedInterfaces[0].url`	JSON-RPC POST 入口。
`supportedInterfaces[0].protocolBinding`	固定为 `JSONRPC`。
`capabilities.streaming`	固定为 `true`，表示支持 SSE 流式方法。
`capabilities.pushNotifications`	固定为 `false`，不支持服务端主动推送回调。
`defaultInputModes`	支持 `text/plain`、`application/json`。
`defaultOutputModes`	支持 `text/plain`、`text/markdown`、`application/json`。
`skills`	当前包含 `deep-research`，可进行研究、数据分析和结构化报告生成。
`securitySchemes`、`securityRequirements`	可用认证方式及其请求头要求。

返回示例

{
    "name": "zqx Agent",
    "description": "测试",
    "supportedInterfaces": [
        {
            "url": "http://xxxxxxxcom/bi/dataAgent/llm/openApi/v3/a2a/4/",
            "protocolBinding": "JSONRPC",
            "protocolVersion": "1.0"
        }
    ],
    "provider": {
        "organization": "DataAgent Team"
    },
    "version": "1.0.0",
    "capabilities": {
        "streaming": true,
        "pushNotifications": false
    },
    "securitySchemes": {
        "signedTimestamp": {
            "apiKeySecurityScheme": {
                "description": "Current Unix timestamp.",
                "location": "header",
                "name": "x-timestamp"
            }
        },
        "signedSignature": {
            "apiKeySecurityScheme": {
                "description": "Request signature.",
                "location": "header",
                "name": "x-sign"
            }
        },
        "jwtToken": {
            "oauth2SecurityScheme": {
                "description": "Use client credentials and send the JWT as a Bearer token.",
                "flows": {
                    "clientCredentials": {
                        "tokenUrl": "http://e16-1-10dataagent.datarangers-onpremise.volces.com/bi/aeolus/api/v3/openapi/jwtToken"
                    }
                }
            }
        },
        "signedUser": {
            "apiKeySecurityScheme": {
                "description": "OpenAPI caller identity.",
                "location": "header",
                "name": "x-user"
            }
        },
        "signedToken": {
            "apiKeySecurityScheme": {
                "description": "Client credential used to calculate x-sign.",
                "location": "header",
                "name": "x-token"
            }
        }
    },
    "securityRequirements": [
        {
            "schemes": {
                "signedSignature": {},
                "signedTimestamp": {},
                "signedUser": {},
                "signedToken": {}
            }
        },
        {
            "schemes": {
                "jwtToken": {}
            }
        }
    ],
    "defaultInputModes": [
        "text/plain",
        "application/json"
    ],
    "defaultOutputModes": [
        "text/plain",
        "text/markdown",
        "application/json"
    ],
    "skills": [
        {
            "id": "deep-research",
            "name": "Deep Research",
            "description": "Research, analyze data, and produce structured reports.",
            "tags": [
                "research",
                "analysis",
                "report"
            ],
            "examples": [
                "Analyze the uploaded data and summarize the findings."
            ],
            "inputModes": [
                "text/plain",
                "application/json"
            ],
            "outputModes": [
                "text/markdown",
                "application/json"
            ]
        }
    ]
}

最近更新时间：2026.09.04 10:25:42

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

接口名称 #

接口详情 #

cURL 调用示例 #

返回参数 #

返回示例 #

#

接口名称

接口详情

cURL 调用示例

返回参数

返回示例