Knowledge Retrieval - Retrieve

Serviço:: Search Service

Versão da API:: 2026-05-01-preview

A KnowledgeBase recupera dados relevantes de armazenamentos de backup.

POST {endpoint}/knowledgebases('{knowledgeBaseName}')/retrieve?api-version=2026-05-01-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string (uri)	A URL do ponto de extremidade do serviço de pesquisa.
knowledgeBaseName	path	True	string	O nome da base de conhecimento.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Cabeçalho do Pedido

Name	Tipo	Description
Accept	Accept	O cabeçalho Aceitar.
x-ms-query-source-authorization	string	Token que identifica o usuário para o qual a consulta está sendo executada. Este token é usado para impor restrições de segurança em documentos.
x-ms-client-request-id	string (uuid)	Um identificador de cadeia de caracteres opaco, globalmente exclusivo e gerado pelo cliente para a solicitação.

Corpo do Pedido

Name	Tipo	Description
includeActivity	boolean	Indica que os resultados da recuperação devem incluir informações sobre a atividade.
intents	KnowledgeRetrievalIntent[]: KnowledgeRetrievalSemanticIntent[]	Uma lista de consultas pretendidas a serem executadas sem planejamento de consulta de modelo.
knowledgeSourceParams	KnowledgeSourceParams[]: AzureBlobKnowledgeSourceParams[] FabricDataAgentKnowledgeSourceParams[] FabricOntologyKnowledgeSourceParams[] FileKnowledgeSourceParams[] IndexedOneLakeKnowledgeSourceParams[] IndexedSharePointKnowledgeSourceParams[] IndexedSqlKnowledgeSourceParams[] McpServerKnowledgeSourceParams[] RemoteSharePointKnowledgeSourceParams[] SearchIndexKnowledgeSourceParams[] WebKnowledgeSourceParams[] WorkIQKnowledgeSourceParams[]	Uma lista de parâmetros de tempo de execução para as fontes de conhecimento.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos na saída.
maxOutputSize	integer (int32)	Limita o tamanho máximo do conteúdo na saída.
maxOutputSizeInTokens	integer (int32)	Limita o tamanho máximo do conteúdo na saída.
maxRuntimeInSeconds	integer (int32)	O tempo de execução máximo em segundos.
messages	KnowledgeBaseMessage[]	Uma lista de entrada de estilo de mensagem de chat.
outputMode	KnowledgeRetrievalOutputMode	A configuração de saída para essa recuperação.
retrievalReasoningEffort	KnowledgeRetrievalReasoningEffort: KnowledgeRetrievalLowReasoningEffort KnowledgeRetrievalMediumReasoningEffort KnowledgeRetrievalMinimalReasoningEffort	A configuração do esforço de raciocínio de recuperação.

Respostas

Name	Tipo	Description
200 OK	KnowledgeBaseRetrievalResponse	Resposta de recolha bem-sucedida.
Other Status Codes	KnowledgeBaseRetrievalResponse	Resposta parcial de recuperação.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

api-key

Tipo: apiKey
Em: header

OAuth2Auth

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Âmbitos

Name	Description
https://search.azure.com/.default

Exemplos

KnowledgeBaseRetrieve

KnowledgeBaseRetrieveWithIntents

KnowledgeBaseRetrieve

Pedido de amostra

HTTP

POST https://previewexampleservice.search.windows.net/knowledgebases('base-preview-test')/retrieve?api-version=2026-05-01-preview



{
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "text": "hello world",
          "type": "text"
        }
      ]
    }
  ],
  "maxRuntimeInSeconds": 60,
  "maxOutputSize": 100000,
  "maxOutputDocuments": 50,
  "retrievalReasoningEffort": {
    "kind": "low"
  },
  "includeActivity": true,
  "outputMode": "answerSynthesis",
  "knowledgeSourceParams": [
    {
      "filterAddOn": "foo eq bar",
      "knowledgeSourceName": "ks-preview-test",
      "includeReferences": true,
      "includeReferenceSourceData": true,
      "alwaysQuerySource": false,
      "failOnError": false,
      "rerankerThreshold": 2.1,
      "kind": "searchIndex"
    }
  ]
}

Resposta da amostra

Código de estado:: 200

{
  "response": [
    {
      "content": [
        {
          "type": "text",
          "text": "[{...}]"
        }
      ]
    }
  ],
  "activity": [
    {
      "type": "modelQueryPlanning",
      "id": 0,
      "inputTokens": 11,
      "outputTokens": 22,
      "elapsedMs": 10
    },
    {
      "type": "searchIndex",
      "id": 1,
      "knowledgeSourceName": "ks-preview-test",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 2,
      "elapsedMs": 1234,
      "warning": "6 additional documents were dropped because rerankerThreshold filtered them out during reranking. Adjust the threshold if higher recall is desired.",
      "searchIndexArguments": {
        "search": "hello world",
        "filter": "foo eq bar",
        "sourceDataFields": [
          {
            "name": "category"
          },
          {
            "name": "description"
          },
          {
            "name": "ownerId"
          },
          {
            "name": "id"
          }
        ],
        "searchFields": [],
        "semanticConfigurationName": "testconfig"
      }
    },
    {
      "type": "searchIndex",
      "id": 2,
      "knowledgeSourceName": "ks-preview-test",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 2,
      "elapsedMs": 1234,
      "searchIndexArguments": {
        "search": "hello world two",
        "filter": "foo eq bar",
        "sourceDataFields": [
          {
            "name": "category"
          },
          {
            "name": "description"
          },
          {
            "name": "ownerId"
          },
          {
            "name": "id"
          }
        ],
        "searchFields": [],
        "semanticConfigurationName": "testconfig"
      }
    },
    {
      "type": "agenticReasoning",
      "id": 3,
      "retrievalReasoningEffort": {
        "kind": "low"
      },
      "reasoningTokens": 74
    },
    {
      "type": "modelAnswerSynthesis",
      "id": 4,
      "inputTokens": 664,
      "outputTokens": 1328,
      "elapsedMs": 10
    }
  ],
  "references": [
    {
      "type": "searchIndex",
      "id": "83dd7d40",
      "activitySource": 1,
      "sourceData": {
        "id": "myDocKey1",
        "title": "high_doc",
        "content": "hello world"
      },
      "rerankerScore": 3.5,
      "docKey": "myDocKey1"
    },
    {
      "type": "searchIndex",
      "id": "83dd7d41",
      "activitySource": 1,
      "sourceData": {
        "id": "myDocKey2",
        "title": "low_doc",
        "content": "goodbye world"
      },
      "rerankerScore": 2.7,
      "docKey": "myDocKey2"
    }
  ],
  "responseSensitivityLabelInfo": {
    "displayName": "Confidential",
    "sensitivityLabelId": "00000000-0000-0000-0000-000000000001",
    "toolTip": "This content is confidential.",
    "priority": 2,
    "color": "#FF0000",
    "isEncrypted": false
  }
}

