Knowledge Retrieval - Retrieve

База знаний извлекает релевантные данные из резервных хранилищ.

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

Параметры URI

Имя В Обязательно Тип Описание
endpoint
path True

string (uri)

URL-адрес конечной точки службы поиска.

knowledgeBaseName
path True

string

Название базы знаний.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Заголовок запроса

Имя Обязательно Тип Описание
Accept

Accept

Заголовок Accept.

x-ms-query-source-authorization

string

Маркер, идентифицирующий пользователя, для которого выполняется запрос. Этот маркер используется для применения ограничений безопасности к документам.

x-ms-client-request-id

string (uuid)

Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

Текст запроса

Имя Тип Описание
includeActivity

boolean

Указывает, что результаты извлечения должны содержать информацию о действиях.

intents KnowledgeRetrievalIntent[]:

KnowledgeRetrievalSemanticIntent[]

Список запросов, которые должны быть выполнены без планирования запросов модели.

knowledgeSourceParams KnowledgeSourceParams[]:

Список параметров времени выполнения для источников знаний.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов на выходе.

maxOutputSize

integer (int32)

Ограничивает максимальный размер содержимого на выходе.

maxOutputSizeInTokens

integer (int32)

Ограничивает максимальный размер содержимого на выходе.

maxRuntimeInSeconds

integer (int32)

Максимальное время работы в секундах.

messages

KnowledgeBaseMessage[]

Список вводимых сообщений в стиле чата.

outputMode

KnowledgeRetrievalOutputMode

Конфигурация выходных данных для этого извлечения.

retrievalReasoningEffort KnowledgeRetrievalReasoningEffort:

Конфигурация усилия рассуждения для поиска.

Ответы

Имя Тип Описание
200 OK

KnowledgeBaseRetrievalResponse

Успешный ответ на восстановление.

Other Status Codes

KnowledgeBaseRetrievalResponse

Ответ частичного извлечения.

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

api-key

Тип: apiKey
В: header

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Области

Имя Описание
https://search.azure.com/.default

Примеры

KnowledgeBaseRetrieve
KnowledgeBaseRetrieveWithIntents

KnowledgeBaseRetrieve

Образец запроса

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"
    }
  ]
}

Пример ответа

{
  "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
  }
}
{
  "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

Образец запроса

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"
    }
  ]
}

Пример ответа

{
  "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"
    }
  ]
}
{
  "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"
    }
  ]
}

Определения

Имя Описание
Accept

Заголовок Accept.

AzureBlobKnowledgeSourceParams

Указывает параметры среды выполнения для источника знаний о BLOB-объектах Azure

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Подробности ошибки.

ErrorResponse

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

FabricDataAgentKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний Fabric Data Agent

FabricOntologyKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний Fabric Ontology

FileKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний Файла

ImageServingStatistics

Статистика по подаче изображений во время активности по поиску.

IndexedOneLakeKnowledgeSourceParams

Указывает параметры среды выполнения для индексированного источника знаний OneLake

IndexedSharePointKnowledgeSourceParams

Указывает параметры среды выполнения для индексированного источника знаний SharePoint

IndexedSqlKnowledgeSourceParams

Задаёт параметры выполнения для индексируемого SQL-источника знаний

KnowledgeBaseActivityRecordType

Тип записи активности.

KnowledgeBaseAgenticReasoningActivityRecord

Представляет собой запись активности агентного рассуждения.

KnowledgeBaseAzureBlobActivityArguments

Представляет аргументы, с которыми было выполнено действие извлечения BLOB-объектов Azure.

KnowledgeBaseAzureBlobActivityRecord

Представляет запись о действиях по получению BLOB-объектов Azure.

KnowledgeBaseAzureBlobReference

Представляет собой справочник по документам хранилища BLOB-объектов Azure.

KnowledgeBaseErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

KnowledgeBaseErrorDetail

Сведения об ошибке.

KnowledgeBaseFabricDataAgentActivityArguments

Представляет аргументы, с которыми выполнялась активность поиска Fabric Data Agent.

KnowledgeBaseFabricDataAgentActivityRecord

Представляет собой запись активности поиска Fabric Data Agent.

KnowledgeBaseFabricDataAgentReference

Представляет собой ссылку на документ Fabric Data Agent.

KnowledgeBaseFabricOntologyActivityArguments

Представляет аргументы, с которыми проводилась активность поиска Fabric Ontology.

