AddChunk_Alibaba Cloud Model Studio(Model Studio) - Alibaba Cloud Model Studio

Agrega fragmentos a una base de conocimientos de búsqueda de documentos (documento), consulta de datos (tabla) o preguntas y respuestas sobre imágenes (imagen).

Descripción de la operación

Esta operación agrega contenido de fragmento a una base de conocimientos especificada del tipo búsqueda de documentos (documento), consulta de datos (tabla) o preguntas y respuestas de imágenes (imagen). No se admiten operaciones relacionadas en bases de conocimientos de búsqueda multimedia (multimedia). Para bases de conocimientos de consulta de datos y preguntas y respuestas de imágenes, esta operación solo surte efecto cuando el origen de datos es un conector de hoja de cálculo (excel).
Los usuarios de Resource Access Management (RAM) deben obtener primero los permisos de API para Model Studio (requiere AliyunBailianDataFullAccess, que incluye el permiso sfm:ChunkList) y unirse a un espacio de trabajo antes de invocar esta operación. Las cuentas de Alibaba Cloud pueden invocar esta operación directamente sin autorización. Utilice la versión más reciente del SDK de Model Studio SDK de Model Studio para invocar esta operación.
Antes de invocar esta operación, asegúrese de que su base de conocimientos se haya creado y no se haya eliminado (es decir, que el ID de la base de conocimientos IndexId sea válido).
Esta operación tiene idempotencia.

Limitación: Esta operación se limita si se llama con demasiada frecuencia. No exceda las 10 llamadas por segundo. Si se limita, reinténtelo más tarde.

Probar ahora

Pruebe esta API en OpenAPI Explorer; no es necesaria la firma manual. Las llamadas exitosas generan automáticamente código SDK que coincide con sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Prueba

Autorización de RAM

No hay autorización para esta operación. Si encuentra problemas con esta operación, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

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

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo.	llm-19hxxxxx7htdf9lh

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
PipelineId	string	Sí	El ID de la base de conocimientos.	79c0alxxxx
dataId	string	No	El ID del archivo.	doc_xxx
field	object	No	El contenido del fragmento a insertar, pasado como pares clave-valor. Para bases de conocimientos de búsqueda de documentos, utilice la siguiente lista de claves fijas: content (String): Obligatorio. El contenido del cuerpo del fragmento. title (String): Opcional. El título del fragmento. image_urls (Array): Opcional. URL de imágenes incluidas en el fragmento. Se admite un máximo de 10 imágenes. Para bases de conocimientos de consulta de datos y preguntas y respuestas de imágenes, las claves no son fijas y están determinadas por la hoja de cálculo de origen de datos de la base de conocimientos. La clave es el encabezado de la columna de Excel y el valor es el valor correspondiente de la columna.	{ "content": "The Bailian platform supports parsing multiple document formats including PDF, Word, and PPT.", "title": "Document Parsing and Chunking", "image_urls": [ "https://example.com/images/chunk-flow.png", "https://example.com/images/parsing-result.png" ] }
	any	No	La información del campo de encabezado para el fragmento insertado. Solo se admiten bases de conocimientos de consulta de datos y preguntas y respuestas de imágenes. Los encabezados que participan en la recuperación o generación de respuestas son obligatorios. Requisitos de valor para cada tipo: String: Longitud máxima de 6000. Time: Marca de tiempo de 13 dígitos (milisegundos). Long: Entero. Valor máximo: 2147483647. Double: Se admiten valores decimales. image_url: Un máximo de 5 imágenes. Concatene varias URL en una sola cadena separada por comas.	{"Product Name": "Wireless Bluetooth Headphones", "Publish Time": 1752624000000, "Stock Quantity": 1580, "Unit Price": 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" }

Elementos de respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta
RequestId	string	El ID de la solicitud.	35A267BF-xxxx-54DB-8394-AA3B0742D833
Code	string	El código de estado de error.	Index.InvalidParameter
Message	string	El mensaje de error.	Falta el parámetro obligatorio (%s) o no es válido; compruebe los parámetros de la solicitud.
Success	boolean	Indica si la operación fue exitosa. Valores válidos: true : true false : false	true
Data	boolean	Los datos comerciales devueltos tras una solicitud exitosa. Valores válidos: true : true false : false	true
Status	string	El código de estado devuelto por la operación.	200

Ejemplos

Respuesta exitosa

Formato JSON

{
  "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"
}

Códigos de error

Consulte Códigos de error para obtener una lista completa.

Notas de lanzamiento

Consulte Notas de lanzamiento para obtener una lista completa.