Código de estado:: 206

{
  "response": [
    {
      "content": [
        {
          "type": "text",
          "text": "[{...}]"
        }
      ]
    }
  ],
  "activity": [
    {
      "type": "modelQueryPlanning",
      "id": 0,
      "inputTokens": 11,
      "outputTokens": 22,
      "elapsedMs": 10
    },
    {
      "type": "searchIndex",
      "id": 1,
      "knowledgeSourceName": "ks-preview-test",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 2,
      "elapsedMs": 1234,
      "searchIndexArguments": {
        "search": "hello world",
        "filter": "foo eq bar",
        "sourceDataFields": [
          {
            "name": "category"
          },
          {
            "name": "description"
          },
          {
            "name": "ownerId"
          },
          {
            "name": "id"
          }
        ],
        "searchFields": [],
        "semanticConfigurationName": "testconfig"
      }
    },
    {
      "type": "web",
      "id": 2,
      "knowledgeSourceName": "ks-preview-web",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 10,
      "elapsedMs": 2345,
      "error": {
        "code": "403",
        "message": "The error message",
        "details": [],
        "additionalInfo": [
          {
            "type": "SomeErrorType",
            "info": {
              "someProperty": "Some value"
            }
          }
        ]
      }
    },
    {
      "type": "agenticReasoning",
      "id": 3,
      "retrievalReasoningEffort": {
        "kind": "low"
      },
      "reasoningTokens": 74
    },
    {
      "type": "modelAnswerSynthesis",
      "id": 4,
      "inputTokens": 664,
      "outputTokens": 1328,
      "elapsedMs": 10
    }
  ],
  "references": [
    {
      "type": "searchIndex",
      "id": "83dd7d40",
      "activitySource": 1,
      "sourceData": {
        "id": "myDocKey1",
        "title": "high_doc",
        "content": "hello world"
      },
      "rerankerScore": 3.5,
      "docKey": "myDocKey1"
    },
    {
      "type": "searchIndex",
      "id": "83dd7d41",
      "activitySource": 1,
      "sourceData": {
        "id": "myDocKey2",
        "title": "low_doc",
        "content": "goodbye world"
      },
      "rerankerScore": 2.7,
      "docKey": "myDocKey2"
    }
  ]
}

KnowledgeBaseRetrieveWithIntents

Pedido de amostra

HTTP

POST https://previewexampleservice.search.windows.net/knowledgebases('base-preview-test')/retrieve?api-version=2026-05-01-preview



{
  "intents": [
    {
      "search": "foo",
      "type": "semantic"
    }
  ],
  "maxRuntimeInSeconds": 60,
  "maxOutputSize": 100000,
  "maxOutputDocuments": 50,
  "retrievalReasoningEffort": {
    "kind": "minimal"
  },
  "includeActivity": true,
  "outputMode": "extractiveData",
  "knowledgeSourceParams": [
    {
      "filterAddOn": "foo eq bar",
      "knowledgeSourceName": "ks-preview-test",
      "includeReferences": true,
      "includeReferenceSourceData": true,
      "alwaysQuerySource": true,
      "failOnError": true,
      "rerankerThreshold": 2.1,
      "kind": "searchIndex"
    }
  ]
}

Resposta da amostra

Código de estado:: 200

{
  "response": [
    {
      "content": [
        {
          "type": "text",
          "text": "[{...}]"
        }
      ]
    }
  ],
  "activity": [
    {
      "type": "searchIndex",
      "id": 0,
      "knowledgeSourceName": "ks-preview-test",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 2,
      "elapsedMs": 1234,
      "searchIndexArguments": {
        "search": "foo",
        "filter": "foo eq bar",
        "sourceDataFields": [
          {
            "name": "category"
          },
          {
            "name": "description"
          },
          {
            "name": "ownerId"
          },
          {
            "name": "id"
          }
        ],
        "searchFields": [],
        "semanticConfigurationName": "testconfig"
      }
    },
    {
      "type": "agenticReasoning",
      "id": 1,
      "retrievalReasoningEffort": {
        "kind": "minimal"
      },
      "reasoningTokens": 37
    }
  ],
  "references": [
    {
      "type": "searchIndex",
      "id": "83dd7d40",
      "activitySource": 0,
      "sourceData": {
        "id": "myDocKey1",
        "title": "high_doc",
        "content": "hello world"
      },
      "rerankerScore": 3.5,
      "docKey": "myDocKey1"
    },
    {
      "type": "searchIndex",
      "id": "83dd7d41",
      "activitySource": 0,
      "sourceData": {
        "id": "myDocKey2",
        "title": "low_doc",
        "content": "goodbye world"
      },
      "rerankerScore": 2.7,
      "docKey": "myDocKey2"
    }
  ]
}

Código de estado:: 206

