Ingesta por lotes de documentos no estructurados mediante la API AddFile - Model Studio - Alibaba Cloud_Alibaba Cloud Model Studio(Model Studio) - Alibaba Cloud Model Studio

Importa un archivo desde el almacenamiento temporal de Alibaba Cloud Model Studio a una conexión de datos de Alibaba Cloud Model Studio (anteriormente conocida como datos de la aplicación).

Descripción de la operación

Los usuarios de Resource Access Management (RAM) deben obtener primero los permisos de API para Alibaba Cloud Model Studio (requiere AliyunBailianDataFullAccess, que incluye el permiso sfm:AddFile) 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. Invoque esta operación utilizando el último SDK de Alibaba Cloud Model Studio.
Esta operación no es idempotente.

Limitación: Esta operación está sujeta a limitaciones. No exceda 10 llamadas por segundo. Si se le 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

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 acciones o a 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:AddFile	create	Todos los recursos ``	None	None

Acción

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

sfm:AddFile

create

*Todos los recursos

*

None

Sintaxis de la solicitud

PUT /{WorkspaceId}/datacenter/file HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo. El archivo se carga en este espacio de trabajo. Para obtener información sobre cómo conseguir el ID del espacio de trabajo, consulte Cómo usar un espacio de trabajo.	llm-3shx2gu255oqxxxx

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
LeaseId	string	Sí	El ID de concesión de carga, que corresponde al `FileUploadLeaseId` devuelto por la operación ApplyFileUploadLease.	68abd1dea7b6404d8f7d7b9f7fbd332d.17166xxxxxxxx
Parser	string	Sí	El tipo de analizador. Valores válidos: DOCMIND: análisis inteligente de documentos DOCMIND_DIGITAL: análisis de documentos electrónicos DOCMIND_LLM_VERSION: análisis de documentos mediante modelos de lenguaje grande DASH_QWEN_VL_PARSER: análisis VL de Qwen DOCMIND_LLM_VERSION_MEDIA: análisis de audio y video AUTO_SELECT: selección automática de analizador El archivo cargado se analiza utilizando el analizador especificado actualmente. Si establece este parámetro en AUTO_SELECT, se utilizará el analizador configurado para la categoría.	AUTO_SELECT
CategoryId	string	Sí	Establezca este parámetro en el ID de categoría del archivo cargado, que es el `CategoryId` devuelto por la operación AddCategory. También puede ir a Datos de la aplicación, hacer clic en la pestaña File y luego hacer clic en el icono ID junto al nombre de la categoría para obtener el ID de categoría. Puede establecer este parámetro en default para usar la categoría predeterminada creada por el sistema.	cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx
Tags	array	No	La lista de etiquetas asociadas con el archivo. Puede especificar hasta 100 etiquetas, y la longitud total de caracteres de todas las etiquetas no puede exceder 700. Valor predeterminado: vacío, lo que significa que no se han establecido etiquetas.
	string	No	La etiqueta del archivo. Cada etiqueta puede contener hasta 32 caracteres. La etiqueta admite caracteres de la categoría de letras Unicode (incluidas letras en inglés, caracteres chinos y dígitos), guiones bajos (_) y guiones (-).	Introducción al producto
CategoryType	string	No	El tipo de categoría. Este parámetro es opcional. Valor predeterminado: UNSTRUCTURED. Valores válidos: UNSTRUCTURED: categoría utilizada para crear escenarios de base de conocimientos.	UNSTRUCTURED
OriginalFileUrl	string	No	Especifica una URL para el archivo. El sistema registra esta URL al crear una base de conocimientos de búsqueda de documentos. Cuando utiliza la consola de Alibaba Cloud Model Studio para interactuar con una aplicación de agente, esta URL se devuelve con los resultados de recuperación del archivo a través del campo `docUrl`. La aplicación de agente debe tener habilitada la Base de conocimientos y la función Mostrar fuentes de respuesta activada. De lo contrario, este parámetro no surtirá efecto.	www.test.com/111.docx
ParserConfig	object	No	La configuración del analizador. Este parámetro es obligatorio solo cuando el tipo de analizador se establece en análisis VL de Qwen.
ModelName	string	No	El nombre del modelo.	qwen3-vl-plus
ModelPrompt	string	No	El prompt utilizado al llamar al análisis VL de Qwen.	# Rol Eres un anotador profesional de contenido de imágenes, experto en reconocer y describir el contenido de las imágenes. # Objetivo de la tarea Describe detalladamente el contenido de la imagen de entrada.

Elementos de respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta
Code	string	El código de error.	DataCenter.FileTooLarge
Data	object	El campo de datos devuelto por la operación.
FileId	string	El ID del archivo. Mantenga este valor seguro, ya que se utiliza en todas las operaciones de API posteriores relacionadas con este archivo.	file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx
Parser	string	El tipo de analizador utilizado para analizar el archivo. Valores válidos: DASHSCOPE_DOCMIND: Análisis inteligente de documentos de Alibaba Cloud.	DASHSCOPE_DOCMIND
Message	string	El mensaje de error.	Usuario no autorizado para operar en el recurso especificado.
RequestId	string	El ID de la solicitud.	778C0B3B-xxxx-5FC1-A947-36EDD13606AB
Status	string	El código de estado devuelto por la operación.	200
Success	string	Indica si la llamada se realizó correctamente. Valores válidos: true: La llamada se realizó correctamente. false: La llamada falló.	true

Ejemplos

Respuesta exitosa

Formato JSON

{
  "Code": "DataCenter.FileTooLarge",
  "Data": {
    "FileId": "file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx",
    "Parser": "DASHSCOPE_DOCMIND"
  },
  "Message": "User not authorized to operate on the specified resource.",
  "RequestId": "778C0B3B-xxxx-5FC1-A947-36EDD13606AB",
  "Status": "200",
  "Success": "true"
}

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.