最終更新日: 2025-12-20
利用上の注意
このポストは Microsoft 社の Azure 公式ドキュメント(CC BY 4.0 または MIT ライセンス) をもとに生成AIを用いて翻案・要約した派生作品です。 元の文書は MicrosoftDocs/azure-ai-docs にホストされています。
生成AIの性能には限界があり、誤訳や誤解釈が含まれる可能性があります。 本ポストはあくまで参考情報として用い、正確な情報は必ず元の文書を参照してください。
このポストで使用されている商標はそれぞれの所有者に帰属します。これらの商標は技術的な説明のために使用されており、商標権者からの公式な承認や推奨を示すものではありません。
これらの更新は、ドキュメント内の設定および作成手順の明確化を目的としています。特に、Azure AI SearchおよびMicrosoft Foundryでのアクセス権の設定方法の詳細説明、ならびに知識ソースの作成方法の具体化に焦点を当てています。
今回のドキュメントの更新は、ユーザーの理解を助け、誤解を回避するためのものであり、システムの使用における設定と作成のプロセスをより明確に説明することに重きを置いています。
まず、アクセス設定の更新に関する変更では、ユーザーがAzure AI SearchとMicrosoft Foundryの両方で権限設定を行う必要性を強調しています。以前のバージョンでは「設定を選択する」というあいまいな指示にとどまっていましたが、具体的な手順を示し、ユーザーが混乱することなく明確に操作できるようにしています。
次に、知識ソースの作成に関する更新では、「他のタイプの知識ソースはプログラム的に作成する必要があります」という指示を通じて、ユーザーがどのようにアプローチすべきかを具体化しています。これにより、ユーザーは必要な技術的ステップを容易に理解し、誤った期待を持つことなく適切な開発手法を選択できるようになります。
これらの修正は、技術資料の整合性を高め、ユーザーエクスペリエンスを向上させる設計思想に基づいています。高い可読性と導線設計により、ユーザーは正式なシステムの使用方法を迅速に習得できるでしょう。
| Filename | Type | Title | Status | A | D | M |
|---|---|---|---|---|---|---|
| agentic-retrieval-how-to-create-pipeline.md | minor update | アクセス設定の更新方法の明確化 | modified | 1 | 1 | 2 |
| agentic-retrieval-overview.md | minor update | 知識ソースの作成方法の表現の明確化 | modified | 1 | 1 | 2 |
@@ -44,7 +44,7 @@ The following diagram shows the high-level architecture of this agentic retrieva
Before you begin, make sure you have permissions to access content and operations. We recommend Microsoft Entra ID authentication and role-based access for authorization. You must be an **Owner** or **User Access Administrator** to assign roles. If roles aren't feasible, you can use [key-based authentication](search-security-api-keys.md) instead.
-To configure access for this solution, select both of the following tabs.
+To configure access for this solution, you must set permissions in both Azure AI Search and Microsoft Foundry. Select both of the following tabs for service-specific guidance.
### [**Azure AI Search**](#tab/search-perms)
{
"modification_type": "minor update",
"modification_title": "アクセス設定の更新方法の明確化"
}この変更は、ドキュメント「agentic-retrieval-how-to-create-pipeline.md」におけるアクセス設定の方法についての内容を明確にするものです。具体的には、アクセスを構成する際に、ユーザーがAzure AI SearchとMicrosoft Foundryの両方で権限を設定する必要があることを強調しています。変更前は、単に「設定を選択する」という表現だったものが、権限の設定の重要性を伝えるために、「両方のタブでサービス固有のガイダンスを選択する」と具体的に記載されています。この更新は、より明瞭で正確な指示を提供し、ユーザーの理解を助けることを目的としています。
@@ -100,7 +100,7 @@ Your application drives the pipeline by calling the knowledge base and handling
To create an agentic retrieval solution, you can use the Azure portal, the latest preview REST APIs, or a preview Azure SDK package that provides the functionality.
-Currently, the portal only supports the creation of search index and blob knowledge sources. We recommend using a programmatic approach to create other types of knowledge sources.
+Currently, the portal only supports creating search index and blob knowledge sources. Other types of knowledge sources must be created programmatically.
### [**Quickstarts**](#tab/quickstarts)
{
"modification_type": "minor update",
"modification_title": "知識ソースの作成方法の表現の明確化"
}この変更は、ドキュメント「agentic-retrieval-overview.md」における知識ソースの作成方法に関する表現を明確にするものです。具体的には、ポータルが現在サポートしているのは検索インデックスとBlob知識ソースの作成のみであるとの説明が、より簡潔かつ直接的に修正されました。修正前の文は「他のタイプの知識ソースを作成するためにはプログラム的アプローチを使用することを推奨します」と述べていたのが、修正後は「他のタイプの知識ソースはプログラム的に作成する必要があります」と、より明確な指示が示されています。この更新により、ユーザーが必要なアクションを理解しやすくなることが期待されます。