列出 Wiki 页面

更新时间:
复制 MD 格式

使用 ListWikiPages 接口按路径顺序列出当前已发布的 Wiki 页面元数据。

前提条件

  • 已创建 AgentStorage 实例且状态为 normal,并获取实例访问地址(endpoint)和实例名。

  • 已创建 API Key。

  • Wiki 操作使用完整三段 Agent Scope(appId/tenantId/agentId),每段非空且不能为 *,最长 128 字节,不能包含 /;不要传入 runId。

请求参数

字段

类型

必填

说明

memoryStoreName

string

是

记忆库名称。

scope

object

是

完整三段 Agent Scope,规则与 GetWiki 相同。

limit

int

否

返回数量,默认 50,最大 100。

nextToken

string

否

上一页返回的不透明分页令牌。

请求示例

使用 API Key 认证时,通过 x-ots-instancename 和 x-ots-apikey 请求头传入实例名和 API Key。

curl -X POST https://<endpoint>/ListWikiPages \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant"
  },
  "limit": 20
}'

响应

字段

说明

pages

页面元数据列表,字段见[Wiki 页面对象](./get-wiki-page.md#wiki-页面对象)。列表结果不返回 content。

nextToken

下一页令牌;没有更多页面时省略。

翻页期间即使发布了新构建,后续页面仍属于第一次请求锁定的同一已发布版本。不要修改或解析 nextToken。