Skip to main content

AddChunk

Ajoute des fragments à une base de connaissances de type recherche de documents (document), requête de données (table) ou questions-réponses sur images (image).

Description de l'opération

  • Cette opération ajoute le contenu d'un fragment à une base de connaissances spécifiée de type recherche de documents (document), requête de données (table) ou questions-réponses sur images (image). Les opérations associées sur les bases de connaissances de recherche multimédia (multimedia) ne sont pas prises en charge. Pour les bases de connaissances de requête de données et de questions-réponses sur images, cette opération ne prend effet que lorsque la source de données est un connecteur de feuille de calcul (excel).
  • Les utilisateurs Resource Access Management (RAM) doivent d'abord obtenir les autorisations d'API pour Model Studio (nécessitant AliyunBailianDataFullAccess, qui inclut l'autorisation sfm:ChunkList) et rejoindre un espace de travail avant d'appeler cette opération. Les comptes Alibaba Cloud peuvent appeler cette opération directement sans autorisation. Utilisez la dernière version du SDK Model StudioSDK Model Studio pour appeler cette opération.
  • Avant d'appeler cette opération, assurez-vous que votre base de connaissances a été créée et n'a pas été supprimée (c'est-à-dire que l'identifiant de la base de connaissances IndexId est valide).
  • Cette opération est idempotente.
Limitation du débit : Cette opération est limitée si elle est appelée trop fréquemment. Ne dépassez pas 10 appels par seconde. En cas de limitation, réessayez ultérieurement.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Syntaxe de la requête

POST /{WorkspaceId}/chunk/create HTTP/1.1

Paramètres de chemin

Paramètre

Type

Requis

Description

Exemple

WorkspaceId

string

Oui

L'identifiant de l'espace de travail.

llm-19hxxxxx7htdf9lh

Paramètres de requête

ParamètreTypeRequisDescriptionExemple
PipelineIdstringOuiL'identifiant de la base de connaissances.79c0alxxxx
dataIdstringNonL'identifiant du fichier.doc_xxx
fieldobjectNonLe contenu du fragment à insérer, transmis sous forme de paires clé-valeur. Pour les bases de connaissances de recherche de documents, utilisez la liste de clés fixes suivante :
  • content (String) : Obligatoire. Le contenu principal du fragment.
  • title (String) : Facultatif. Le titre du fragment.
  • image_urls (Array) : Facultatif. Les URL des images incluses dans le fragment. Un maximum de 10 images est pris en charge.
Pour les bases de connaissances de requête de données et de questions-réponses sur images, les clés ne sont pas fixes et sont déterminées par la feuille de calcul source de la base de connaissances. La clé correspond à l'en-tête de colonne Excel et la valeur à la valeur de colonne correspondante.
{
  "content": "La plateforme Bailian prend en charge l'analyse de plusieurs formats de documents, notamment PDF, Word et PPT.",
  "title": "Analyse et fragmentation de documents",
  "image_urls": [
"https://example.com/images/chunk-flow.png",
  "https://example.com/images/parsing-result.png"
  ]
}
anyNonLes informations de champ d'en-tête pour le fragment inséré. Seules les bases de connaissances de requête de données et de questions-réponses sur images sont prises en charge. Les en-têtes qui participent à la récupération ou à la génération de réponses sont obligatoires. Exigences de valeur pour chaque type :
  • String : Longueur maximale de 6 000.
  • Time : Horodatage à 13 chiffres (millisecondes).
  • Long : Entier. Valeur maximale : 2147483647.
  • Double : Les valeurs décimales sont prises en charge.
  • image_url : Un maximum de 5 images. Concaténez plusieurs URL en une seule chaîne séparée par des virgules.
{"Nom du produit": "Écouteurs Bluetooth sans fil",
 "Heure de publication": 1752624000000,
 "Quantité en stock": 1580,
"Prix unitaire": 299.99,
"image_url":"https://example.com/images/headphones-front.jpg,https://example.com/images/headphones-side.jpg,https://example.com/images/headphones-package.jpg"
}

Éléments de réponse

ÉlémentTypeDescriptionExemple
objectSchéma de la réponse.
RequestIdstringL'identifiant de la requête.35A267BF-xxxx-54DB-8394-AA3B0742D833
CodestringLe code d'état de l'erreur.Index.InvalidParameter
MessagestringLe message d'erreur.Paramètre requis (%s) manquant ou invalide, veuillez vérifier les paramètres de la requête
SuccessbooleanIndique si l'opération a réussi.Valeurs valides :
  • true : true.
  • false : false.
true
DatabooleanLes données métier renvoyées en cas de requête réussie.Valeurs valides :
  • true : true.
  • false : false.
true
StatusstringLe code d'état renvoyé par l'opération.200

Exemples

正常返回示例 JSON format
{
  "RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833",
  "Code": "Index.InvalidParameter",
  "Message": "Required parameter(%s) missing or invalid, please check the request parameters.",
  "Success": true,
  "Data": true,
  "Status": "200"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.