{
  "response": [
    {
      "content": [
        {
          "type": "text",
          "text": "[{...}]"
        }
      ]
    }
  ],
  "activity": [
    {
      "type": "searchIndex",
      "id": 0,
      "knowledgeSourceName": "ks-preview-test",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 2,
      "elapsedMs": 1234,
      "searchIndexArguments": {
        "search": "foo",
        "filter": "foo eq bar",
        "sourceDataFields": [
          {
            "name": "category"
          },
          {
            "name": "description"
          },
          {
            "name": "ownerId"
          },
          {
            "name": "id"
          }
        ],
        "searchFields": [],
        "semanticConfigurationName": "testconfig"
      }
    },
    {
      "type": "web",
      "id": 1,
      "knowledgeSourceName": "ks-preview-web",
      "queryTime": "2025-01-01T00:08:45.045Z",
      "count": 10,
      "elapsedMs": 2345,
      "error": {
        "code": "403",
        "message": "The error message",
        "details": [],
        "additionalInfo": [
          {
            "type": "SomeErrorType",
            "info": {
              "someProperty": "Some value"
            }
          }
        ]
      }
    },
    {
      "type": "agenticReasoning",
      "id": 2,
      "retrievalReasoningEffort": {
        "kind": "minimal"
      },
      "reasoningTokens": 37
    }
  ],
  "references": [
    {
      "type": "searchIndex",
      "id": "83dd7d40",
      "activitySource": 0,
      "sourceData": {
        "id": "myDocKey1",
        "title": "high_doc",
        "content": "hello world"
      },
      "rerankerScore": 3.5,
      "docKey": "myDocKey1"
    },
    {
      "type": "searchIndex",
      "id": "83dd7d41",
      "activitySource": 0,
      "sourceData": {
        "id": "myDocKey2",
        "title": "low_doc",
        "content": "goodbye world"
      },
      "rerankerScore": 2.7,
      "docKey": "myDocKey2"
    }
  ]
}

Definições

Name	Description
Accept	O cabeçalho Aceitar.
AzureBlobKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento azure blob
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)
FabricDataAgentKnowledgeSourceParams	Especifica parâmetros de execução para uma fonte de conhecimento do Fabric Data Agent
FabricOntologyKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento em Fabric Ontology
FileKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento de ficheiro
ImageServingStatistics	Estatísticas sobre o serviço de imagem durante uma atividade de recuperação.
IndexedOneLakeKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento OneLake indexada
IndexedSharePointKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento do SharePoint indexada
IndexedSqlKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento SQL indexada
KnowledgeBaseActivityRecordType	O tipo de registo de atividade.
KnowledgeBaseAgenticReasoningActivityRecord	Representa um registro de atividade de raciocínio agentico.
KnowledgeBaseAzureBlobActivityArguments	Representa os argumentos com os quais a atividade de recuperação de blob azure foi executada.
KnowledgeBaseAzureBlobActivityRecord	Representa um registro de atividade de recuperação de blob azure.
KnowledgeBaseAzureBlobReference	Representa uma referência de documento do Armazenamento de Blobs do Azure.
KnowledgeBaseErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
KnowledgeBaseErrorDetail	Os detalhes do erro.
KnowledgeBaseFabricDataAgentActivityArguments	Representa os argumentos com que a atividade de recuperação do Fabric Data Agent foi executada.
KnowledgeBaseFabricDataAgentActivityRecord	Representa um registo de atividade de recuperação do Fabric Data Agent.
KnowledgeBaseFabricDataAgentReference	Representa uma referência de documento do Fabric Data Agent.
KnowledgeBaseFabricOntologyActivityArguments	Representa os argumentos com que foi conduzida a atividade de recuperação da Fabric Ontology.
KnowledgeBaseFabricOntologyActivityRecord	Representa um registo de atividade de recuperação da Fabric Ontology.
KnowledgeBaseFabricOntologyReference	Representa uma referência documental da Fabric Ontology.
KnowledgeBaseFileActivityArguments	Representa os argumentos com que a atividade de recuperação de ficheiros foi executada.
KnowledgeBaseFileActivityRecord	Representa um registo de atividade de recuperação de ficheiros.
KnowledgeBaseFileReference	Representa uma referência de documento de ficheiro.
KnowledgeBaseImageContent	Conteúdo da imagem.
KnowledgeBaseIndexedOneLakeActivityArguments	Representa os argumentos com que foi conduzida a atividade de recuperação indexada do OneLake.
KnowledgeBaseIndexedOneLakeActivityRecord	Representa um registo indexado de atividade de recuperação do OneLake.
KnowledgeBaseIndexedOneLakeReference	Representa uma referência indexada de documento OneLake.
KnowledgeBaseIndexedSharePointActivityArguments	Representa os argumentos com que a atividade indexada de recuperação do SharePoint foi executada.
KnowledgeBaseIndexedSharePointActivityRecord	Representa um registo indexado de atividade de recuperação do SharePoint.
KnowledgeBaseIndexedSharePointReference	Representa uma referência indexada de um documento SharePoint.
KnowledgeBaseIndexedSqlActivityArguments	Representa os argumentos com que a atividade de recuperação de SQL indexado foi executada.
KnowledgeBaseIndexedSqlActivityRecord	Representa um registo indexado de atividade de recuperação SQL.
KnowledgeBaseIndexedSqlReference	Representa uma referência de documento SQL do Azure.
KnowledgeBaseMcpServerActivityArguments	Representa os argumentos com que a atividade de recuperação do servidor MCP foi executada.
KnowledgeBaseMcpServerActivityRecord	Representa um registo de atividade de recuperação de servidor MCP.
KnowledgeBaseMcpServerReference	Representa uma referência a um documento de servidor MCP.
KnowledgeBaseMessage	O objeto de estilo de mensagem em linguagem natural.
KnowledgeBaseMessageContentType	O tipo de conteúdo da mensagem.
KnowledgeBaseMessageImageContent	Tipo de mensagem de imagem.
KnowledgeBaseMessageTextContent	Tipo de mensagem de texto.
KnowledgeBaseModelAnswerSynthesisActivityRecord	Representa um registro de atividade de síntese de resposta LLM.
KnowledgeBaseModelQueryPlanningActivityRecord	Representa um registro de atividade de planejamento de consulta LLM.
KnowledgeBaseModelWebSummarizationActivityRecord	Representa um registo de atividade de sumarização web de LLM.
KnowledgeBaseReferenceType	O tipo de referência.
KnowledgeBaseRemoteSharePointActivityArguments	Representa os argumentos com que a atividade remota de recuperação do SharePoint foi executada.
KnowledgeBaseRemoteSharePointActivityRecord	Representa um registo de atividade de recuperação remota do SharePoint.
KnowledgeBaseRemoteSharePointReference	Representa uma referência de documento remoto do SharePoint.
KnowledgeBaseRetrievalRequest	O contrato de entrada para a solicitação de recuperação.
KnowledgeBaseRetrievalResponse	O contrato de saída para a resposta de recuperação.
KnowledgeBaseSearchIndexActivityArguments	Representa os argumentos com os quais a atividade de recuperação do índice de pesquisa foi executada.
KnowledgeBaseSearchIndexActivityRecord	Representa um registro de atividade de recuperação de índice de pesquisa.
KnowledgeBaseSearchIndexReference	Representa uma referência de documento da Pesquisa do Azure.
KnowledgeBaseWebActivityArguments	Representa os argumentos com que a atividade de recuperação da web foi conduzida.
KnowledgeBaseWebActivityRecord	Representa um registo de atividade de recuperação web.
KnowledgeBaseWebReference	Representa uma referência de documento web.
KnowledgeBaseWorkIQActivityArguments	Representa os argumentos com que a atividade de recuperação do WorkIQ foi conduzida.
KnowledgeBaseWorkIQActivityRecord	Representa um registo de atividade de recuperação WorkIQ.
KnowledgeBaseWorkIQReference	Representa uma referência de documento WorkIQ.
KnowledgeRetrievalIntentType	O tipo de configuração da base de dados de conhecimento a ser usada.
KnowledgeRetrievalLowReasoningEffort	Execute a recuperação de conhecimento com baixo esforço de raciocínio.
KnowledgeRetrievalMediumReasoningEffort	Execute a recuperação de conhecimento com esforço de raciocínio médio.
KnowledgeRetrievalMinimalReasoningEffort	Execute a recuperação de conhecimento com o mínimo esforço de raciocínio.
KnowledgeRetrievalOutputMode	A configuração de saída para essa recuperação.
KnowledgeRetrievalReasoningEffortKind	A quantidade de esforço a utilizar durante a recuperação.
KnowledgeRetrievalSemanticIntent	Uma intenção de consulta semântica.
KnowledgeSourceKind	O tipo de fonte de conhecimento.
McpServerKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento de servidor MCP
PurviewSensitivityLabelInfo	Informação sobre o rótulo de sensibilidade aplicado a um documento
RemoteSharePointKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento remota do SharePoint
SearchIndexFieldReference	Referência de campo para um índice de pesquisa.
SearchIndexKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento de índice de pesquisa
WebKnowledgeSourceParams	Especifica parâmetros de tempo de execução para uma fonte de conhecimento da Web
WorkIQAttribution	Informação de atribuição para uma referência WorkIQ.
WorkIQKnowledgeSourceParams	Especifica parâmetros de execução para uma fonte de conhecimento WorkIQ

