Tablestore:Build Wiki

Prérequis

• Vous avez créé une instance AgentStorage dont l'état est normal, et vous disposez du nom de l'instance ainsi que de son endpoint.

• Vous avez créé une clé API.

• Les opérations Wiki utilisent le périmètre Agent Scope complet à trois segments (appId/tenantId/agentId). Chaque segment doit être non vide, différent de *, ne pas contenir / et avoir une longueur maximale de 128 octets. Ne transmettez pas runId.

• Les sources sont stockées dans le répertoire /.wiki/raw/ associé à un memoryStoreName spécifique et à un périmètre Agent Scope à trois segments. Les téléchargements et les générations utilisent les mêmes valeurs pour appId, tenantId et agentId, et omettent runId.

Les fichiers source du Wiki sont écrits dans le répertoire /.wiki/raw/ décrit ci-dessus via l'opération AddItem en utilisant le même périmètre Agent Scope à trois segments que pour la génération et en omettant runId. Il s'agit d'une exception à la règle de périmètre pour les opérations sur les fichiers ; les autres opérations sur les fichiers nécessitent le périmètre complet à quatre segments (incluant runId). Pour plus d'informations, consultez la section Créer un fichier. Exemple de téléchargement :

{
  "type": "memoryfile",
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant"
  },
  "path": "/.wiki/raw/payment-spec.md",
  "content": "# Payment rules\nA refund requires the order number.\n"
}

Paramètres de requête

Le paramètre dreamActionRefs prend effet uniquement pour cette génération. Les références doivent appartenir au même magasin de mémoire et au même Agent, et correspondre à des artefacts Skill ou Profile appliqués et toujours valides ; les références en double sont rejetées.

Exemple de requête

Lors de l'utilisation de 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>/IngestWiki \
  -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"
  },
  "clientToken": "payment-wiki-20260904"
}'

Réponse

{
  "status": "pending",
  "reused": false,
  "skipped": false
}

La génération est un processus asynchrone. Une fois lancée, interrogez régulièrement le champ latestBuild.status renvoyé par GetWiki jusqu'à ce qu'il passe à ready ou échoue. Si aucune source n'est disponible, une erreur 400 VALIDATION_ERROR est renvoyée.