Tablestore:Knowledge compilation (Wiki)

Prerequisites

A memory store has been created (any input type is acceptable; a Wiki belongs to one memory store plus a three-part Agent Scope).

Resource boundaries

Each Wiki uniquely belongs to one memory store and a three-part Agent Scope:

memoryStoreName + appId / tenantId / agentId

• Wiki does not use runId; different sessions of the same Agent share one Wiki.

• When you call GetWiki, the service automatically retrieves or creates the Wiki for that Scope, and no wikiId, build ID, or task ID is required.

• All three fields are required, are at most 128 bytes each, must not contain /, and do not allow the wildcard *.

Supported source files

Binary files use standard Base64; the extension, mediaType, and file signature must be consistent.

Query Wiki

Retrieve or create the Wiki for the current Agent Scope and view the latest build status. The first call automatically creates the Wiki.

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

wiki = client.ots_client.request("GetWiki", {
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
})
print(f"Status: {wiki.get('status')}, Pages: {wiki.get('pageCount')}, Pending: {wiki.get('hasPendingChanges')}")

Build Wiki

Asynchronously compiles the source files under /.wiki/raw/ into a new set of pages and atomically publishes them.

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

# 1. Write the source file (for AddItem, see the "File memory" document)
client.add_item({
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
    "path": "/.wiki/raw/product/payment.md",
    "content": "# Payment notes\n\nPayment callbacks must validate the idempotency key.",
})

# 2. Start the build
resp = client.ots_client.request("IngestWiki", {
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
    "clientToken": "wiki-build-001",
})
print(resp)

IngestWiki is an asynchronous operation. The same clientToken can be used for safe retries. In the response, reused indicates that the same build was reused, and skipped indicates that the sources have not changed and no rebuild is needed.

Common build statuses are as follows:

List pages

Paginate the metadata of published pages in path order.

• Pages are available for listing only after a build has been published; if no build has been performed, a resource-not-found error is returned.

• limit defaults to 50 and has a maximum of 100. Do not parse or modify nextToken; during pagination, pages are locked to the same published version.

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

resp = client.ots_client.request("ListWikiPages", {
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
    "limit": 50,
})
for p in resp.get("pages", []):
    print(p.get("path"), p.get("title"))

Read page

Read the full body of a published page by path.

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

resp = client.ots_client.request("GetWikiPage", {
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
    "path": "/wiki/payment-callback.md",
})
print(resp.get("content"))

Search pages

Perform a semantic search over published pages using natural language; returns the path, title, summary, and score of matching pages.

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

resp = client.ots_client.request("SearchWikiPages", {
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
    "query": "How do payment callbacks ensure idempotency",
    "limit": 5,
})
for p in resp.get("pages", []):
    print(f"[{p.get('score')}] {p.get('path')} - {p.get('title')}")

Update Wiki

Update the display name or summary of a Wiki.

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

client.ots_client.request("UpdateWiki", {
    "memoryStoreName": "agent_memory",
    "scope": {"appId": "app-001", "tenantId": "user-001", "agentId": "assistant"},
    "name": "Payment and reconciliation Wiki",
    "summary": "Covers payment callbacks, reconciliation, and idempotency conventions",
})

Build quality and limits

GetWiki.latestBuild.quality provides metrics such as source coverage, page citation status, and link quality to help determine whether pages need manual spot-checking. A successful build does not mean that every source is fully represented, nor that all facts have been business-validated.

Related documents

• Memory store management

• File memory

• Memory Dream