コーディング エージェントを使用して Agent Framework アプリをビルドする

Note

.NET用の Microsoft Agent Framework ビルダー スキルはまだ利用できません。 .NET の入門チュートリアルと.NET サンプルを、.NET ビルダースキルの作業が追跡されている間に使用します。

agent-framework-builder-python を使用すると、互換性のあるコーディング エージェントに、Python Agent Framework ソリューションを構築するための Microsoft が保守するガイダンスを提供できます。 これは、コーディング エージェントが適切なパターンを選択し、タスクに焦点を当てたガイダンスを段階的に読み込むのに役立ちます。

スキルは以下を使った作業を支援できます。

  • プレーン エージェント、モデル プロバイダー、ツール、承認、セッション、履歴、コンテキスト プロバイダー。
  • 計画、todos、メモリ、圧縮、ファイル、バックグラウンド エージェント、シェル ツール、ループを備えたエージェントを活用します。
  • 関数型ワークフローとグラフワークフロー、組み込みのオーケストレーション、宣言型の定義。
  • 評価、可観測性、ミドルウェア、カスタム クライアント、カスタム エージェント、統合。
  • セルフホスティングと Microsoft Foundry hosted-agent の開発。

スキルはPython専用です。 外部コーディング エージェントに開発ガイダンスを提供します。これはPython パッケージではなく、pip install agent-frameworkによってインストールされず、Agent Framework アプリケーション内では実行されません。

Important

このコーディング エージェント スキルは、 ランタイム エージェント スキルとは異なります。 ランタイム スキルは、アプリケーションの実行中に Agent Framework エージェントによって読み込まれます。 ビルダー スキルは、コーディング エージェントがアプリケーションのソース コードを作成または変更するのに役立ちます。

Tip

ビルダー スキルと Microsoft Learn MCP サーバーをペアリングします。 このスキルは、コーディング エージェントに、焦点を絞った Agent Framework ワークフローと実装のガイダンスを提供しますが、Learn MCP Server では、現在のMicrosoftドキュメントを検索し、完全な記事を取得し、タスク中にコード サンプルを見つけることができます。 互換性のあるコーディング エージェントで、このパブリックで認証されていない Streamable HTTP エンドポイントを構成します。

https://learn.microsoft.com/api/mcp

[前提条件]

  • オープンなAgent Skills specificationをサポートするコーディング エージェント。
  • プレビュー コマンドを備えた gh skill、またはクロスエージェント skills CLI を使用する場合は Node.js 22.20 以降。
  • 新しい Agent Framework アプリケーションには Python 3.11 以降が必要です。 Agent Framework 1.23 は引き続き Python 3.10 をサポートしていますが、Python 3.10 はアップストリームでサポート終了になりました。

GitHub CLI スキル管理はプレビュー段階であり、変更される可能性があります。

GitHub CLI を使用して確認してインストール

リリースされたスキルをインストールする前にプレビューします。

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

タグ付けされた最新バージョンをインストール:

gh skill install microsoft/agent-framework agent-framework-builder-python

再現可能なガイダンスが必要な場合は、Python 1.23 リリースをピン留めしてください。

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

既定のインストールはプロジェクト スコープであり、非対話型の使用でGitHub Copilotを対象としています。 必要に応じ、サポートされている別のコーディング エージェントまたはユーザー スコープを選択します。

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

現在のクライアントとスコープのオプションについては、gh skill installを参照してください。

cross-agent skills CLI でインストール

別の方法として、クロスエージェント skills CLI を使用してスキルをインストールします。

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

インストールする前に、CLI で サポートされているコーディング エージェント とランタイム要件を確認してください。

スキルを活用しましょう

コーディング エージェントに自然に指示します。 互換性のあるクライアントは、そのメタデータからスキルを検出してアクティブ化します。ユニバーサル スラッシュ コマンドを前提にしないでください。

プロンプトの例:

  • Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with planning, todos, file access, and safe shell tooling.
  • Review this Python Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

わかっている場合は、モデル プロバイダー、ホスティング ターゲット、永続化要件、セキュリティ境界、サポートされている Python バージョンなどの制約を含めます。

コーディングエージェントが行うべきこと

このスキルは、コーディングエージェントに次のことを行うように指示します：

  • プレーンなエージェント、ハーネス、ワークフロー、オーケストレーション、宣言型の定義など、適切な最小のパターンを選択します。
  • 関連するフォーカスされている参照のみを読み込みます。
  • 揮発性の詳細については、現在の Microsoft Learn ガイダンス、パブリック API リファレンス、パッケージ ライフサイクル情報、メンテナンスされているサンプルを優先します。
  • すべての統合が安定しているか必要であると想定するのではなく、狭いパッケージ セットをインストールします。
  • 明示的なセッション、承認、認証、ホスティングの境界を保持します。
  • リポジトリの既存のテスト、型チェック、実行可能なサンプルを使用して、生成されたアプリケーションを検証します。

このスキルでは、生成されたコードが実稼働可能であることを保証しません。 承認前に、コーディング エージェントのプラン、パッケージの選択、セキュリティ境界、コマンド、および生成された変更を確認します。

バージョン付けと信頼

このスキルは、python-1.23.0 リポジトリ タグでリリースされた、Microsoft管理されたパブリックなコンシューマー スキルです。 そのスキル メタデータのバージョンは 0.3 です。

  • 最新のタグ付きリリースには、修飾なしの install コマンドを使用します。
  • 再現性が重要な場合は @python-1.23.0 をピン留めします。
  • @mainは、意図的に未リリースのガイダンスが必要な場合にのみ使用します。
  • インストール前にスキル コンテンツをプレビューし、新しいスクリプトまたは手順を信頼する前に更新内容を確認します。

ソースと重点参照については、次を参照してください。

次のステップ

最初のエージェントを作成する

より深く進む:

Note

Go 用の Microsoft Agent Framework ビルダー スキルはまだ利用できません。 現在のガイダンスについては、 Go の入門チュートリアル と Agent Framework Go の例 を使用してください。

  • 最終更新: