Utilisez l'opération ListWikiPages pour répertorier les métadonnées des pages Wiki publiées, triées par ordre de chemin.
Prérequis
Vous avez créé une instance AgentStorage dont le statut est
normal, et vous disposez du endpoint et du nom de l'instance.Vous avez créé une clé API.
Les opérations Wiki utilisent le Agent Scope complet à trois segments (
appId/tenantId/agentId). Chaque segment doit être non vide, différent de*, d'une longueur maximale de 128 octets et ne doit pas contenir/. Ne transmettez pasrunId.
Paramètres de la requête
|
Champ |
Type |
Obligatoire |
Description |
|
|
string |
Oui |
Nom du magasin de mémoire. |
|
|
object |
Oui |
Agent Scope complet à trois segments. Les règles sont identiques à celles de |
|
|
int |
Non |
Nombre d'entrées à renvoyer. Valeur par défaut : 50. Valeur maximale : 100. |
|
|
string |
Non |
Jeton de pagination opaque renvoyé par la page précédente. |
Exemple de requête
Pour l'authentification par clé API, transmettez le nom de l'instance et la clé API via les en-têtes de requête x-ots-instancename et x-ots-apikey.
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
}'
Réponse
|
Champ |
Description |
|
|
Liste des métadonnées des pages. Pour la description des champs, consultez l'objet de page Wiki. La liste ne renvoie pas le champ |
|
|
Jeton pour la page suivante. Absent s'il n'y a plus de pages. |
Même si une nouvelle version est publiée pendant la pagination, les pages suivantes appartiennent toujours à la même version publiée, verrouillée par la première requête. Ne modifiez ni n'analyse nextToken.