semantic-kernel

Semantic Kernel

Semantic Kernel を使って構築されたアプリケーション、プラグイン、関数呼び出しフロー、または AI 連携を扱う際に、このスキルを使用してください。

実装に関するアドバイスは、記憶だけに頼らず、Semantic Kernel の最新のドキュメントとサンプルに基づいたものにしてください。

まず対象言語を判断する

推奨事項の提示やコードの変更を行う前に、使用する言語のワークフローを選択してください。

1. リポジトリに .cs、.csproj、.sln、またはその他の .NET プロジェクトファイルが含まれている場合、あるいはユーザーが C# または .NET に関するガイダンスを明示的に求めている場合は、.NET ワークフローを使用してください。references/dotnet.md に従ってください。
2. リポジトリに .py、pyproject.toml、requirements.txt が含まれている場合、あるいはユーザーが Python に関するガイダンスを明示的に求めている場合は、Python ワークフローを使用してください。references/python.md に従ってください。
3. リポジトリに両方のエコシステムが含まれている場合は、編集対象のファイルで使われている言語、またはユーザーが指定した対象言語に合わせてください。
4. 言語が不明確な場合は、まず現在のワークスペースを調べてから、最も適した言語固有のリファレンスを選択してください。

常に最新のドキュメントを参照する

• まず Semantic Kernel の概要を読みます。https://learn.microsoft.com/semantic-kernel/overview/
• 現在の API に関する情報は、公式のドキュメントとサンプルを優先してください。
• Microsoft Docs MCP ツールを利用できる場合は、最新のフレームワークに関するガイダンスとサンプルの取得に使用してください。

共通のガイダンス

どの言語で Semantic Kernel を扱う場合も、次の点に従ってください。

• カーネル操作には非同期パターンを使用してください。
• 公式のプラグインおよび関数呼び出しのパターンに従ってください。
• 明示的なエラー処理とログ記録を実装してください。
• 強い型付け、明確な抽象化、保守しやすいコンポジションパターンを優先してください。
• Azure AI Foundry、Azure OpenAI、OpenAI、その他の AI サービスには組み込みコネクターを使用し、新しいプロジェクトではタスクに適している場合、Azure AI Foundry サービスを優先してください。
• 解決策を簡素化できる場合は、カーネルのメモリおよびコンテキスト管理機能を使用してください。
• Azure 認証が適切な場合は、DefaultAzureCredential を使用してください。

ワークフロー

1. 対象言語を判断し、対応するリファレンスファイルを読みます。
2. 実装方針を決定する前に、最新の公式ドキュメントとサンプルを取得します。
3. このスキルに記載されている Semantic Kernel 共通のガイダンスを適用します。
4. 選択したリファレンスに記載されている、言語固有のパッケージ、リポジトリ、サンプルパス、コーディング慣行を使用します。
5. リポジトリ内のサンプルが現在のドキュメントと異なる場合は、その違いを説明し、現在サポートされているパターンに従います。

リファレンス

• .NET リファレンス
• Python リファレンス

完了基準

• 推奨事項が対象言語に合致していること。
• パッケージ名、リポジトリパス、サンプルの場所が選択したエコシステムに合致していること。
• ガイダンスが古い前提ではなく、Semantic Kernel の最新ドキュメントを反映していること。