Accept

Enumeração

O cabeçalho Aceitar.

Valor	Description
application/json;odata.metadata=minimal

AzureBlobKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento azure blob

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: azureBlob	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

ErrorAdditionalInfo

Object

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info		As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

FabricDataAgentKnowledgeSourceParams

Object

Especifica parâmetros de execução para uma fonte de conhecimento do Fabric Data Agent

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: fabricDataAgent	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

FabricOntologyKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento em Fabric Ontology

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: fabricOntology	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

FileKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento de ficheiro

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: file	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

ImageServingStatistics

Object

Estatísticas sobre o serviço de imagem durante uma atividade de recuperação.

Name	Tipo	Description
imagesRetrieved	integer (int32)	O número de imagens recuperadas da loja de assets.
imagesSentToModel	integer (int32)	O número de imagens enviadas para o modelo a jusante.
totalImageSizeBytes	integer (int64)	O tamanho total em bytes das imagens enviadas para o modelo.
verbalizationUsed	boolean	Indica se foi usada verbalização de imagem em vez de servir diretamente de imagem.

IndexedOneLakeKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento OneLake indexada

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: indexedOneLake	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

IndexedSharePointKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento do SharePoint indexada

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: indexedSharePoint	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

IndexedSqlKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento SQL indexada

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: indexedSql	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

KnowledgeBaseActivityRecordType

Enumeração

O tipo de registo de atividade.

Valor	Description
searchIndex	Atividade de pesquisa e de recuperação de índices.
azureBlob	Atividade de recuperação do Azure Blob.
indexedSharePoint	Atividade indexada de recuperação do SharePoint.
indexedOneLake	Atividade de recuperação indexada no OneLake.
web	Atividade de recuperação da web.
remoteSharePoint	Atividade remota de recuperação do SharePoint.
workIQ	Atividade de recuperação do WorkIQ.
fabricDataAgent	Atividade de recuperação do Fabric Data Agent.
fabricOntology	Atividade de recuperação da Fabric Ontology.
mcpServer	Atividade de recuperação do servidor MCP.
file	Atividade de recuperação de ficheiros.
indexedSql	Atividade de recuperação SQL indexada.
modelQueryPlanning	Atividade de planeamento de consultas de LLM.
modelAnswerSynthesis	Atividade de síntese de respostas LLM.
modelWebSummarization	Atividade de resumo web de LLM.
agenticReasoning	Atividade de raciocínio agente.

KnowledgeBaseAgenticReasoningActivityRecord

Object

Representa um registro de atividade de raciocínio agentico.

Name	Tipo	Description
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
reasoningTokens	integer (int32)	O número de tokens de entrada para raciocínio agentico.
retrievalReasoningEffort	KnowledgeRetrievalReasoningEffort: KnowledgeRetrievalLowReasoningEffort KnowledgeRetrievalMediumReasoningEffort KnowledgeRetrievalMinimalReasoningEffort	A configuração do esforço de raciocínio de recuperação.
type	string: agenticReasoning	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseAzureBlobActivityArguments

Object

Representa os argumentos com os quais a atividade de recuperação de blob azure foi executada.

Name	Tipo	Description
search	string	A cadeia de caracteres de pesquisa usada para consultar o conteúdo do blob.

KnowledgeBaseAzureBlobActivityRecord

Object

Representa um registro de atividade de recuperação de blob azure.

Name	Tipo	Description
azureBlobArguments	KnowledgeBaseAzureBlobActivityArguments	Os argumentos azure blob para a atividade de recuperação.
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: azureBlob	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseAzureBlobReference

Object