KnowledgeBaseFabricOntologyActivityRecord

Представляет запись активности поиска Fabric Ontology.

KnowledgeBaseFabricOntologyReference

Представляет собой ссылку на документ Fabric Ontology.

KnowledgeBaseFileActivityArguments

Представляет аргументы, с которыми выполнялась активность по извлечению файла.

KnowledgeBaseFileActivityRecord

Представляет запись активности по извлечению файлов.

KnowledgeBaseFileReference

Представляет собой ссылку на документ файла.

KnowledgeBaseImageContent

Содержание изображений.

KnowledgeBaseIndexedOneLakeActivityArguments

Представляет аргументы, с которыми проводилась индексированная активность поиска OneLake.

KnowledgeBaseIndexedOneLakeActivityRecord

Представляет индексированную запись активности по поиску OneLake.

KnowledgeBaseIndexedOneLakeReference

Представляет индексированную ссылку на документ OneLake.

KnowledgeBaseIndexedSharePointActivityArguments

Представляет аргументы, с которыми выполнялась индексированная активность поиска SharePoint.

KnowledgeBaseIndexedSharePointActivityRecord

Представляет индексированную запись активности поиска в SharePoint.

KnowledgeBaseIndexedSharePointReference

Представляет собой индексированный документ SharePoint.

KnowledgeBaseIndexedSqlActivityArguments

Представляет аргументы, с которыми выполнялась индексированная активность поиска SQL.

KnowledgeBaseIndexedSqlActivityRecord

Представляет индексированную запись активности поиска SQL.

KnowledgeBaseIndexedSqlReference

Представляет ссылку на документ Azure SQL.

KnowledgeBaseMcpServerActivityArguments

Представляет аргументы, с которыми выполнялась активность по поиску MCP-сервера.

KnowledgeBaseMcpServerActivityRecord

Представляет запись активности поиска сервера MCP.

KnowledgeBaseMcpServerReference

Представляет ссылку на документ сервера MCP.

KnowledgeBaseMessage

Объект стиля сообщения на естественном языке.

KnowledgeBaseMessageContentType

Тип содержимого сообщения.

KnowledgeBaseMessageImageContent

Тип графического сообщения.

KnowledgeBaseMessageTextContent

Тип текстового сообщения.

KnowledgeBaseModelAnswerSynthesisActivityRecord

Представляет собой запись активности синтеза ответов LLM.

KnowledgeBaseModelQueryPlanningActivityRecord

Представляет запись о планировании запроса LLM.

KnowledgeBaseModelWebSummarizationActivityRecord

Представляет запись активности по суммаризации веба в LLM.

KnowledgeBaseReferenceType

Тип ссылки.

KnowledgeBaseRemoteSharePointActivityArguments

Представляет аргументы, с которыми выполнялась удалённая активность поиска SharePoint.

KnowledgeBaseRemoteSharePointActivityRecord

Представляет собой удалённую запись активности поиска SharePoint.

KnowledgeBaseRemoteSharePointReference

Представляет собой удаленную ссылку на документ SharePoint.

KnowledgeBaseRetrievalRequest

Входной контракт для запроса на извлечение.

KnowledgeBaseRetrievalResponse

Выходной контракт для ответа на извлечение.

KnowledgeBaseSearchIndexActivityArguments

Представляет аргументы, с которыми было выполнено действие извлечения индекса поиска.

KnowledgeBaseSearchIndexActivityRecord

Представляет запись о действиях извлечения из индекса поиска.

KnowledgeBaseSearchIndexReference

Представляет ссылку на документ Поиска Azure.

KnowledgeBaseWebActivityArguments

Представляет аргументы, с которыми запускалась активность поиска в интернете.

KnowledgeBaseWebActivityRecord

Представляет собой запись активности поиска в веб-центре.

KnowledgeBaseWebReference

Представляет собой ссылку на веб-документ.

KnowledgeBaseWorkIQActivityArguments

Представляет аргументы, с которыми выполнялась активность поиска WorkIQ.

KnowledgeBaseWorkIQActivityRecord

Представляет запись активности поиска WorkIQ.

KnowledgeBaseWorkIQReference

Представляет собой ссылку на документ WorkIQ.

KnowledgeRetrievalIntentType

Тип используемой конфигурации базы знаний.

KnowledgeRetrievalLowReasoningEffort

