Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Это содержимое относится к: 🟩 версии 4.0 (GA)
Аналитика документов Azure в средстве Foundry — это облачная служба, использующая машинное обучение для анализа текста и структурированных данных из документов. Пакет средств разработки программного обеспечения для аналитики документов (SDK) — это набор библиотек и инструментов, которые позволяют легко интегрировать модели и возможности аналитики документов в приложения. Пакет SDK для аналитики документов доступен на разных платформах на языках программирования C#/.NET, Java, JavaScript и Python.
Поддерживаемые языки программирования
Пакет SDK для аналитики документов поддерживает следующие языки и платформы:
| Язык → версия SDK для анализа документов | Пакет | Поддерживаемая версия API | Поддержка платформы |
|---|---|---|---|
| .NET/C# → 1.0.0 (GA) | NuGet | 2024-11-30 (GA) | Windows, macOS, Linux, Docker |
| Java → 1.0.0 (GA | Репозиторий Maven | 2024-11-30 (GA) | Windows, macOS, Linux |
| JavaScript → 1.0.0 (GA) | npm | 2024-11-30 (GA) | Браузер, Windows, macOS, Linux |
| Python → 1.0.0 (GA) | PyPI | 2024-11-30 (GA) | Windows, macOS, Linux |
Дополнительные сведения о других версиях пакета SDK см. в следующих статье:
Поддерживаемые клиенты
В следующих таблицах представлена корреляция между каждой версией пакета SDK поддерживаемыми версиями API службы аналитики документов.
| Язык | Псевдоним пакета SDK | Версия API (по умолчанию) | Поддерживаемые клиенты |
|---|---|---|---|
| .NET/C# 1.0.0 (GA) | v4.0 (GA) | 2024-11-30 GA |
DocumentIntelligenceClient DocumentIntelligenceAdministrationClient |
| .NET/C# 4.1.0 | последняя версия 3.1 (GA) | 2023-07-31 |
DocumentAnalysisClient DocumentModelAdministrationClient |
| .NET/C# 4.0.0 | v3.0 (GA) | 2022-08-31 |
DocumentAnalysisClient DocumentModelAdministrationClient |
| .NET/C# 3.1.x | Версия 2.1 | Версия 2.1 |
FormRecognizerClient FormTrainingClient |
| .NET/C# 3.0.x | Версия 2.0 | Версия 2.0 |
FormRecognizerClient FormTrainingClient |
Использование пакета SDK аналитики документов в приложениях
Пакет SDK для аналитики документов позволяет использовать и управлять службой аналитики документов в приложении. Пакет SDK основан на базовом REST API аналитики документов, что позволяет легко использовать эти API в парадигме языка программирования. Вот как вы используете пакет SDK для аналитики документов для предпочитаемого языка:
1. Установите клиентскую библиотеку.
dotnet add package Azure.AI.DocumentIntelligence -Version 1.0.0
Install-Package Azure.AI.DocumentIntelligence -Version 1.0.0
2. Импортируйте клиентскую библиотеку пакета SDK в приложение.
using Azure;
using Azure.AI.DocumentIntelligence;
3. Настройте проверку подлинности.
Существует два поддерживаемых метода проверки подлинности:
Используйте ключ API аналитики документов с AzureKeyCredential из azure.core.credentials.
Используйте учетные данные токена из azure-identity для аутентификации в Microsoft Entra ID.
Использование ключа API
Вот где можно найти ключ API Document Intelligence в портале Azure:
Внимание
Мы рекомендуем использовать проверку подлинности с помощью Microsoft Entra ID и управляемые удостоверения для ресурсов Azure, чтобы не хранить учетные данные в ваших приложениях, работающих в облаке.
Если вы используете ключ API, сохраните его в другом месте, например в Azure Key Vault. Не включайте ключ API непосредственно в код и никогда не публикуйте его.
Дополнительные сведения о безопасности служб ИИ см. в статье "Проверка подлинности запросов к службам ИИ Azure".
//set `<your-endpoint>` and `<your-key>` variables with the values from the Azure portal to create your `AzureKeyCredential` and `DocumentIntelligenceClient` instance
string key = "<your-key>";
string endpoint = "<your-endpoint>";
AzureKeyCredential credential = new AzureKeyCredential(key);
DocumentIntelligenceClient client = new DocumentIntelligenceClient(new Uri(endpoint), new AzureKeyCredential(key));
Используйте учетные данные токена Microsoft Entra
Примечание.
Региональные конечные точки не поддерживают проверку подлинности Microsoft Entra. Создайте пользовательский поддомен для ресурса, чтобы применять этот тип проверки подлинности.
Авторизоваться проще всего с помощью DefaultAzureCredential. Он предоставляет учетные данные токена по умолчанию на основе текущей среды выполнения, которые позволяют обрабатывать большинство сценариев аутентификации Azure.
Ниже указано, как получить и использовать DefaultAzureCredential для приложений .NET.
Установите библиотеку Azure Identity для .NET:
dotnet add package Azure.IdentityInstall-Package Azure.IdentityЗарегистрируйте приложение Microsoft Entra и создайте новый субъект-службу.
Предоставьте доступ к Document Intelligence, назначив роль
Cognitive Services Userвашему субъекту-службе.Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента в приложении Microsoft Entra в качестве переменных среды:
AZURE_CLIENT_ID,AZURE_TENANT_IDиAZURE_CLIENT_SECRETсоответственно.Создайте экземпляр
DocumentIntelligenceClient, включивDefaultAzureCredential:string endpoint = "<your-endpoint>"; var client = new DocumentIntelligenceClient(new Uri(endpoint), new DefaultAzureCredential());
Дополнительные сведения см. в разделе"Проверка подлинности клиента".
4. Выполните сборку приложения.
Создайте клиентский объект для взаимодействия с пакетом SDK для Аналитики документов, а затем вызовите методы для этого клиентского объекта для взаимодействия со службой. Пакеты SDK предоставляют синхронные и асинхронные методы. Чтобы получить более полное представление, попробуйте руководство по быстрому началу на выбранном вами языке.
Варианты справки
Форумы Microsoft Q&A и форумы Stack Overflow доступны для сообщества разработчиков, чтобы задать и ответить на вопросы о аналитике документов Azure в средствах Foundry и других службах. Корпорация Майкрософт отслеживает форумы и отвечает на вопросы, на которые сообщество пока не ответило. Чтобы убедиться, что вы увидите ваш вопрос, используйте следующие теги.
Microsoft Q&A:Azure Document Intelligence.Stack Overflow:
azure-ai-document-intelligence.
Следующие шаги
Изучите операции REST API Интеллектуальной обработки документов 2023-10-31-rest.