Azure AI Foundry SDK は、Azure での AI アプリケーションの開発を簡略化するように設計された包括的なツールチェーンです。 これにより、開発者は次のことが可能になります。
- 1 つのインターフェイスを使用して、さまざまなモデル プロバイダーから人気のあるモデルにアクセスする
- モデル、データ、AI サービスを簡単に組み合わせて、AI 搭載のアプリケーションを構築する
- 開発、テスト、運用環境全体でアプリケーションの品質と安全性を評価、デバッグして向上させる
Azure AI Foundry SDK は、連携するように設計されたクライアント ライブラリとサービスのセットです。
注
この記事は Foundry プロジェクトに適用されます。 ここで示すコードは、 ハブ ベースのプロジェクトでは機能しません。 詳細については、「 プロジェクトの種類」を参照してください。
[前提条件]
Azure サブスクリプション。 お持ちでない場合は、 無料アカウントを作成してください。
Foundry プロジェクト がまだない場合は作成します。
-
プロジェクトの [概要] セクションで Azure AI Foundry プロジェクト エンドポイントをコピーします。 これはすぐに使用します。
ヒント
Azure AI Foundry プロジェクト エンドポイントが表示されない場合は、ハブ ベースのプロジェクトを使用しています。 (プロジェクト の種類を参照)。 Foundry プロジェクトに切り替えるか、前の手順を使用して作成します。
プロジェクトへのアクセスに使用するのと同じアカウントを使用して、Azure CLI でサインインします。
az login
Unified Projects クライアント ライブラリ
Azure AI Foundry Projects クライアント ライブラリは、1 つのプロジェクト エンドポイントに接続することで複数のクライアント ライブラリを一緒に使用できる統合ライブラリです。
プロジェクト クライアント ライブラリをインストールする
pip install azure-ai-projects azure-identity
コードでプロジェクト クライアントを作成します。 プロジェクトの [概要] ページから Azure AI Foundry プロジェクト エンドポイントをコピーし、接続文字列の値を更新します。
from azure.identity import DefaultAzureCredential from azure.ai.projects import AIProjectClient project = AIProjectClient( endpoint="your_project_endpoint", # Replace with your endpoint credential=DefaultAzureCredential())
Von Bedeutung
この記事で "(プレビュー)" と付記されている項目は、現在、パブリック プレビュー段階です。 このプレビューはサービス レベル アグリーメントなしで提供されており、運用環境ではお勧めしません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。
これらのパッケージをインストール (プレビュー) に追加します。
com.azure.ai.projects
com.azure.core
コードでプロジェクト クライアントを作成します。 プロジェクトの [概要] ページから Azure AI Foundry プロジェクト エンドポイントをコピーし、接続文字列の値を更新します。
import com.azure.ai.projects.ProjectsClient; import com.azure.ai.projects.ProjectsClientBuilder; import com.azure.core.credential.AzureKeyCredential; String endpoint ="your_project_endpoint"; // Replace with your endpoint ProjectsClient projectClient = new ProjectsClientBuilder() .credential(new DefaultAzureCredential()) .endpoint(endpoint) .buildClient();
Von Bedeutung
この記事で "(プレビュー)" と付記されている項目は、現在、パブリック プレビュー段階です。 このプレビューはサービス レベル アグリーメントなしで提供されており、運用環境ではお勧めしません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。
依存関係をインストールする (プレビュー):
npm install @azure/ai-projects @azure/identity
コードでプロジェクト クライアントを作成します。 プロジェクトの [概要] ページから Azure AI Foundry プロジェクト エンドポイントをコピーし、接続文字列の値を更新します。
import { AIProjectClient } from '@azure/ai-projects'; import { DefaultAzureCredential } from '@azure/identity'; const endpoint = "your_project_endpoint"; // Replace with your actual endpoint const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
パッケージをインストールします。
dotnet add package Azure.Identity dotnet add package Azure.Core dotnet add package Azure.AI.Inference
コードでプロジェクト クライアントを作成します。 プロジェクトの [概要] ページから Azure AI Foundry プロジェクト エンドポイントをコピーし、接続文字列の値を更新します。
using Azure; using Azure.Identity; using Azure.AI.Inference; using Azure.Core; using Azure.Core.Pipeline; var endpointUrl = "your_project_endpoint"; // Replace with your actual endpoint var credential = new DefaultAzureCredential(); AzureAIInferenceClientOptions clientOptions = new AzureAIInferenceClientOptions(); BearerTokenAuthenticationPolicy tokenPolicy = new BearerTokenAuthenticationPolicy( credential, new string[] { "https://cognitiveservices.azure.com/.default" } ); clientOptions.AddPolicy(tokenPolicy, HttpPipelinePosition.PerRetry); var projectClient = new ChatCompletionsClient( endpointUrl, credential, clientOptions );
- プロジェクト エンドポイントを使用すると、次のことができます。
- Azure OpenAI を含む Foundry モデルを使用する
- Foundry Agent Service を使用する
- クラウドで評価を実行する
- アプリのトレースを有効にする
- 外部リソース接続のエンドポイントとキーを取得する
Azure AI Services クライアント ライブラリ
Azure AI サービスを使用するには、次のクライアント ライブラリと、プロジェクトホームページに一覧表示されているエンドポイントを使用できます。
C# でサポートされるサービス
サービス | 説明 | 参照ドキュメント |
---|---|---|
音声テキスト変換、テキスト読み上げ、翻訳、話者認識機能をアプリケーションに追加します。 | • Speech SDK for .NET • Speech NuGet パッケージ (Speech CLI) |
|
アプリケーションやサービスの有害なコンテンツを検出します。 | • Content Safety SDK for .NET • Content Safety NuGet パッケージ |
|
デジタル画像やリッチ メディア資産のコンテンツを分析します。 | • Vision SDK for .NET • Vision NuGet パッケージ |
|
自然言語理解機能を使用してアプリケーションを構築します。 | • .NET 用言語 SDK (テキスト分析) • 言語 NuGet パッケージ (テキスト分析) • Language SDK for .NET (質問への回答) • 言語 NuGet パッケージ (質問への回答) |
|
AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。 | • Translator SDK for .NET (テキスト) • Translator NuGet パッケージ (テキスト) • Translator SDK for .NET (バッチ) • Translator NuGet パッケージ (バッチ) |
|
ドキュメントをインテリジェントなデータ ドリブン ソリューションに変換します。 | • ドキュメント インテリジェンス SDK for .NET • ドキュメント インテリジェンス NuGet パッケージ |
|
AI を利用したクラウド検索をモバイルおよび Web アプリで実現できます。 | • Azure AI Search SDK for .NET • Azure AI Search NuGet パッケージ |
Java でサポートされるサービス
サービス | 説明 | 参照ドキュメント |
---|---|---|
音声テキスト変換、テキスト読み上げ、翻訳、話者認識機能をアプリケーションに追加します。 | • Speech SDK for Java • Speech Maven パッケージ |
|
アプリケーションやサービスの有害なコンテンツを検出します。 | • Content Safety SDK for Java • Content Safety Maven パッケージ |
|
デジタル画像やリッチ メディア資産のコンテンツを分析します。 | • Vision SDK for Java • Vision Maven パッケージ |
|
自然言語理解機能を使用してアプリケーションを構築します。 | • Java 用言語 SDK (テキスト分析) • Language Maven パッケージ |
|
AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。 | • Translator SDK for Java (テキスト) • Translator Maven パッケージ (テキスト) |
|
ドキュメントをインテリジェントなデータ ドリブン ソリューションに変換します。 | • Java 用ドキュメント インテリジェンス SDK • ドキュメント インテリジェンス Maven パッケージ |
|
AI を利用したクラウド検索をモバイルおよび Web アプリで実現できます。 | • Azure AI Search SDK for Java • Azure AI Search Maven パッケージ |
JavaScript でサポートされるサービス
サービス | 説明 | 参照ドキュメント |
---|---|---|
音声テキスト変換、テキスト読み上げ、翻訳、話者認識機能をアプリケーションに追加します。 | • Speech SDK for JavaScript • Speech npm パッケージ |
|
アプリケーションやサービスの有害なコンテンツを検出します。 | • JavaScript 用コンテンツセーフティSDK • コンテンツ セーフティ npm パッケージ |
|
デジタル画像やリッチ メディア資産のコンテンツを分析します。 | • Vision SDK for JavaScript • Vision npm パッケージ |
|
自然言語理解機能を使用してアプリケーションを構築します。 | • JavaScript 用言語 SDK (テキスト分析) • 言語 npm パッケージ |
|
AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。 | • Translator SDK for JavaScript (テキスト) • Translator npm パッケージ (テキスト) |
|
ドキュメントをインテリジェントなデータ ドリブン ソリューションに変換します。 | • JavaScript 用ドキュメント インテリジェンス SDK • ドキュメント インテリジェンス npm パッケージ |
|
AI を利用したクラウド検索をモバイルおよび Web アプリで実現できます。 | • Azure AI 検索 SDK for JavaScript • Azure AI Search npm パッケージ |
Python でサポートされているサービス
サービス | 説明 | 参照ドキュメント |
---|---|---|
音声テキスト変換、テキスト読み上げ、翻訳、話者認識機能をアプリケーションに追加します。 | • Speech SDK for Python • Speech PyPi パッケージ |
|
アプリケーションやサービスの有害なコンテンツを検出します。 | • Python 用のコンテンツセーフティSDK • Content Safety PyPi パッケージ |
|
デジタル画像やリッチ メディア資産のコンテンツを分析します。 | • Vision SDK for Python • Vision PyPi パッケージ |
|
自然言語理解機能を使用してアプリケーションを構築します。 | • Python 用言語 SDK (テキスト分析) • 言語 PyPi パッケージ (テキスト分析) • Python 用言語 SDK (質問への回答) • 言語 PyPi パッケージ (質問への回答) • Python 用言語 SDK (言語会話) • 言語 PyPi パッケージ (言語会話) |
|
AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。 | • Translator SDK for Python (テキスト) • Translator PyPi パッケージ (テキスト) • Translator SDK for Python (バッチ) • Translator PyPi パッケージ (バッチ) |
|
ドキュメントをインテリジェントなデータ ドリブン ソリューションに変換します。 | • Python 用ドキュメント インテリジェンス SDK • ドキュメント インテリジェンス PyPi パッケージ |
|
AI を利用したクラウド検索をモバイルおよび Web アプリで実現できます。 | • Azure AI Search SDK for Python • Azure AI Search PyPi パッケージ |