Representa uma referência de documento do Armazenamento de Blobs do Azure.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
blobUrl	string	O URL de blob para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
searchSensitivityLabelInfo	PurviewSensitivityLabelInfo	A informação do rótulo de sensibilidade para a referência.
sourceData		Os dados de origem para a referência.
type	string: azureBlob	O tipo de referência.

KnowledgeBaseErrorAdditionalInfo

Object

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info		As informações adicionais.
type	string	O tipo de informação adicional.

KnowledgeBaseErrorDetail

Object

Os detalhes do erro.

Name	Tipo	Description
additionalInfo	KnowledgeBaseErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	KnowledgeBaseErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

KnowledgeBaseFabricDataAgentActivityArguments

Object

Representa os argumentos com que a atividade de recuperação do Fabric Data Agent foi executada.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar a fonte de conhecimento do Fabric Data Agent.

KnowledgeBaseFabricDataAgentActivityRecord

Object

Representa um registo de atividade de recuperação do Fabric Data Agent.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
fabricDataAgentArguments	KnowledgeBaseFabricDataAgentActivityArguments	Os argumentos do Fabric Data Agent para a atividade de recuperação.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: fabricDataAgent	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseFabricDataAgentReference

Object

Representa uma referência de documento do Fabric Data Agent.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
dataAgentId	string	O ID do Agente de Dados Fabric.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
type	string: fabricDataAgent	O tipo de referência.
workspaceId	string	O ID do espaço de trabalho do Fabric.

KnowledgeBaseFabricOntologyActivityArguments

Object

Representa os argumentos com que foi conduzida a atividade de recuperação da Fabric Ontology.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar a fonte de conhecimento da Fabric Ontology.

KnowledgeBaseFabricOntologyActivityRecord

Object

Representa um registo de atividade de recuperação da Fabric Ontology.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
fabricOntologyArguments	KnowledgeBaseFabricOntologyActivityArguments	Os argumentos da Fabric Ontology para a atividade de recuperação.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: fabricOntology	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseFabricOntologyReference

Object

Representa uma referência documental da Fabric Ontology.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
id	string	O ID da referência.
ontologyId	string	O ID da ontologia dentro do espaço de trabalho.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
type	string: fabricOntology	O tipo de referência.
workspaceId	string	O ID do espaço de trabalho do Fabric.

KnowledgeBaseFileActivityArguments

Object

Representa os argumentos com que a atividade de recuperação de ficheiros foi executada.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar o conteúdo do ficheiro.

KnowledgeBaseFileActivityRecord

Object

Representa um registo de atividade de recuperação de ficheiros.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
fileArguments	KnowledgeBaseFileActivityArguments	Os argumentos do ficheiro para a atividade de recuperação.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: file	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseFileReference

Object

Representa uma referência de documento de ficheiro.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
docName	string	O nome do documento para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
type	string: file	O tipo de referência.

KnowledgeBaseImageContent

Object

Conteúdo da imagem.

Name	Tipo	Description
url	string (uri)	O url da imagem.

KnowledgeBaseIndexedOneLakeActivityArguments

Object

Representa os argumentos com que foi conduzida a atividade de recuperação indexada do OneLake.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar indexava conteúdos do OneLake.

KnowledgeBaseIndexedOneLakeActivityRecord

Object

Representa um registo indexado de atividade de recuperação do OneLake.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
indexedOneLakeArguments	KnowledgeBaseIndexedOneLakeActivityArguments	Os argumentos indexados do OneLake para a atividade de recuperação.
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: indexedOneLake	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseIndexedOneLakeReference

Object

Representa uma referência indexada de documento OneLake.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
docUrl	string	O URL do documento para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
searchSensitivityLabelInfo	PurviewSensitivityLabelInfo	A informação do rótulo de sensibilidade para a referência.
sourceData		Os dados de origem para a referência.
type	string: indexedOneLake	O tipo de referência.

KnowledgeBaseIndexedSharePointActivityArguments

Object

Representa os argumentos com que a atividade indexada de recuperação do SharePoint foi executada.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar conteúdos indexados do SharePoint.

KnowledgeBaseIndexedSharePointActivityRecord

Object

Representa um registo indexado de atividade de recuperação do SharePoint.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
indexedSharePointArguments	KnowledgeBaseIndexedSharePointActivityArguments	Os argumentos indexados do SharePoint para a atividade de recuperação.
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: indexedSharePoint	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseIndexedSharePointReference

Object

Representa uma referência indexada de um documento SharePoint.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
docUrl	string	O URL do documento para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
searchSensitivityLabelInfo	PurviewSensitivityLabelInfo	A informação do rótulo de sensibilidade para a referência.
sourceData		Os dados de origem para a referência.
type	string: indexedSharePoint	O tipo de referência.

KnowledgeBaseIndexedSqlActivityArguments

Object

Representa os argumentos com que a atividade de recuperação de SQL indexado foi executada.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar conteúdos SQL indexados.

KnowledgeBaseIndexedSqlActivityRecord

Object

Representa um registo indexado de atividade de recuperação SQL.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
indexedSqlArguments	KnowledgeBaseIndexedSqlActivityArguments	Os argumentos SQL indexados para a atividade de recuperação.
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: indexedSql	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseIndexedSqlReference

Object

Representa uma referência de documento SQL do Azure.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
docUrl	string	O URL do documento para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
type	string: indexedSql	O tipo de referência.

KnowledgeBaseMcpServerActivityArguments

Object

Representa os argumentos com que a atividade de recuperação do servidor MCP foi executada.

Name	Tipo	Description
toolArguments		Os argumentos passaram para a ferramenta de servidor MCP.
toolName	string	O nome da ferramenta servidor MCP usada para a atividade de recuperação.

KnowledgeBaseMcpServerActivityRecord

Object

Representa um registo de atividade de recuperação de servidor MCP.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
mcpServerArguments	KnowledgeBaseMcpServerActivityArguments	O servidor MCP argumenta para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: mcpServer	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseMcpServerReference

Object

Representa uma referência a um documento de servidor MCP.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
title	string	O título do resultado da ferramenta de servidor MCP.
toolName	string	O nome da ferramenta servidor MCP que produziu a referência.
type	string: mcpServer	O tipo de referência.

