Skip to main content
Conexão de dados (anteriormente dados de aplicativo)

AddFile

Importa um arquivo do armazenamento temporário do Alibaba Cloud Model Studio para uma conexão de dados do Alibaba Cloud Model Studio (anteriormente conhecida como dados de aplicativo).

Descrição da operação

  • Os usuários do Resource Access Management (RAM) devem primeiro obter permissões de API para o Alibaba Cloud Model Studio (requer AliyunBailianDataFullAccess, que inclui a permissão sfm:AddFile) e ingressar em um workspace antes de invocar esta operação. Contas Alibaba Cloud podem invocar esta operação diretamente sem autorização. Invoque esta operação usando a versão mais recente do SDK do Alibaba Cloud Model Studio.
  • Esta operação não é idempotente.
Limitação de taxa: Esta operação está sujeita a limitação de taxa. Não exceda 10 chamadas por segundo. Se você for limitado, tente novamente mais tarde.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:
  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
  • API: A API que você pode chamar para executar a ação.
  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

sfm:AddFile

create

*全部资源

*

NenhumaNenhuma

Sintaxe da solicitação 

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

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

WorkspaceId

string

Sim

O ID do workspace. O arquivo é enviado para este workspace. Para obter informações sobre como obter o ID do workspace, consulte Como usar um workspace.

llm-3shx2gu255oqxxxx

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

LeaseId

string

Sim

O ID da concessão de upload, que corresponde ao FileUploadLeaseId retornado pela operação ApplyFileUploadLease.

68abd1dea7b6404d8f7d7b9f7fbd332d.17166xxxxxxxx

Parser

string

Sim

O tipo de parser. Valores válidos:

  • DOCMIND: parsing inteligente de documentos

  • DOCMIND_DIGITAL: parsing de documentos eletrônicos

  • DOCMIND_LLM_VERSION: parsing de documentos por modelo de linguagem grande

  • DASH_QWEN_VL_PARSER: parsing Qwen VL

  • DOCMIND_LLM_VERSION_MEDIA: parsing de áudio e vídeo

  • AUTO_SELECT: seleção automática de parser

O arquivo enviado é processado usando o parser especificado atualmente. Se você definir este parâmetro como AUTO_SELECT, o parser configurado para a categoria será usado.

AUTO_SELECT

CategoryId

string

Sim

Defina este parâmetro como o ID da categoria do arquivo enviado, que é o CategoryId retornado pela operação AddCategory. Você também pode acessar Dados de Aplicativo, clicar na aba Arquivo e, em seguida, clicar no ícone de ID ao lado do nome da categoria para obter o ID da categoria. Você pode definir este parâmetro como default para usar a categoria padrão criada pelo sistema.

cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx

Tags

array

Não

  • A lista de tags associadas ao arquivo. Você pode especificar até 100 tags, e o comprimento total de caracteres de todas as tags não pode exceder 700.

  • Valor padrão: vazio, o que significa que nenhuma tag está definida.

string

Não

A tag do arquivo. Cada tag pode conter até 32 caracteres. A tag suporta caracteres da categoria de letras Unicode (incluindo letras em inglês, caracteres chineses e dígitos), sublinhados (_) e hifens (-).

产品介绍

CategoryType

string

Não

O tipo de categoria. Este parâmetro é opcional. Valor padrão: UNSTRUCTURED. Valores válidos:

  • UNSTRUCTURED: categoria usada para cenários de construção de base de conhecimento.

UNSTRUCTURED

OriginalFileUrl

string

Não

Especifica uma URL para o arquivo. O sistema registra esta URL ao construir uma base de conhecimento de pesquisa de documentos. Quando você usa o console do Alibaba Cloud Model Studio para interagir com um aplicativo de agente, esta URL é retornada com os resultados de recuperação do arquivo através do campo docUrl.

O aplicativo de agente deve ter a Base de Conhecimento ativada e o recurso Mostrar fontes das respostas habilitado. Caso contrário, este parâmetro não terá efeito.

www.test.com/111.docx

ParserConfig

object

Não

A configuração do parser. Este parâmetro é necessário apenas quando o tipo de parser está definido como parsing Qwen VL.

ModelName

string

Não

O nome do modelo.

qwen-vl-max

ModelPrompt

string

Não

O prompt usado ao chamar o parsing Qwen VL.

#角色 你是一个专业的图片内容标注人员，擅长识别并描述出图片中的内容。 # 任务目标 请结合输入图片，详细描述图片中的内容。

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

Code

string

O código de erro.

DataCenter.FileTooLarge

Data

object

O campo de dados retornado pela operação.

FileId

string

O ID do arquivo. Mantenha este valor seguro, pois ele é usado em todas as operações de API subsequentes relacionadas a este arquivo.

file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx

Parser

string

O tipo de parser usado para processar o arquivo. Valores válidos:

  • DASHSCOPE_DOCMIND: Parsing inteligente de documentos do Alibaba Cloud.

DASHSCOPE_DOCMIND

Message

string

A mensagem de erro.

User not authorized to operate on the specified resource.

RequestId

string

O ID da solicitação.

778C0B3B-xxxx-5FC1-A947-36EDD13606AB

Status

string

O código de status retornado pela operação.

200

Success

string

Indica se a chamada foi bem-sucedida. Valores válidos:

  • true: A chamada foi bem-sucedida.

  • false: A chamada falhou.

true

Exemplos

Resposta de sucesso JSON formato 
{
  "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 erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.
Chamada de Aplicação
Componentes do aplicativo
Assistant API (Deprecated)
Mais