Alibaba Cloud Model Studio:UpdateChunk

Modifica el contenido y el título de un fragmento de texto específico en una base de conocimientos, y especifica si el fragmento participa en la recuperación de la base de conocimientos.

Descripción de la operación

• Límites clave: Esta operación solo admite bases de conocimientos de búsqueda de documentos. No se admiten bases de conocimientos de consulta de datos ni de preguntas y respuestas sobre imágenes.

• Requisitos de permisos:

  • Usuario de Resource Access Management (RAM): Antes de invocar esta operación, obtenga permisos de API para Model Studio (puede usar la política AliyunBailianDataFullAccess, que incluye el permiso sfm:UpdateChunk requerido por esta operación) y únase a un espacio de trabajo.
  • Cuenta de Alibaba Cloud: Tiene permisos de forma predeterminada y puede invocar esta operación directamente.

• Método de llamada: Utilice la versión más reciente del SDK de Model Studio. El SDK proporciona encapsulación de lógica compleja de cálculo de firmas y simplifica el procedimiento de invocación.

• Latencia efectiva: Las actualizaciones suelen surtir efecto de inmediato. Durante las horas pico, puede producirse un ligero retraso (segundos).

• Idempotencia: Esta operación es idempotente. Si repite la operación en un fragmento de texto que ya ha sido actualizado, la operación devuelve una respuesta de éxito.

Límite de velocidad: Esta operación se limita si se llama con demasiada frecuencia. No exceda las 10 llamadas por segundo. Si se aplica la limitación, 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

La siguiente tabla describe la autorización necesaria para llamar a esta API. Puede definirla en una política de Resource Access Management (RAM). Las columnas de la tabla se detallan a continuación:

• Action: Las acciones se pueden utilizar en el elemento Action de las declaraciones de políticas de permisos de RAM para otorgar permisos para realizar la operación.

• API: La API que puede llamar para realizar la acción.

• Nivel de acceso: El nivel de acceso predefinido otorgado para cada API. Valores válidos: create, list, get, update y delete.

• Tipo de recurso: El tipo de recurso que admite la autorización para realizar la acción. Indica si la acción admite permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción. De lo contrario, la política será ineficaz.

  • Para las API con permisos a nivel de recurso, los tipos de recursos requeridos están marcados con un asterisco (*). Especifique el Nombre de recurso de Alibaba Cloud (ARN) correspondiente en el elemento Resource de la política.
  • Para las API sin permisos a nivel de recurso, se muestra como Todos los recursos. Utilice un asterisco (*) en el elemento Resource de la política.

• Clave de condición: Las claves de condición definidas por el servicio. La clave permite un control granular, aplicándose ya sea solo a las acciones o a las acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de claves de condición comunes aplicables a todos los servicios compatibles con RAM.

• Acción dependiente: Las acciones dependientes necesarias para ejecutar la acción. Para completar la acción, el usuario de RAM o el rol de RAM debe tener los permisos para realizar todas las acciones dependientes.

Acción	Nivel de acceso	Tipo de recurso	Clave de condición	Acción dependiente
sfm:UpdateChunk	update	*Todos los recursos *	None	None

Sintaxis de la solicitud

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

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo de la base de conocimientos. Para obtener información sobre cómo conseguir el ID del espacio de trabajo, consulte Cómo usar un espacio de trabajo.	llm-3z7uw7fwz0vexxxx

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
PipelineId	string	Sí	El ID de la base de conocimientos. Este es el Data.Id devuelto por la operación CreateIndex, o puede obtenerlo desde la página Base de conocimientos.	79c0alxxxx
DataId	string	Sí	El ID del archivo. Este es el FileId devuelto por la operación AddFile. También puede obtenerlo desde la pestaña Datos de la aplicación - Archivos en la consola de Model Studio haciendo clic en el icono de ID junto al archivo correspondiente.	doc_c134aa2073204a5d936d870bf960f56axxxxxxxx
ChunkId	string	Sí	El ID del fragmento de texto a modificar. Puede obtener este valor llamando a la operación ListChunks. El valor se encuentra en el campo Node.Metadata._id de la respuesta.	llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0
IsDisplayedChunkContent	boolean	Sí	Especifica si este fragmento de texto participa en la recuperación de la base de conocimientos. Valores válidos: true: Participa. false: No participa. Valor predeterminado: true.	true
content	string	Sí	El nuevo contenido del fragmento de texto. La longitud del contenido debe estar entre 10 y 6000 caracteres y no puede exceder la longitud máxima de segmento especificada al crear la base de conocimientos.	El tipo de certeza alcanzado en filosofía no es certeza científica (es decir, certeza que aplica igual para toda mente racional), sino una especie de atestiguación que solo puede obtenerse dentro de la esencia completa del ser humano. Toda forma de filosofía difiere de la ciencia, porque ninguna filosofía ha recibido reconocimiento unánime...
title	string	No	El nuevo título del fragmento de texto. La longitud está limitada a entre 0 y 50 caracteres. Se permite una cadena vacía. Si pasa una cadena vacía, se borra el título existente. Si no pasa este parámetro, se conserva el título original.	Qué es la filosofía

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.
Message	string	El mensaje de error.
Success	boolean	Indica si la operación fue exitosa. Valores válidos: true: Exitoso. false: Fallido.	true
Data	boolean	Los datos comerciales devueltos tras una solicitud exitosa.	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": "InvalidParameter\n",
  "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.