KnowledgeBaseMessage

Object

O objeto de estilo de mensagem em linguagem natural.

Name	Tipo	Description
content	KnowledgeBaseMessageContent[]: KnowledgeBaseMessageImageContent[] KnowledgeBaseMessageTextContent[]	O conteúdo da mensagem.
role	string	O papel da resposta da ferramenta.

KnowledgeBaseMessageContentType

Enumeração

O tipo de conteúdo da mensagem.

Valor	Description
text	Tipo de conteúdo de mensagem de texto.
image	Tipo de conteúdo da mensagem de imagem.

KnowledgeBaseMessageImageContent

Object

Tipo de mensagem de imagem.

Name	Tipo	Description
image	KnowledgeBaseImageContent	O conteúdo da imagem.
type	string: image	O tipo da mensagem

KnowledgeBaseMessageTextContent

Object

Tipo de mensagem de texto.

Name	Tipo	Description
text	string	O conteúdo do texto.
type	string: text	O tipo da mensagem

KnowledgeBaseModelAnswerSynthesisActivityRecord

Object

Representa um registro de atividade de síntese de resposta LLM.

Name	Tipo	Description
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
inputTokens	integer (int32)	O número de tokens de entrada para a atividade de síntese de resposta LLM.
modelName	string	O nome do modelo utilizado para a atividade de síntese de respostas do LLM.
outputTokens	integer (int32)	O número de tokens de saída para a atividade de síntese de resposta LLM.
type	string: modelAnswerSynthesis	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseModelQueryPlanningActivityRecord

Object

Representa um registro de atividade de planejamento de consulta LLM.

Name	Tipo	Description
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
inputTokens	integer (int32)	O número de tokens de entrada para a atividade de planejamento de consulta LLM.
modelName	string	O nome do modelo utilizado para a atividade de planeamento de consultas do LLM.
outputTokens	integer (int32)	O número de tokens de saída para a atividade de planejamento de consulta LLM.
type	string: modelQueryPlanning	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseModelWebSummarizationActivityRecord

Object

Representa um registo de atividade de sumarização web de LLM.

Name	Tipo	Description
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
inputTokens	integer (int32)	O número de tokens de entrada para a atividade de sumarização web do LLM.
modelName	string	O nome do modelo utilizado para a atividade de sumarização web do LLM.
outputTokens	integer (int32)	O número de tokens de saída para a atividade de sumarização web do LLM.
type	string: modelWebSummarization	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseReferenceType

Enumeração

O tipo de referência.

Valor	Description
searchIndex	Pesquise índice de referência de documentos.
azureBlob	Referência de documento Azure Blob.
indexedSharePoint	Referência indexada do documento SharePoint.
indexedOneLake	Referência indexada do documento OneLake.
web	Referência de documentos web.
remoteSharePoint	Referência remota de documentos do SharePoint.
workIQ	Referência do documento Work IQ.
fabricDataAgent	Referência do documento Fabric Data Agent.
fabricOntology	Referência do documento Fabric Ontology.
mcpServer	Referência do documento do servidor MCP.
file	Apresente referência de documento.
indexedSql	Referência indexada de documentos SQL.

KnowledgeBaseRemoteSharePointActivityArguments

Object

Representa os argumentos com que a atividade remota de recuperação do SharePoint foi executada.

Name	Tipo	Description
filterExpressionAddOn	string	O complemento de expressão de filtro para a atividade de recuperação.
search	string	A cadeia de pesquisa usada para consultar a fonte remota de conhecimento do SharePoint.

KnowledgeBaseRemoteSharePointActivityRecord

Object

Representa um registo de atividade de recuperação remota do SharePoint.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
remoteSharePointArguments	KnowledgeBaseRemoteSharePointActivityArguments	Os argumentos do SharePoint remoto para a atividade de recuperação.
type	string: remoteSharePoint	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseRemoteSharePointReference

Object

Representa uma referência de documento remoto do SharePoint.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
searchSensitivityLabelInfo	PurviewSensitivityLabelInfo	A informação do rótulo de sensibilidade para a referência.
sourceData		Os dados de origem para a referência.
type	string: remoteSharePoint	O tipo de referência.
webUrl	string (uri)	A URL de onde os dados de referência se originaram.

KnowledgeBaseRetrievalRequest

Object

O contrato de entrada para a solicitação de recuperação.

Name	Tipo	Description
includeActivity	boolean	Indica que os resultados da recuperação devem incluir informações sobre a atividade.
intents	KnowledgeRetrievalIntent[]: KnowledgeRetrievalSemanticIntent[]	Uma lista de consultas pretendidas a serem executadas sem planejamento de consulta de modelo.
knowledgeSourceParams	KnowledgeSourceParams[]: AzureBlobKnowledgeSourceParams[] FabricDataAgentKnowledgeSourceParams[] FabricOntologyKnowledgeSourceParams[] FileKnowledgeSourceParams[] IndexedOneLakeKnowledgeSourceParams[] IndexedSharePointKnowledgeSourceParams[] IndexedSqlKnowledgeSourceParams[] McpServerKnowledgeSourceParams[] RemoteSharePointKnowledgeSourceParams[] SearchIndexKnowledgeSourceParams[] WebKnowledgeSourceParams[] WorkIQKnowledgeSourceParams[]	Uma lista de parâmetros de tempo de execução para as fontes de conhecimento.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos na saída.
maxOutputSize	integer (int32)	Limita o tamanho máximo do conteúdo na saída.
maxOutputSizeInTokens	integer (int32)	Limita o tamanho máximo do conteúdo na saída.
maxRuntimeInSeconds	integer (int32)	O tempo de execução máximo em segundos.
messages	KnowledgeBaseMessage[]	Uma lista de entrada de estilo de mensagem de chat.
outputMode	KnowledgeRetrievalOutputMode	A configuração de saída para essa recuperação.
retrievalReasoningEffort	KnowledgeRetrievalReasoningEffort: KnowledgeRetrievalLowReasoningEffort KnowledgeRetrievalMediumReasoningEffort KnowledgeRetrievalMinimalReasoningEffort	A configuração do esforço de raciocínio de recuperação.

KnowledgeBaseRetrievalResponse

Object

O contrato de saída para a resposta de recuperação.

