Alibaba Cloud Model Studio:UpdateChunk

Modifica o conteúdo e o título de um chunk de texto especificado em uma knowledge base e especifica se o chunk participa da recuperação da knowledge base.

Descrição da operação

• Limites principais: Esta operação suporta apenas knowledge bases de pesquisa de documentos. Knowledge bases de consulta de dados e de Q&A de imagens não são suportadas.

• Requisitos de permissão:

  • Usuário Resource Access Management (RAM): Antes de invocar esta operação, obtenha permissões de API para o Model Studio (você pode usar a política AliyunBailianDataFullAccess, que inclui a permissão sfm:UpdateChunk necessária para esta operação) e ingresse em um workspace.
  • Conta Alibaba Cloud: Possui permissões por padrão e pode invocar esta operação diretamente.

• Método de chamada: Use o SDK do Model Studio mais recente. O SDK fornece encapsulamento da lógica complexa de cálculo de assinatura e simplifica o procedimento de invocação.

• Latência de efetivação: As atualizações normalmente entram em vigor imediatamente. Durante horários de pico, pode ocorrer um leve atraso (segundos).

• Idempotência: Esta operação é idempotente. Se você repetir a operação em um chunk de texto que já foi atualizado, a operação retorna uma resposta de sucesso.

Limite de taxa: Esta operação é limitada se chamada com muita frequência. 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:UpdateChunk	update	*All Resource *	Nenhuma	Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
WorkspaceId	string	Sim	O ID do workspace da knowledge base. Para informações sobre como obter o ID do workspace, consulte Como usar um workspace.	llm-3z7uw7fwz0vexxxx

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PipelineId	string	Sim	O ID da knowledge base. Este é o Data.Id retornado pela operação CreateIndex, ou você pode obtê-lo na página Knowledge Base.	79c0alxxxx
DataId	string	Sim	O ID do arquivo. Este é o FileId retornado pela operação AddFile. Você também pode obtê-lo na aba Application Data - Files no console do Model Studio, clicando no ícone de ID ao lado do arquivo correspondente.	doc_c134aa2073204a5d936d870bf960f56axxxxxxxx
ChunkId	string	Sim	O ID do chunk de texto a ser modificado. Você pode obter este valor chamando a operação ListChunks. O valor está no campo Node.Metadata._id da resposta.	llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0
IsDisplayedChunkContent	boolean	Sim	Especifica se este chunk de texto participa da recuperação da knowledge base. Valores válidos: true: Participa. false: Não participa. Valor padrão: true.	true
content	string	Sim	O novo conteúdo do chunk de texto. O comprimento do conteúdo deve estar entre 10 e 6000 caracteres e não pode exceder o comprimento máximo de segmento especificado quando a knowledge base foi criada.	在哲学中所获得的确定性类型不是科学的确定性(即对每个人的理智来说都一样的确定性)，而是一种要在人类的整体本质中才能获得的亲证。哲学的每一形态都不同于科学，因为所有的哲学都没有得到一致的认可...
title	string	Não	O novo título do chunk de texto. O comprimento é limitado a 0 a 50 caracteres. Uma string vazia é permitida. Se você passar uma string vazia, o título existente será limpo. Se você não passar este parâmetro, o título original será mantido.	什么是哲学

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Schema da resposta.
RequestId	string	O ID da solicitação.	35A267BF-xxxx-54DB-8394-AA3B0742D833
Code	string	O código de status de erro.
Message	string	A mensagem de erro.
Success	boolean	Indica se a operação foi bem-sucedida. Valores válidos: true: Bem-sucedida. false: Falhou.	true
Data	boolean	Os dados de negócio retornados após uma solicitação bem-sucedida.	true
Status	string	O código de status retornado pela operação.	"200"

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833",
  "Code": "",
  "Message": "",
  "Success": true,
  "Data": true,
  "Status": "\"200\""
}

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.