文档中心

数据智能体 DataAgent（私有化）

请输入

提示词模版

IDA-获取提示词模板列表

请求说明

项目	内容
请求方式	`GET`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/promptTemplates?agentId=80&isPublic=1&offset=0&limit=30`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`

请求参数

参数	类型	必填	默认值	说明
`agentId`	int	是		智能体 ID
`isPublic`	int	否		公开状态：`1` 公开，`0` 私有
`isOwner`	int/bool	否		传 `1` 时只返回当前 `x-user` 创建的模板
`query` / `q`	string	否		按模板名称、描述或场景名称模糊搜索
`mode`	string	否		`knowledge_qa` 或 `deep_research`
`myCollected` / `isCollected`	int/bool	否	`0`	传 `1` 时只返回当前用户收藏的模板
`isTopPick`	int/bool	否	`0`	传 `1` 时返回精选模板
`orderBy`	string	否	`collected_cnt`	可选：`collected_cnt`、`used_cnt`、`most_recent`、`like_cnt`、`share_cnt`
`limit`	int	否	`20`	分页数量；最大值为 `100`
`offset`	int	否	`0`	分页偏移量，最小值为 `0`
`include`	string	否	`stats,myFlags`	响应扩展字段，逗号分隔；`stats` 返回计数，`myFlags` 返回当前用户点赞/收藏状态，`none` 表示均不返回

请求示例

标准 Curl 示例：

curl -X GET \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/promptTemplates?agentId=80&isPublic=1&offset=0&limit=30" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  --silent | jq

返回参数

字段	类型	说明
`code`	string	业务码，成功为 `llm/ok`
`data.items`	array	模板列表
`data.total`	int	符合条件的模板总数
`data.limit`	int	本次分页数量
`data.offset`	int	本次分页偏移量
`data.hasMore`	bool	是否还有下一页
`msg`	object	错误信息容器

返回示例

{
  "JSONIFY_PRETTYPRINT_REGULAR": false,
  "code": "llm/ok",
  "data": {
    "hasMore": false,
    "items": [
      {
        "agentId": 279,
        "collectedCnt": 0,
        "conversationOptions": {
          "enableAeolusAssetSearch": false,
          "enableHiveDataSearch": false,
          "enableLarkQA": false,
          "enableWebSearch": true,
          "enabledMcpServers": [],
          "templateSkills": []
        },
        "ctime": "2026-08-12T13:57:21",
        "data": "请评估活动策划方案：{{e7f79b80-871a-4c39-af89-1e6b06931668}}",
        "description": "对活动策划方案进行全面评估和优化",
        "id": 186,
        "isOfficial": false,
        "isPinned": false,
        "isPublic": 1,
        "isRecommend": 0,
        "likeCnt": 0,
        "me": {
          "collected": false,
          "liked": false
        },
        "mode": "knowledge_qa",
        "mtime": "2026-08-12T13:57:21",
        "name": "活动策划",
        "owner": "admin",
        "previewImageList": [],
        "scene": [
          "PLANNING",
          "DOCUMENT_COMPOSITION"
        ],
        "shareCnt": 0,
        "status": 1,
        "templateAvailableSkills": [],
        "templateVariables": [
          {
            "creator": "admin",
            "ctime": "2026-08-12T13:57:21",
            "defaultValue": {},
            "description": "支持 Word、PDF、Markdown 文件",
            "id": 549,
            "mtime": "2026-08-12T13:57:21",
            "name": "活动策划方案",
            "required": 1,
            "sortOrder": 0,
            "status": 1,
            "templateId": 186,
            "updatedBy": "admin",
            "valueType": "file",
            "varId": "e7f79b80-871a-4c39-af89-1e6b06931668"
          }
        ],
        "updatedBy": "admin",
        "usedCnt": 0
      }
    ],
    "limit": 30,
    "offset": 0,
    "total": 1
  },
  "msg": {}
}

最近更新时间：2026.08.17 14:12:01

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

请求说明 #

请求参数 #

请求示例 #

返回参数 #

#

返回示例 #

请求说明

请求参数

请求示例

返回参数

返回示例