Name	Tipo	Description
activity	KnowledgeBaseActivityRecord[]: KnowledgeBaseAgenticReasoningActivityRecord[] KnowledgeBaseAzureBlobActivityRecord[] KnowledgeBaseFabricDataAgentActivityRecord[] KnowledgeBaseFabricOntologyActivityRecord[] KnowledgeBaseFileActivityRecord[] KnowledgeBaseIndexedOneLakeActivityRecord[] KnowledgeBaseIndexedSharePointActivityRecord[] KnowledgeBaseIndexedSqlActivityRecord[] KnowledgeBaseMcpServerActivityRecord[] KnowledgeBaseModelAnswerSynthesisActivityRecord[] KnowledgeBaseModelQueryPlanningActivityRecord[] KnowledgeBaseModelWebSummarizationActivityRecord[] KnowledgeBaseRemoteSharePointActivityRecord[] KnowledgeBaseSearchIndexActivityRecord[] KnowledgeBaseWebActivityRecord[] KnowledgeBaseWorkIQActivityRecord[]	Os registros de atividade para acompanhar o progresso e as implicações de faturamento.
references	KnowledgeBaseReference[]: KnowledgeBaseAzureBlobReference[] KnowledgeBaseFabricDataAgentReference[] KnowledgeBaseFabricOntologyReference[] KnowledgeBaseFileReference[] KnowledgeBaseIndexedOneLakeReference[] KnowledgeBaseIndexedSharePointReference[] KnowledgeBaseIndexedSqlReference[] KnowledgeBaseMcpServerReference[] KnowledgeBaseRemoteSharePointReference[] KnowledgeBaseSearchIndexReference[] KnowledgeBaseWebReference[] KnowledgeBaseWorkIQReference[]	As referências para os dados de recuperação usados na resposta.
response	KnowledgeBaseMessage[]	As mensagens de resposta.
responseSensitivityLabelInfo	PurviewSensitivityLabelInfo	A informação do rótulo de sensibilidade para a resposta global.

KnowledgeBaseSearchIndexActivityArguments

Object

Representa os argumentos com os quais a atividade de recuperação do índice de pesquisa foi executada.

Name	Tipo	Description
filter	string	A cadeia de caracteres do filtro.
search	string	A cadeia de caracteres de pesquisa usada para consultar o índice de pesquisa.
searchFields	SearchIndexFieldReference[]	Quais campos foram pesquisados.
semanticConfigurationName	string	Que configuração semântica foi usada a partir do índice de pesquisa.
sourceDataFields	SearchIndexFieldReference[]	Que campos foram selecionados para pesquisa.

KnowledgeBaseSearchIndexActivityRecord

Object

Representa um registro de atividade de recuperação de índice de pesquisa.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
searchIndexArguments	KnowledgeBaseSearchIndexActivityArguments	Os argumentos do índice de pesquisa para a atividade de recuperação.
type	string: searchIndex	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.

KnowledgeBaseSearchIndexReference

Object

Representa uma referência de documento da Pesquisa do Azure.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
docKey	string	A chave do documento para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
searchSensitivityLabelInfo	PurviewSensitivityLabelInfo	A informação do rótulo de sensibilidade para a referência.
sourceData		Os dados de origem para a referência.
type	string: searchIndex	O tipo de referência.

KnowledgeBaseWebActivityArguments

Object

Representa os argumentos com que a atividade de recuperação da web foi conduzida.

Name	Tipo	Description
count	integer (int32)	O número de resultados web devolvido.
freshness	string	A frescura para a atividade de recolha.
language	string	A linguagem para a atividade de recuperação.
market	string	O mercado para a atividade de recuperação.
search	string	A cadeia de pesquisa usada para consultar a web.

KnowledgeBaseWebActivityRecord

Object

Representa um registo de atividade de recuperação web.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: web	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.
webArguments	KnowledgeBaseWebActivityArguments	Os argumentos da web para a atividade de recuperação.

KnowledgeBaseWebReference

Object

Representa uma referência de documento web.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
title	string	O título do documento web.
type	string: web	O tipo de referência.
url	string (uri)	A URL de onde os dados de referência se originaram.

KnowledgeBaseWorkIQActivityArguments

Object

Representa os argumentos com que a atividade de recuperação do WorkIQ foi conduzida.

Name	Tipo	Description
search	string	A cadeia de pesquisa usada para consultar a fonte de conhecimento do WorkIQ.

KnowledgeBaseWorkIQActivityRecord

Object

Representa um registo de atividade de recuperação WorkIQ.

Name	Tipo	Description
count	integer (int32)	A contagem de documentos recuperados que foram suficientemente relevantes para ultrapassar o limiar de reclassificação.
elapsedMs	integer (int32)	O tempo decorrido em milissegundos para a atividade de recuperação.
error	KnowledgeBaseErrorDetail	O detalhe do erro explicando por que a operação falhou. Esta propriedade só é incluída quando a atividade não é bem-sucedida.
id	integer (int32)	A ID do registro de atividade.
imageServing	ImageServingStatistics	Estatísticas sobre a função de imagem para esta atividade de recuperação
knowledgeSourceName	string	A fonte de conhecimento para a atividade de recuperação.
queryTime	string (date-time)	O tempo de consulta para essa atividade de recuperação.
type	string: workIQ	O tipo de registro de atividade.
warning	string	Uma mensagem de aviso que revela potenciais problemas de configuração observados durante a atividade, como documentos perdidos devido ao limiar de pontuação, truncamento do limite de tokens ou condições de timeout.
workIQArguments	KnowledgeBaseWorkIQActivityArguments	Os argumentos do WorkIQ para a atividade de recuperação.

KnowledgeBaseWorkIQReference

Object

Representa uma referência de documento WorkIQ.

Name	Tipo	Description
activitySource	integer (int32)	O ID da atividade de origem para a referência.
attributions	WorkIQAttribution[]	As atribuições para a referência.
id	string	O ID da referência.
rerankerScore	number (float)	A pontuação do reclassificador para a referência do documento.
sourceData		Os dados de origem para a referência.
type	string: workIQ	O tipo de referência.

KnowledgeRetrievalIntentType

Enumeração

