Todos os produtos
Search
Central de documentação

EventBridge:SaveAgentDataSemantics

Última atualização: Sep 02, 2026

Salva a semântica de dados para um agente.

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.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

AgentName

string

Sim

O nome do agente.

bakehouse_agent

Metrics

array

Não

O conhecimento de expressão SQL. Se este parâmetro for especificado, o conteúdo atual será salvo. Se este parâmetro não for especificado, o conteúdo existente será limpo. São suportadas no máximo 100 entradas, e o tamanho máximo de cada categoria de conhecimento é de 16 KB.

AgentDataSemanticsMetric

Não

Uma única entrada de conhecimento de expressão SQL.

Joins

array

Não

O conhecimento de associação de dados. Se este parâmetro for especificado, o conteúdo atual será salvo. Se este parâmetro não for especificado, o conteúdo existente será limpo. São suportadas no máximo 100 entradas, e o tamanho máximo de cada categoria de conhecimento é de 16 KB.

AgentDataSemanticsJoin

Não

Uma única entrada de conhecimento de associação de dados.

Examples

array

Não

O conhecimento de exemplo SQL. Se este parâmetro for especificado, o conteúdo atual será salvo. Se este parâmetro não for especificado, o conteúdo existente será limpo. São suportadas no máximo 50 entradas, e o tamanho máximo de cada categoria de conhecimento é de 16 KB.

AgentDataSemanticsExample

Não

Uma única entrada de conhecimento de exemplo SQL.

Text AgentDataSemanticsText

Não

O conhecimento textual em formato Markdown. Se este parâmetro for especificado, o conteúdo atual será salvo. Se este parâmetro não for especificado, o conteúdo existente será limpo. O tamanho máximo de cada categoria de conhecimento é de 16 KB.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Message

string

A mensagem de resposta. Se a chamada falhar, uma mensagem de erro será retornada.

Invalid data semantics request

RequestId

string

O identificador exclusivo que o Alibaba Cloud gera para a solicitação.

5DAF96FB-A4DF-548C-B8A1-F2A8D2F4****

Data

object

O resultado da atualização. Se o salvamento for bem-sucedido, um objeto vazio será retornado sem campos comerciais adicionais. Se nenhuma das quatro categorias de conhecimento for especificada, o estado alvo será com todas as quatro categorias vazias: se existir uma versão atual não vazia, uma versão totalmente vazia será publicada. Se a versão atual já estiver totalmente vazia ou não existir versão atual, a operação será concluída com sucesso de forma idempotente e a rodada atual de resultados de geração pendentes será finalizada.

{}

Code

string

O código de resposta da operação.

Success

Success

boolean

Indica se a chamada foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "Invalid data semantics request.",
  "RequestId": "5DAF96FB-A4DF-548C-B8A1-F2A8D2F4****",
  "Data": {},
  "Code": "Success",
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter Invalid data semantics request.
500 InternalError Internal Server Error
403 ServiceNotEnable Service not enable
403 EventHouseServiceNotEnable EventHouse service not enable
404 AgentNotFound Agent not found.
409 DataSemanticsGenerationRunning Data semantics generation task is already running.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.