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

Используйте это руководство для подключения внешнего ресурса Azure OpenAI или Foundry к ресурсу Службы "Понимание содержимого" и управления применением модели, используя подключенный ресурс. Эта настройка позволяет повторно использовать существующую емкость модели во всех ресурсах.

Общие сведения о потоке между ресурсами

Используйте эту высокоуровневую схему, чтобы понять, как Content Understanding использует подключенный ресурс для вывода модели.

+---------------------------------------------------------------+
| Azure subscription                                            |
|                                                               |
|  +---------------------------+                                |
|  | Content Understanding     |                                |
|  | resource                  |                                |
|  |                           |                                |
|  | defaults:                 |                                |
|  | gpt-4.1 -> connA/gpt41    |                                |
|  +-------------+-------------+                                |
|                |                                              |
|    analyze API | uses default deployment mapping              |
|                v                                              |
|  +---------------------------+                                |
|  | Connected resource        |                                |
|  | (Azure OpenAI or Foundry) |                                |
|  |                           |                                |
|  | deployments:              |                                |
|  | - gpt-4.1                 |                                |
|  | - text-embedding-3-large  |                                |
|  +---------------------------+                                |
|                                                               |
|  Authentication path: API key or Microsoft Entra ID           |
+---------------------------------------------------------------+

Необходимые условия

Чтобы приступить к работе, убедитесь, что у вас есть следующие ресурсы и разрешения:

• Активная подписка Azure. Если ее нет, создайте бесплатную учетную запись.
• Ресурс Microsoft Foundry, созданный в поддерживаемом регионе.
• Ресурс OpenAI или Foundry Azure с поддерживаемым завершением чата и внедрением развертываний. Для получения информации о требованиях к моделям и развертыванию см. раздел "Подключение ресурса 'Понимание содержимого' с моделями Foundry" и квоты и ограничения служб.
• Доступ к настройке обоих ресурсов на портале Azure, включая разрешения на создание подключенных ресурсов.
• Для аутентификации Microsoft Entra ID необходимо включить управляемое удостоверение в ресурсе обработки содержимого и назначить роль, такую как Cognitive Services User, в подключённом ресурсе. Для получения дополнительной информации см. Функции безопасности в Azure Content Understanding в инструментах Foundry.

Подключение ресурса Azure OpenAI или Foundry

Подключите ресурс модели из центра управления ресурса Content Understanding.

1. Откройте ресурс Content Understanding на портале Azure.

2. Выберите перейти на портал Azure AI Foundry.

3. Откройте центр управления.

4. Выберите подключенные ресурсы.

5. Выберите Новое подключение.

6. Выберите Azure OpenAI или Microsoft Foundry.

7. Найдите и выберите ресурс.

8. Выберите тип проверки подлинности и нажмите кнопку "Добавить подключение".

   Сведения о проверке подлинности:

   • Ключ API: Content Understanding использует ключ API из подключенного ресурса.
     • Подключенный ресурс должен разрешить проверку подлинности ключа API.
     • Если проверка подлинности ключа API отключена в подключенном ресурсе, запросы завершаются сбоем.
   • Microsoft Entra ID: Content Understanding использует управляемую идентификацию ресурса Content Understanding.
     • Активируйте управляемую удостоверенную идентичность в ресурсе Content Understanding.
     • Предоставьте управляемому удостоверению доступ к подключенному ресурсу, например Cognitive Services User.

   

   После завершения операции подключение появится в подключенных ресурсах.

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

Установите значения ресурсов по умолчанию, чтобы анализаторы могли использовать подключенное развертывание с форматом {ConnectionName}/{DeploymentName}.

Перед началом:

• Получите имя подключения из подключенных ресурсов.
• Получите имя развертывания из моделей и конечных точек в подключенном ресурсе.

Используйте API по умолчанию для задания развертываний моделей:

PATCH {endpoint}/contentunderstanding/defaults?api-version=2025-11-01
Content-Type: application/json

{
  "modelDeployments": {
    "gpt-4.1": "{ConnectionName}/{DeploymentName}",
    "text-embedding-3-large": "{ConnectionName}/{EmbeddingDeploymentName}"
  }
}

Проверка конфигурации

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

Вариант 1. Проверка с помощью Студии распознавания содержимого

1. Следуйте краткому руководству: испытайте Content Understanding Studio с использованием основного ресурса.
2. В Студии запустите предварительно созданный анализатор в примере файла.
3. Убедитесь, что анализ завершен и возвращает структурированные результаты в области результатов.

Вариант 2: Проверка с помощью быстрого начала работы с REST

1. Следуйте краткому руководству Quickstart: используйте возможность Azure для понимания содержимого в REST API инструментов Foundry.
2. Запустите пример запроса в отправке файла для анализа.
3. Убедитесь, что операция выполнена успешно, проверив результат анализа и удостоверившись, что status является Succeeded.

Если любой путь проверки завершается успешно, ресурс Content Understanding использует подключенную емкость между ресурсами.

Связанный контент

• Подключите свой ресурс Content Understanding к моделям Foundry
• Квоты и ограничения службы
• Поддержка языка и региона