このレッスンでは、このコースのコードサンプルを実行する方法を説明します。
リポジトリをクローンする前に、AI Agents For Beginners Discordチャンネルに参加してください。セットアップに関するヘルプやコースに関する質問、他の学習者との交流ができます。
まず、GitHubリポジトリをクローンまたはフォークしてください。これにより、コース教材の独自バージョンを作成し、コードを実行、テスト、調整することができます。
以下のリンクをクリックしてリポジトリをフォークできます:
リポジトリをフォークする
これで、以下のリンクにこのコースのフォーク版が作成されます:
このコースでは、AIエージェントを構築する実践的な経験を得るための一連のJupyter Notebookを提供しています。
コードサンプルは以下のいずれかを使用します:
GitHubアカウントが必要 - 無料:
1) Semantic Kernel Agent Framework + GitHub Models Marketplace (semantic-kernel.ipynbとしてラベル付け) 2) AutoGen Framework + GitHub Models Marketplace (autogen.ipynbとしてラベル付け)
Azureサブスクリプションが必要: 3) Azure AI Foundry + Azure AI Agent Service (azureaiagent.ipynbとしてラベル付け)
3つの例をすべて試してみて、自分に最適なものを見つけることをお勧めします。
選択したオプションに応じて、以下のセットアップ手順が異なります。
NOTE: Python3.12がインストールされていない場合は、インストールしてください。その後、python3.12を使用してvenvを作成し、requirements.txtファイルから正しいバージョンをインストールしてください。
例
Python venvディレクトリを作成:
python3 -m venv venv
次に、venv環境をアクティブ化します:
macOSおよびLinux
source venv/bin/activate
Windows
venv\Scripts\activate
このリポジトリのルートには、コードサンプルを実行するために必要なPythonパッケージを含むrequirements.txt
ファイルが含まれています。
以下のコマンドをターミナルでリポジトリのルートで実行することでインストールできます:
pip install -r requirements.txt
Python仮想環境を作成することをお勧めします。これにより、競合や問題を回避できます。
VSCodeで正しいバージョンのPythonを使用していることを確認してください。
このコースではGitHub Models Marketplaceを利用し、AIエージェントを構築するために使用する大規模言語モデル(LLM)への無料アクセスを提供します。
GitHub Modelsを使用するには、GitHub個人アクセストークンを作成する必要があります。
GitHubアカウントの個人アクセストークン設定に移動して作成できます。
トークンを作成する際は、最小権限の原則に従ってください。つまり、このコースのコードサンプルを実行するために必要な権限のみをトークンに付与するべきです。
開発者設定に移動し、画面左側のFine-grained tokens
オプションを選択します。
次に、Generate new token
を選択します。
トークンの目的を反映した説明的な名前を入力し、後で簡単に識別できるようにします。
🔐 トークンの有効期間の推奨
推奨期間: 30日
より安全な設定を希望する場合は、7日などの短期間を選択することもできます 🛡️
これは個人的な目標を設定し、学習の勢いを維持しながらコースを完了する素晴らしい方法です 🚀。
トークンのスコープをこのリポジトリのフォークに限定します。
トークンの権限を制限します: PermissionsタブでAccountをクリックし、”+ Add permissions”ボタンをクリックします。ドロップダウンが表示されます。Modelsを検索し、チェックボックスをオンにしてください。
トークンを生成する前に、必要な権限を確認してください。
トークンを生成する前に、パスワードマネージャーの保管庫など安全な場所にトークンを保存する準備ができていることを確認してください。生成後は再表示されません。
作成した新しいトークンをコピーしてください。このトークンをこのコースに含まれる.env
ファイルに追加します。
.env
ファイルを作成するターミナルで以下のコマンドを実行して.env
ファイルを作成します。
cp .env.example .env
これにより、例のファイルがコピーされ、ディレクトリ内に.env
ファイルが作成されます。このファイルに環境変数の値を入力します。
コピーしたトークンを使用して、お気に入りのテキストエディタで.env
ファイルを開き、GITHUB_TOKEN
フィールドにトークンを貼り付けます。
これで、このコースのコードサンプルを実行できるようになります。
Azure AI Foundryでハブとプロジェクトを作成する手順については、ハブリソースの概要を参照してください。
プロジェクトを作成したら、プロジェクトの接続文字列を取得する必要があります。
これは、Azure AI Foundryポータルのプロジェクトの概要ページに移動することで行えます。
.env
ファイルを作成するターミナルで以下のコマンドを実行して.env
ファイルを作成します。
cp .env.example .env
これにより、例のファイルがコピーされ、ディレクトリ内に.env
ファイルが作成されます。このファイルに環境変数の値を入力します。
コピーしたトークンを使用して、お気に入りのテキストエディタで.env
ファイルを開き、PROJECT_ENDPOINT
フィールドにトークンを貼り付けます。
セキュリティのベストプラクティスとして、Microsoft Entra IDを使用してAzure OpenAIに認証するためにキーなし認証を使用します。
次に、ターミナルを開き、az login --use-device-code
を実行してAzureアカウントにサインインします。
ログイン後、ターミナルでサブスクリプションを選択します。
エージェント型RAGレッスン - レッスン5 - では、Azure SearchとAzure OpenAIを使用するサンプルがあります。
これらのサンプルを実行するには、以下の環境変数を.env
ファイルに追加する必要があります:
AZURE_SUBSCRIPTION_ID
- プロジェクトの概要ページのプロジェクト詳細を確認してください。
AZURE_AI_PROJECT_NAME
- プロジェクトの概要ページの上部を確認してください。
AZURE_OPENAI_SERVICE
- 概要ページの含まれる機能タブでAzure OpenAI Serviceを確認してください。
AZURE_OPENAI_RESOURCE_GROUP
- 管理センターの概要ページでプロジェクトプロパティを確認してください。
GLOBAL_LLM_SERVICE
- 接続されたリソースの下でAzure AI Services接続名を確認してください。リストされていない場合は、リソースグループ内のAI Servicesリソース名をAzureポータルで確認してください。
AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
- 埋め込みモデル(例: text-embedding-ada-002
)を選択し、モデル詳細からデプロイメント名を確認してください。
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
- チャットモデル(例: gpt-4o-mini
)を選択し、モデル詳細からデプロイメント名を確認してください。
AZURE_OPENAI_ENDPOINT
- Azure AI Servicesを探し、それをクリックしてリソース管理、キーとエンドポイントに移動し、「Azure OpenAIエンドポイント」をスクロールして「言語API」をコピーしてください。
AZURE_OPENAI_API_KEY
- 同じ画面からKEY 1またはKEY 2をコピーしてください。
AZURE_SEARCH_SERVICE_ENDPOINT
- Azure AI Searchリソースを見つけ、それをクリックして概要を確認してください。
AZURE_SEARCH_API_KEY
- 次に設定、キーに移動して、プライマリまたはセカンダリ管理キーをコピーしてください。
AZURE_OPENAI_API_VERSION
- APIバージョンライフサイクルページの最新GA APIリリースを参照してください。資格情報をハードコードする代わりに、Azure OpenAIとのキーなし接続を使用します。そのためにDefaultAzureCredential
をインポートし、後でDefaultAzureCredential
関数を呼び出して資格情報を取得します。
from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
セットアップを実行する際に問題がある場合は、Azure AI Community Discordに参加するか、問題を作成してください。
これで、このコースのコードを実行する準備が整いました。AIエージェントの世界についてさらに学びましょう!
免責事項:
この文書は、AI翻訳サービスCo-op Translatorを使用して翻訳されています。正確性を追求しておりますが、自動翻訳には誤りや不正確な部分が含まれる可能性があることをご承知ください。元の言語で記載された文書が正式な情報源とみなされるべきです。重要な情報については、専門の人間による翻訳を推奨します。この翻訳の使用に起因する誤解や誤解釈について、当方は責任を負いません。