Visual Studio Codeでのエージェントの構成と管理

宣言型エージェント (Foundry ポータルまたは SDK を使用して作成) を作成すると、実際の作業が開始されます。要件に合わせて動作、手順、プロパティを構成します。 Microsoft Foundry VS Code 拡張機能は、ビジュアル エージェント デザイナーと直接 YAML ファイル編集の両方を通じて包括的な構成オプションを提供し、作業の柔軟性を提供します。

エージェントのプロパティの構成

エージェント デザイナーには、エージェントのコア プロパティを設定するための直感的なインターフェイスが用意されています。 これらの設定は、エージェントの動作と実行の基本的な側面を定義します。

基本的な構成オプション

エージェント デザイナーでは、いくつかの主要なプロパティを構成します。

エージェント名 - エージェント の目的を明確に識別するわかりやすい名前を入力します。 この名前は、リスト、ログ、および他の開発者がエージェントを操作するときに表示されます。

モデルの選択 - ドロップダウンからモデルのデプロイを選択します。 この選択により、エージェントの応答に影響する AI モデルが決まります。 ドロップダウンには、プロジェクトに既にデプロイ済みのモデルのみが表示されます。

説明 - エージェントが実行する内容の明確で簡潔な説明を追加します。 適切な説明は、チーム メンバーが指示やコードを読まずにエージェントの目的を理解するのに役立ちます。

システム命令 - エージェントの動作、性格、および応答スタイルを定義します。 ここでは、エージェントがそのロールを理解し、ユーザーと対話する方法を形成します。

エージェント ID - エージェント の作成時に拡張機能によって自動的に生成されます。 一意の識別子は、API を介してエージェントを使用するときに使用されます。

モデル構成オプション

モデルを選択するだけでなく、追加のパラメーターを使用してその動作を微調整できます。

温度 - 応答の創造性とランダム性を制御します。 値が小さい (0.1 から 0.3) と、一貫性のあるフォーカスされた出力が生成されます。 値が大きいほど (0.7 から 1.0)、よりクリエイティブで多様な応答が生成されます。 構造化タスクを処理するビジネス エージェントの場合、通常は 0.3 ~ 0.7 の値が適切に機能します。

Top P - 生成中にボキャブラリの選択肢を制限することで、多様性を制御します。 ほとんどのシナリオは既定値の 1.0 で適切に機能しますが、より制約された予測可能な出力に対しては、この値を小さくすることができます。

これらの設定はデザイナー インターフェイスと YAML ファイルの両方に表示され、両方のビューで同期されたままです。

エージェントの YAML 構造について

YAML ファイルには、宣言型エージェントのすべての構成が、構造化された読み取り可能な形式で含まれています。 この構造を理解すると、ビジュアル インターフェイスが最適でない場合に、正確な変更を行い、効率的に動作させることができます。

完全な YAML の例

完全に構成されたエージェント YAML ファイルを次に示します。

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: healthcare-assistant
description: Assists healthcare staff with patient appointment scheduling and information retrieval
id: 'agent-abc123xyz'
metadata:
  authors:
    - developer-name
  tags:
    - healthcare
    - customer-service
    - scheduling
model:
  id: 'gpt-4.1'
  options:
    temperature: 0.5
    top_p: 1
instructions: |
  You're a healthcare assistant helping staff schedule patient appointments and retrieve information.
  
  Your responsibilities:
  - Help staff find available appointment slots
  - Answer questions about patient scheduling policies
  - Provide information about different appointment types
  - Assist with rescheduling and cancellations
  
  Important guidelines:
  - Never access or share patient medical information
  - Always verify appointment details before confirming
  - Be professional but friendly in all interactions
  - If you're unsure about policies, advise staff to check with management
tools: []

YAML 構造体は、メタデータ、モデルの構成、命令、ツールというセクションに自然に分割されます。 この組織では、特定の設定を簡単に見つけて変更できます。

YAML 構成の利点

直接 YAML 編集には、いくつかの利点があります。

• バージョン管理 - アプリケーション コードと共に Git で変更を追跡する
• 一括更新 - 複数の変更を同時に確実に行う
• テンプレート - 一貫性のある構成のための再利用可能なエージェント テンプレートを作成する
• コード レビュー - 標準コード レビュー プロセスにエージェント構成を含める
• オートメーション - プログラムによってエージェント構成を生成または変更するスクリプトをビルドする

この拡張機能では、リアルタイムで YAML 構文が検証され、エラーが強調表示され、入力時に提案が提供されます。

エージェント構成のベスト プラクティス

より複雑なエージェントを構築する場合、これらのプラクティスは品質と信頼性の維持に役立ちます。

YAML ファイルのバージョン管理 - アプリケーション コードと共にエージェント構成を Git にコミットします。 これにより、ロールバック、コード レビュー、変更の追跡が可能になります。

わかりやすい名前とタグを使用する - 名前付けとタグ付けを明確にすると、コレクションの拡大に合わせてエージェントを簡単に見つけて識別できます。

複雑な命令を文書化 する - 特定の命令パターンまたは構成を選択した理由を説明するコメントを YAML ファイルに含めます。

すべての変更後にテスト する - 統合されたプレイグラウンドを使用して、構成を変更した後の動作を確認します。 小さな変更は、予期しない影響を及ぼす可能性があります。

単純な作業を開始し、繰り返し実行する - 基本的な手順から始めて、テスト結果に基づいて複雑さを追加します。 過度に複雑な初期命令はデバッグが困難です。

指示に集中する - 各エージェントには明確で具体的な目的が必要です。 エージェントが実行しようとする処理の数が多すぎると、一貫性がありません。

Visual Studio Codeでエージェントを構成すると、高度な自動化を作成するための強力な機能が提供されます。 ビジュアル デザイン ツールと直接 YAML 編集を組み合わせることで、運用環境のデプロイに必要な精度を維持しながら、迅速な開発が可能になります。