Выполняйте извлечение знаний с минимальными усилиями по рассуждениям.

KnowledgeRetrievalMediumReasoningEffort

Выполняйте извлечение знаний со средними усилиями на рассуждение.

KnowledgeRetrievalMinimalReasoningEffort

Выполняйте извлечение знаний с минимальными усилиями по рассуждениям.

KnowledgeRetrievalOutputMode

Конфигурация выходных данных для этого извлечения.

KnowledgeRetrievalReasoningEffortKind

Количество усилий, затрачиваемых во время извлечения.

KnowledgeRetrievalSemanticIntent

Семантический запрос.

KnowledgeSourceKind

Вид источника знаний.

McpServerKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний сервера MCP

PurviewSensitivityLabelInfo

Информация о метке чувствительности, применяемой к документу

RemoteSharePointKnowledgeSourceParams

Указывает параметры среды выполнения для удаленного источника знаний SharePoint

SearchIndexFieldReference

Поле для поискового индекса.

SearchIndexKnowledgeSourceParams

Задает параметры времени выполнения для источника знаний индекса поиска

WebKnowledgeSourceParams

Задает параметры времени выполнения для веб-источника знаний

WorkIQAttribution

Информация об атрибуции для справочника WorkIQ.

WorkIQKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний WorkIQ

Accept

Заголовок Accept.

Значение Описание
application/json;odata.metadata=minimal

AzureBlobKnowledgeSourceParams

Указывает параметры среды выполнения для источника знаний о BLOB-объектах Azure

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

azureBlob

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

Дополнительные сведения.

type

string

Тип дополнительных сведений.

ErrorDetail

Подробности ошибки.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

FabricDataAgentKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний Fabric Data Agent

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

fabricDataAgent

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

FabricOntologyKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний Fabric Ontology

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

fabricOntology

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

FileKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний Файла

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

file

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

ImageServingStatistics

Статистика по подаче изображений во время активности по поиску.

Имя Тип Описание
imagesRetrieved

integer (int32)

Количество изображений, полученных из хранилища активов.

imagesSentToModel

integer (int32)

Количество изображений, отправленных в модель ниже по потоку.

totalImageSizeBytes

integer (int64)

Общий размер в байтах изображений, отправленных в модель.

verbalizationUsed

boolean

Указывает, использовалась ли вербализация изображения вместо прямого подачи изображения.

IndexedOneLakeKnowledgeSourceParams

Указывает параметры среды выполнения для индексированного источника знаний OneLake

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

indexedOneLake

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

IndexedSharePointKnowledgeSourceParams

Указывает параметры среды выполнения для индексированного источника знаний SharePoint

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

indexedSharePoint

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

IndexedSqlKnowledgeSourceParams

Задаёт параметры выполнения для индексируемого SQL-источника знаний

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

indexedSql

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

KnowledgeBaseActivityRecordType

Тип записи активности.

Значение Описание
searchIndex

Поисковая активность по поиску индекса.

azureBlob

Azure Blob retrieval activity.

indexedSharePoint

Индексированная активность поиска в SharePoint.

indexedOneLake

Индексированная активность по поиску OneLake.

web

Активность по поиску в интернете.

remoteSharePoint

Удалённая активность по поиску SharePoint.

workIQ

Активность по восстановлению WorkIQ.

fabricDataAgent

Активность по поиску Fabric Data Agent.

fabricOntology

Активность по поиску Fabric Ontology.

mcpServer

Активность по поиску серверов MCP.

file

Активность по извлечению файлов.

indexedSql

Индексированная активность по поиску SQL.

modelQueryPlanning

Активность по планированию запросов LLM.

modelAnswerSynthesis

Активность по синтезу ответов LLM.

modelWebSummarization

Активность по веб-резюме LLM.

agenticReasoning

Деятельность агентного рассуждения.

KnowledgeBaseAgenticReasoningActivityRecord

Представляет собой запись активности агентного рассуждения.

Имя Тип Описание
elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

reasoningTokens

integer (int32)

Количество входных токенов для агентных рассуждений.

retrievalReasoningEffort KnowledgeRetrievalReasoningEffort:

Конфигурация усилия рассуждения для поиска.

type string:

agenticReasoning

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseAzureBlobActivityArguments

Представляет аргументы, с которыми было выполнено действие извлечения BLOB-объектов Azure.

Имя Тип Описание
search

string