O tipo de configuração da base de dados de conhecimento a ser usada.

Valor	Description
semantic	Uma intenção de consulta semântica em linguagem natural.

KnowledgeRetrievalLowReasoningEffort

Object

Execute a recuperação de conhecimento com baixo esforço de raciocínio.

Name	Tipo	Description
kind	string: low	O tipo de esforço de raciocínio.

KnowledgeRetrievalMediumReasoningEffort

Object

Execute a recuperação de conhecimento com esforço de raciocínio médio.

Name	Tipo	Description
kind	string: medium	O tipo de esforço de raciocínio.

KnowledgeRetrievalMinimalReasoningEffort

Object

Execute a recuperação de conhecimento com o mínimo esforço de raciocínio.

Name	Tipo	Description
kind	string: minimal	O tipo de esforço de raciocínio.

KnowledgeRetrievalOutputMode

Enumeração

A configuração de saída para essa recuperação.

Valor	Description
extractiveData	Retornar dados das fontes de conhecimento diretamente, sem alteração generativa.
answerSynthesis	Sintetize uma resposta para a carga útil de resposta.

KnowledgeRetrievalReasoningEffortKind

Enumeração

A quantidade de esforço a utilizar durante a recuperação.

Valor	Description
minimal	Não executa nenhuma seleção de origem, planejamento de consulta ou pesquisa iterativa.
low	Use raciocínio baixo durante a recuperação.
medium	Use uma quantidade moderada de raciocínio durante a recuperação.

KnowledgeRetrievalSemanticIntent

Object

Uma intenção de consulta semântica.

Name	Tipo	Description
search	string	A consulta semântica a ser executada
type	string: semantic	O tipo de intenção.

KnowledgeSourceKind

Enumeração

O tipo de fonte de conhecimento.

Valor	Description
searchIndex	Uma fonte de conhecimento que lê dados de um índice de pesquisa.
azureBlob	Uma fonte de conhecimento que lê e ingere dados do Armazenamento de Blobs do Azure para um Índice de Pesquisa.
indexedSharePoint	Uma fonte de conhecimento que lê dados do SharePoint indexado.
indexedOneLake	Uma fonte de conhecimento que lê dados do OneLake indexado.
indexedSql	Uma fonte de conhecimento que recupera e ingere dados do Base de Dados SQL do Azure ou SQL Managed Instance para um Índice de Pesquisa.
web	Uma fonte de conhecimento que lê dados da web.
remoteSharePoint	Uma fonte de conhecimento que lê dados do SharePoint remoto.
workIQ	Uma fonte de conhecimento que lê dados do QI de trabalho
file	Uma fonte de conhecimento que suporta o upload e indexação direta de ficheiros.
mcpServer	Uma fonte de conhecimento apoiada por um servidor MCP (Model Context Protocol).
fabricDataAgent	Uma fonte de conhecimento que recupera dados de um Fabric Data Agent.
fabricOntology	Uma fonte de conhecimento que recupera dados das ontologias Microsoft Fabric Ontology.

McpServerKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento de servidor MCP

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: mcpServer	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

PurviewSensitivityLabelInfo

Object

Informação sobre o rótulo de sensibilidade aplicado a um documento

Name	Tipo	Description
color	string	A cor que a interface do usuário deve exibir para o rótulo, se configurada.
displayName	string	O nome para exibição do rótulo de sensibilidade.
isEncrypted	boolean	Indica se o rótulo de sensibilidade impõe criptografia.
priority	integer (int32)	A prioridade na qual o rótulo de sensibilidade é aplicado.
sensitivityLabelId	string	A ID do rótulo de sensibilidade.
toolTip	string	A dica de ferramenta que deve ser exibida para o rótulo em uma interface do usuário.

RemoteSharePointKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento remota do SharePoint

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
filterExpressionAddOn	string	Uma condição de filtro aplicada à fonte de dados do SharePoint. Ele deve ser especificado na sintaxe Keyword Query Language. Ele será combinado como uma conjunção com a expressão de filtro especificada na definição da fonte de conhecimento.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: remoteSharePoint	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

SearchIndexFieldReference

Object

Referência de campo para um índice de pesquisa.

Name	Tipo	Description
name	string	O nome do campo.

SearchIndexKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento de índice de pesquisa

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
filterAddOn	string	Uma condição de filtro aplicada ao índice (por exemplo, «State eq VA»).
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: searchIndex	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

WebKnowledgeSourceParams

Object

Especifica parâmetros de tempo de execução para uma fonte de conhecimento da Web

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
count	integer (int32)	O número de resultados da Web a serem retornados.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
freshness	string	A frescura dos resultados da web.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: web	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
language	string	O idioma dos resultados da web.
market	string	O mercado dos resultados web.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.

WorkIQAttribution

Object

Informação de atribuição para uma referência WorkIQ.

Name	Tipo	Description
seeMoreWebUrl	string (uri)	O URL da atribuição.

WorkIQKnowledgeSourceParams

Object

Especifica parâmetros de execução para uma fonte de conhecimento WorkIQ

Name	Tipo	Description
alwaysQuerySource	boolean	Indica que essa fonte de conhecimento deve ignorar a seleção da fonte e sempre ser consultada no momento da recuperação.
enableImageServing	boolean	Indica se o serviço de imagem deve ser ativado para esta fonte de conhecimento no momento da recuperação. Quando verdade, as imagens extraídas durante a ingestão são entregues para modelos a jusante.
failOnError	boolean	Indica que todo o pedido de recuperação deverá falhar se a recuperação desta fonte de conhecimento encontrar um erro. É definido para false por padrão.
includeReferenceSourceData	boolean	Indica se as referências devem incluir os dados estruturados obtidos durante a recuperação em sua carga útil.
includeReferences	boolean	Indica se devem ser incluídas referências para os dados recuperados dessa fonte.
kind	string: workIQ	O tipo de fonte de conhecimento.
knowledgeSourceName	string	O nome do índice ao qual os parâmetros se aplicam.
maxOutputDocuments	integer (int32)	Limita o número máximo de documentos devolvidos desta fonte de conhecimento.
rerankerThreshold	number (float)	O limite de reclassificação que todos os documentos recuperados devem cumprir para serem incluídos na resposta.