Alibaba Cloud Model Studio:DeleteChunk

Exclui trechos de texto especificados de uma base de conhecimento. Os trechos de texto excluídos não podem ser recuperados ou evocados.

Descrição da operação

• Requisitos de permissão:

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

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

• Latência efetiva: As alterações geralmente entram em vigor imediatamente. Durante os horários de pico, pode haver um leve atraso (segundos).

• Idempotência: Esta operação é idempotente. Chamadas repetidas para excluir um trecho de texto já excluído retornam uma resposta de sucesso.

Limite de taxa: Esta operação sofre limitação de taxa se for chamada com muita frequência. Não exceda 10 chamadas por segundo. Se sofrer limitação, 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:DeleteChunk	delete	*All Resource *	Nenhuma	Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
WorkspaceId	string	Sim	O ID do workspace da base de conhecimento. Para 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 base de conhecimento, que é o Data.Id retornado pela operação CreateIndex.	79c0alxxxx
ChunkIds	array	Sim	A lista de trechos de texto a serem excluídos. Podem ser especificados no máximo 10 IDs de trechos de texto em uma única solicitação.
	string	Sim	O ID do trecho de texto, que é o campo _id em Metadata do objeto Node retornado pela operação ListChunks.	llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	35A267BF-xxxx-54DB-8394-AA3B0742D833
Code	string	O código de status do erro.
Message	string	A mensagem de erro.
Success	boolean	Indica se a chamada foi bem-sucedida. Valores válidos: true: A chamada foi bem-sucedida. false: A chamada falhou.	true
Data	boolean	Os dados de negócios 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\n",
  "Code": "",
  "Message": "",
  "Success": true,
  "Data": true,
  "Status": "200\n"
}

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.