Строка поиска, используемая для запроса содержимого BLOB-объекта.

KnowledgeBaseAzureBlobActivityRecord

Представляет запись о действиях по получению BLOB-объектов Azure.

Имя Тип Описание
azureBlobArguments

KnowledgeBaseAzureBlobActivityArguments

Аргументы большого двоичного объекта Azure для действия извлечения.

count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

azureBlob

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseAzureBlobReference

Представляет собой справочник по документам хранилища BLOB-объектов Azure.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

blobUrl

string

URL-адрес большого двоичного объекта для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

searchSensitivityLabelInfo

PurviewSensitivityLabelInfo

Информация о метке чувствительности для референса.

sourceData

Исходные данные для справки.

type string:

azureBlob

Тип ссылки.

KnowledgeBaseErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

Дополнительные сведения.

type

string

Тип дополнительных сведений.

KnowledgeBaseErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

KnowledgeBaseErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

KnowledgeBaseErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

KnowledgeBaseFabricDataAgentActivityArguments

Представляет аргументы, с которыми выполнялась активность поиска Fabric Data Agent.

Имя Тип Описание
search

string

Поисковая строка, используемая для запроса к источнику знаний Fabric Data Agent.

KnowledgeBaseFabricDataAgentActivityRecord

Представляет собой запись активности поиска Fabric Data Agent.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

fabricDataAgentArguments

KnowledgeBaseFabricDataAgentActivityArguments

Агент данных Fabric аргументирует в пользу активности поиска.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

fabricDataAgent

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseFabricDataAgentReference

Представляет собой ссылку на документ Fabric Data Agent.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

dataAgentId

string

Идентификатор агента данных Fabric.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

type string:

fabricDataAgent

Тип ссылки.

workspaceId

string

Идентификатор рабочей области Fabric.

KnowledgeBaseFabricOntologyActivityArguments

Представляет аргументы, с которыми проводилась активность поиска Fabric Ontology.

Имя Тип Описание
search

string

Поисковая строка, используемая для запроса к источнику знаний Fabric Ontology.

KnowledgeBaseFabricOntologyActivityRecord

Представляет запись активности поиска Fabric Ontology.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

fabricOntologyArguments

KnowledgeBaseFabricOntologyActivityArguments

Аргументы Fabric Ontology в пользу активности поиска.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

fabricOntology

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseFabricOntologyReference

Представляет собой ссылку на документ Fabric Ontology.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

id

string

Идентификатор ссылки.

ontologyId

string

ID онтологии внутри рабочего пространства.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

type string:

fabricOntology

Тип ссылки.

workspaceId

string

Идентификатор рабочей области Fabric.

KnowledgeBaseFileActivityArguments

Представляет аргументы, с которыми выполнялась активность по извлечению файла.

Имя Тип Описание
search

string

Строка поиска, используемая для запроса содержимого файлов.

KnowledgeBaseFileActivityRecord

Представляет запись активности по извлечению файлов.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

fileArguments

KnowledgeBaseFileActivityArguments

Аргументы File для активности поиска.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

file

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseFileReference

Представляет собой ссылку на документ файла.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

docName

string

Название документа для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

type string:

file

Тип ссылки.

KnowledgeBaseImageContent

Содержание изображений.

Имя Тип Описание
url

string (uri)

URL-адрес изображения.

KnowledgeBaseIndexedOneLakeActivityArguments

Представляет аргументы, с которыми проводилась индексированная активность поиска OneLake.

Имя Тип Описание
search

string

Поисковая строка, используемая для запроса, индексировала содержимое OneLake.

KnowledgeBaseIndexedOneLakeActivityRecord

Представляет индексированную запись активности по поиску OneLake.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

indexedOneLakeArguments

KnowledgeBaseIndexedOneLakeActivityArguments

Индексированные аргументы OneLake в пользу активности поиска.

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

indexedOneLake

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseIndexedOneLakeReference

Представляет индексированную ссылку на документ OneLake.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

docUrl

string

URL-адрес документа для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

searchSensitivityLabelInfo

PurviewSensitivityLabelInfo

Информация о метке чувствительности для референса.

sourceData

Исходные данные для справки.

type string:

indexedOneLake

Тип ссылки.

KnowledgeBaseIndexedSharePointActivityArguments

Представляет аргументы, с которыми выполнялась индексированная активность поиска SharePoint.

Имя Тип Описание
search

string

