UpdateChunks: update chunks - Tablestore - Centre de documentation Alibaba Cloud

Prérequis

Une instance AgentStorage est créée et se trouve dans l'état normal. Vous disposez du nom et de l'endpoint de l'instance.
Une clé API est créée.
La base de connaissances et le document auxquels appartiennent les chunks à mettre à jour existent déjà.

Paramètres de la requête

Paramètre

Type

Description

knowledgeBaseName

string

Nom de la base de connaissances. Obligatoire.

subspace

string

Nom du subspace. Obligatoire si le subspace est activé.

chunks

list of objects

Liste des chunks à mettre à jour. Obligatoire. Maximum de 10 chunks par requête.

chunks[].docId

string

ID du document. Spécifiez ce paramètre ou ossKey.

chunks[].ossKey

string

Chemin OSS. Spécifiez ce paramètre ou docId.

chunks[].chunkId

int

ID du chunk. Obligatoire.

chunks[].title

string

Nouveau titre. Maximum de 100 tokens.

chunks[].content

string

Nouveau contenu. Le maximum par défaut est de 512 tokens, calculé par le serveur. Si l'instance possède une configuration de quota distincte, celle-ci prévaut.

chunks[].status

string

Nouvel état : active (récupérable) ou inactive (non récupérable).

Exemple de requête

Pour l'authentification par clé API, transmettez le nom de l'instance et la clé API dans les en-têtes de requête x-ots-instancename et x-ots-apikey.

curl -X POST https://<endpoint>/UpdateChunks \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "knowledgeBaseName": "product_docs_kb",
  "subspace": "default",
  "chunks": [
    {"ossKey": "oss://example-bucket/docs/manual.pdf", "chunkId": 0, "status": "inactive"},
    {"ossKey": "oss://example-bucket/docs/manual.pdf", "chunkId": 1, "title": "Updated title", "content": "Updated content"}
  ]
}'

Réponse

Champ

Type

Description

updateDetails[].docId

string

ID du document.

updateDetails[].ossKey

string

Chemin OSS.

updateDetails[].chunkId

int

ID du chunk.

updateDetails[].updateStatus

string

Valeurs valides : succeed ou failed.

updateDetails[].failureReason

string

Motif de l'échec. Renvoyé uniquement lorsque l'état est failed.