Поисковая строка, используемая для запроса индексируемого содержимого SharePoint.

KnowledgeBaseIndexedSharePointActivityRecord

Представляет индексированную запись активности поиска в SharePoint.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

indexedSharePointArguments

KnowledgeBaseIndexedSharePointActivityArguments

Индексируемые аргументы SharePoint для активности поиска.

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

indexedSharePoint

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseIndexedSharePointReference

Представляет собой индексированный документ SharePoint.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

docUrl

string

URL-адрес документа для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

searchSensitivityLabelInfo

PurviewSensitivityLabelInfo

Информация о метке чувствительности для референса.

sourceData

Исходные данные для справки.

type string:

indexedSharePoint

Тип ссылки.

KnowledgeBaseIndexedSqlActivityArguments

Представляет аргументы, с которыми выполнялась индексированная активность поиска SQL.

Имя Тип Описание
search

string

Поисковая строка, используемая для запроса к индексированному SQL-содержимому.

KnowledgeBaseIndexedSqlActivityRecord

Представляет индексированную запись активности поиска SQL.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

indexedSqlArguments

KnowledgeBaseIndexedSqlActivityArguments

Индексированные SQL-аргументы для активности поиска.

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

indexedSql

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseIndexedSqlReference

Представляет ссылку на документ Azure SQL.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

docUrl

string

URL-адрес документа для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

type string:

indexedSql

Тип ссылки.

KnowledgeBaseMcpServerActivityArguments

Представляет аргументы, с которыми выполнялась активность по поиску MCP-сервера.

Имя Тип Описание
toolArguments

Аргументы передавались в инструмент сервера MCP.

toolName

string

Название инструмента сервера MCP, используемого для поиска данных.

KnowledgeBaseMcpServerActivityRecord

Представляет запись активности поиска сервера MCP.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

mcpServerArguments

KnowledgeBaseMcpServerActivityArguments

Аргументы сервера MCP в пользу активности поиска.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

mcpServer

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseMcpServerReference

Представляет ссылку на документ сервера MCP.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

title

string

Название результата MCP-серверного инструмента.

toolName

string

Название инструмента MCP-сервера, который создал эту ссылку.

type string:

mcpServer

Тип ссылки.

KnowledgeBaseMessage

Объект стиля сообщения на естественном языке.

Имя Тип Описание
content KnowledgeBaseMessageContent[]:

Содержимое сообщения.

role

string

Роль инструмента реакции.

KnowledgeBaseMessageContentType

Тип содержимого сообщения.

Значение Описание
text

Вид содержимого текстового сообщения.

image

Вид содержимого графического сообщения.

KnowledgeBaseMessageImageContent

Тип графического сообщения.

Имя Тип Описание
image

KnowledgeBaseImageContent

Содержание изображения.

type string:

image

Тип сообщения

KnowledgeBaseMessageTextContent

Тип текстового сообщения.

Имя Тип Описание
text

string

Текстовое содержимое.

type string:

text

Тип сообщения

KnowledgeBaseModelAnswerSynthesisActivityRecord

Представляет собой запись активности синтеза ответов LLM.

Имя Тип Описание
elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

inputTokens

integer (int32)

Количество входных токенов для действия синтеза ответов LLM.

modelName

string

Название модели, используемой для деятельности по синтезу ответов LLM.

outputTokens

integer (int32)

Количество выходных токенов для действия синтеза ответов LLM.

type string:

modelAnswerSynthesis

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseModelQueryPlanningActivityRecord

Представляет запись о планировании запроса LLM.

Имя Тип Описание
elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

inputTokens

integer (int32)

Количество входных маркеров для действия планирования запроса LLM.

modelName

string

Название модели, используемой для задачи планирования запросов LLM.

outputTokens

integer (int32)

Количество выходных маркеров для действия планирования запроса LLM.

type string:

modelQueryPlanning

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseModelWebSummarizationActivityRecord

Представляет запись активности по суммаризации веба в LLM.

Имя Тип Описание
elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

inputTokens

integer (int32)

Количество входных токенов для активности по суммаризации веб-LLM.

modelName

string

Название модели, используемой для деятельности по суммированию веба LLM.

outputTokens

integer (int32)

Количество выходных токенов для активности по суммаризации веба LLM.

type string:

modelWebSummarization

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseReferenceType

Тип ссылки.

Значение Описание
searchIndex

Поиск указателя по документу.

azureBlob

Azure Blob document reference.

indexedSharePoint

Индексируемый документ SharePoint.

indexedOneLake

Индексированная ссылка на документ OneLake.

web

Ссылка на веб-документы.

remoteSharePoint

Удалённая ссылка на документы SharePoint.

workIQ

Справка с документом IQ для работы.

fabricDataAgent

Ссылка на документ Fabric Data Agent.

fabricOntology

Ссылка на документ Fabric Ontology.

mcpServer

Ссылка на документ сервера MCP.

file

Файл документа.

indexedSql

Индексируемая ссылка на SQL-документы.

KnowledgeBaseRemoteSharePointActivityArguments

Представляет аргументы, с которыми выполнялась удалённая активность поиска SharePoint.

Имя Тип Описание
filterExpressionAddOn

string

Дополнение фильтрующего выражения для активности извлечения.

search

string

Поисковая строка, используемая для запроса к удалённому источнику знаний SharePoint.

KnowledgeBaseRemoteSharePointActivityRecord

Представляет собой удалённую запись активности поиска SharePoint.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

remoteSharePointArguments

KnowledgeBaseRemoteSharePointActivityArguments

Аргументы удалённого SharePoint для активности поиска.

type string:

remoteSharePoint

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseRemoteSharePointReference

Представляет собой удаленную ссылку на документ SharePoint.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

searchSensitivityLabelInfo

PurviewSensitivityLabelInfo

Информация о метке чувствительности для референса.

sourceData

Исходные данные для справки.

type string:

remoteSharePoint

Тип ссылки.

webUrl

string (uri)

URL-адрес, с которого были получены справочные данные.

KnowledgeBaseRetrievalRequest

Входной контракт для запроса на извлечение.

Имя Тип Описание
includeActivity

boolean

Указывает, что результаты извлечения должны содержать информацию о действиях.

intents KnowledgeRetrievalIntent[]:

KnowledgeRetrievalSemanticIntent[]

Список запросов, которые должны быть выполнены без планирования запросов модели.

knowledgeSourceParams KnowledgeSourceParams[]:

Список параметров времени выполнения для источников знаний.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов на выходе.

maxOutputSize

integer (int32)

Ограничивает максимальный размер содержимого на выходе.

maxOutputSizeInTokens

integer (int32)

Ограничивает максимальный размер содержимого на выходе.

maxRuntimeInSeconds

integer (int32)

Максимальное время работы в секундах.

messages

KnowledgeBaseMessage[]

Список вводимых сообщений в стиле чата.

outputMode

KnowledgeRetrievalOutputMode

Конфигурация выходных данных для этого извлечения.

retrievalReasoningEffort KnowledgeRetrievalReasoningEffort:

Конфигурация усилия рассуждения для поиска.

KnowledgeBaseRetrievalResponse

Выходной контракт для ответа на извлечение.

Имя Тип Описание
activity KnowledgeBaseActivityRecord[]:

Записи действий для отслеживания хода выполнения и последствий для выставления счетов.

references KnowledgeBaseReference[]:

Ссылки на данные извлечения, использованные в ответе.

response

KnowledgeBaseMessage[]

Ответные сообщения.

responseSensitivityLabelInfo

PurviewSensitivityLabelInfo

Информация о метке чувствительности для общего ответа.

KnowledgeBaseSearchIndexActivityArguments

Представляет аргументы, с которыми было выполнено действие извлечения индекса поиска.

Имя Тип Описание
filter

string

Строка фильтра.

search

string

Строка поиска, используемая для запроса индекса поиска.

searchFields

SearchIndexFieldReference[]

На каких полях проводились обыски.

semanticConfigurationName

string

Какая семантическая конфигурация была использована из поискового индекса?

sourceDataFields

SearchIndexFieldReference[]

Какие поля были выбраны для поиска?

KnowledgeBaseSearchIndexActivityRecord

Представляет запись о действиях извлечения из индекса поиска.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

searchIndexArguments

KnowledgeBaseSearchIndexActivityArguments

Аргументы поискового индекса для действия извлечения.

type string:

searchIndex

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

KnowledgeBaseSearchIndexReference

Представляет ссылку на документ Поиска Azure.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

docKey

string

Ключ документа для справки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

searchSensitivityLabelInfo

PurviewSensitivityLabelInfo

Информация о метке чувствительности для референса.

sourceData

Исходные данные для справки.

type string:

searchIndex

Тип ссылки.

KnowledgeBaseWebActivityArguments

Представляет аргументы, с которыми запускалась активность поиска в интернете.

Имя Тип Описание
count

integer (int32)

Количество вернутых веб-результатов.

freshness

string

Свежесть для активности по извлечению.

language

string

Язык для активности по поиску.

market

string

Рынок деятельности по поиску.

search

string

Поисковая строка, используемая для запроса в интернете.

KnowledgeBaseWebActivityRecord

Представляет собой запись активности поиска в веб-центре.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

web

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

webArguments

KnowledgeBaseWebActivityArguments

Веб-аргументы в пользу активности поиска.

KnowledgeBaseWebReference

Представляет собой ссылку на веб-документ.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

title

string

Заголовок веб-документа.

type string:

web

Тип ссылки.

url

string (uri)

URL-адрес, с которого были получены справочные данные.

KnowledgeBaseWorkIQActivityArguments

Представляет аргументы, с которыми выполнялась активность поиска WorkIQ.

Имя Тип Описание
search

string

Поисковая строка, используемая для запроса к источнику знаний WorkIQ.

KnowledgeBaseWorkIQActivityRecord

Представляет запись активности поиска WorkIQ.

Имя Тип Описание
count

integer (int32)

Количество извлеченных документов, которые были достаточно релевантными для того, чтобы преодолеть порог повторного ранжирования.

elapsedMs

integer (int32)

Затраченное время в миллисекундах для извлечения данных.

error

KnowledgeBaseErrorDetail

Сведения об ошибке, объясняющие, почему операция не удалась. Это свойство включается только в том случае, если действие не завершается успешно.

id

integer (int32)

Идентификатор записи о действии.

imageServing

ImageServingStatistics

Статистика о том, что изображения служат для этой активности по поиску

knowledgeSourceName

string

Источник знаний для действия по извлечению.

queryTime

string (date-time)

Время запроса для этого действия извлечения.

type string:

workIQ

Тип записи об активности.

warning

string

Предупреждающее сообщение, появляющееся о возможных проблемах конфигурации, таких как документы, отброшенные из-за порога баллов, усечения лимита токенов или условий тайм-аута.

workIQArguments

KnowledgeBaseWorkIQActivityArguments

Аргументы WorkIQ в пользу активности поиска.

KnowledgeBaseWorkIQReference

Представляет собой ссылку на документ WorkIQ.

Имя Тип Описание
activitySource

integer (int32)

Идентификатор исходного действия для ссылки.

attributions

WorkIQAttribution[]

Атрибуции для справки.

id

string

Идентификатор ссылки.

rerankerScore

number (float)

Оценка повторного ранкинга для ссылки на документ.

sourceData

Исходные данные для справки.

type string:

workIQ

Тип ссылки.

KnowledgeRetrievalIntentType

Тип используемой конфигурации базы знаний.

Значение Описание
semantic

Намерение семантического запроса на естественном языке.

KnowledgeRetrievalLowReasoningEffort

Выполняйте извлечение знаний с минимальными усилиями по рассуждениям.

Имя Тип Описание
kind string:

low

Своего рода попытка рассуждения.

KnowledgeRetrievalMediumReasoningEffort

Выполняйте извлечение знаний со средними усилиями на рассуждение.

Имя Тип Описание
kind string:

medium

Своего рода попытка рассуждения.

KnowledgeRetrievalMinimalReasoningEffort

Выполняйте извлечение знаний с минимальными усилиями по рассуждениям.

Имя Тип Описание
kind string:

minimal

Своего рода попытка рассуждения.

KnowledgeRetrievalOutputMode

Конфигурация выходных данных для этого извлечения.

Значение Описание
extractiveData

Возвращайте данные из источников знаний напрямую без генеративного изменения.

answerSynthesis

Синтезируйте ответ для полезной нагрузки ответа.

KnowledgeRetrievalReasoningEffortKind

Количество усилий, затрачиваемых во время извлечения.

Значение Описание
minimal

Не выполняет выбор источников, планирование запросов или итеративный поиск.

low

Используйте низкое рассуждение во время поиска.

medium

Используйте умеренное количество рассуждений во время поиска.

KnowledgeRetrievalSemanticIntent

Семантический запрос.

Имя Тип Описание
search

string

Семантический запрос для выполнения

type string:

semantic

Тип намерения.

KnowledgeSourceKind

Вид источника знаний.

Значение Описание
searchIndex

Источник знаний, который считывает данные из индекса поиска.

azureBlob

Источник знаний, который считывает и принимает данные из хранилища BLOB-объектов Azure в индекс поиска.

indexedSharePoint

Источник знаний, который считывает данные с индексируемого SharePoint Point.

indexedOneLake

Источник знаний, который читает данные с индексируемого OneLake.

indexedSql

Источник знаний, который извлекает и поглощает данные из База данных SQL Azure или Управляемый экземпляр SQL в поисковый индекс.

web

Источник знаний, который читает данные из интернета.

remoteSharePoint

Источник знаний, который считывает данные с удалённого SharePoint Point.

workIQ

Источник знаний, который считывает данные из рабочего IQ

file

Источник знаний, поддерживающий прямую загрузку и индексацию файлов.

mcpServer

Источник знаний, поддерживаемый сервером MCP (Model Context Protocol).

fabricDataAgent

Источник знаний, который получает данные из агента Fabric Data Agent.

fabricOntology

Источник знаний, который получает данные из онтологий Microsoft Fabric Ontology.

McpServerKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний сервера MCP

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

mcpServer

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

PurviewSensitivityLabelInfo

Информация о метке чувствительности, применяемой к документу

Имя Тип Описание
color

string

Цвет, который должен отображаться в пользовательском интерфейсе для метки, если это настроено.

displayName

string

Отображаемое имя метки конфиденциальности.

isEncrypted

boolean

Указывает, применяет ли метка конфиденциальности шифрование.

priority

integer (int32)

Приоритет, в котором применяется метка конфиденциальности.

sensitivityLabelId

string

Идентификатор метки конфиденциальности.

toolTip

string

Подсказка, которая должна отображаться для метки в пользовательском интерфейсе.

RemoteSharePointKnowledgeSourceParams

Указывает параметры среды выполнения для удаленного источника знаний SharePoint

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

filterExpressionAddOn

string

Условие фильтра, применяемое к источнику данных SharePoint. Он должен быть указан в синтаксисе языка запросов по ключевым словам. Он будет объединен в союз с выражением фильтра, указанным в определении источника знаний.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

remoteSharePoint

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

SearchIndexFieldReference

Поле для поискового индекса.

Имя Тип Описание
name

string

Имя поля.

SearchIndexKnowledgeSourceParams

Задает параметры времени выполнения для источника знаний индекса поиска

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

filterAddOn

string

Условие фильтра, применяемое к индексу (например, 'State eq VA').

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

searchIndex

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

WebKnowledgeSourceParams

Задает параметры времени выполнения для веб-источника знаний

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

count

integer (int32)

Количество возвращаемых веб-результатов.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

freshness

string

Свежесть веб-результатов.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

web

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

language

string

Язык результатов поиска в Интернете.

market

string

Рынок веб-результатов.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.

WorkIQAttribution

Информация об атрибуции для справочника WorkIQ.

Имя Тип Описание
seeMoreWebUrl

string (uri)

URL-адрес атрибута.

WorkIQKnowledgeSourceParams

Задаёт параметры выполнения для источника знаний WorkIQ

Имя Тип Описание
alwaysQuerySource

boolean

Указывает, что этот источник знаний должен обходить выбор источника и всегда запрашиваться во время извлечения.

enableImageServing

boolean

Указывает, следует ли включать предоставление изображений для этого источника знаний при получении информации. Когда это верно, изображения, извлечённые во время поглощения, передаются в последующие модели.

failOnError

boolean

Указывает, что весь запрос на поиск должен провалиться, если извлечение из этого источника знаний сталкивается с ошибкой. По умолчанию false.

includeReferenceSourceData

boolean

Указывает, должны ли ссылки включать структурированные данные, полученные во время извлечения, в свои полезные данные.

includeReferences

boolean

Указывает, следует ли включать ссылки для данных, полученных из этого источника.

kind string:

workIQ

Тип источника знаний.

knowledgeSourceName

string

Имя индекса, к которому применяются параметры.

maxOutputDocuments

integer (int32)

Ограничивает максимальное количество документов, возвращаемых из этого источника знаний.

rerankerThreshold

number (float)

Пороговое значение для повторного ранжирования, которому должны соответствовать все извлеченные документы, чтобы быть включенным в ответ.