Microsoft 365 Agents SDK の概要

Microsoft 365 Agents SDK を使用すると、必要な通信を処理するためのスキャフォールディングを使用して、Microsoft 365 Copilot、Microsoft Teams、Web および Custom Apps などの任意のチャネルにデプロイ可能なエージェントを作成できます。 開発者は、任意の AI サービスを使用し、SDK のチャネル管理機能を使用して構築したエージェントを使用できるようにします。

Agents SDK の主な機能

開発者は、任意のプロバイダーまたはテクノロジ スタックのエージェントをエンタープライズ システムに統合する柔軟性が必要です。 Agents SDK は、任意の AI を使用してエージェント パターンの実装を簡略化し、特定の要件を満たすために 1 つ以上のサービス、モデル、またはエージェントを選択できるようにします。

Agents SDK を使用して次の手順を実行します。

1. 状態、ストレージ、およびアクティビティとイベントを管理する機能を使用して、エージェントの "コンテナー" をすばやく構築します。 Microsoft 365 Copilot や Microsoft Teams など、任意のチャネルにこのコンテナーをデプロイします。
2. 特定のテクノロジ スタックに制限されることなく、エージェント パターンを実装します。 Agents SDK は、選択した AI に依存しません。
3. Microsoft Teamsなど、クライアントの特定の動作に合わせてエージェントをカスタマイズします。

サポートされている言語

Agents SDK では、次の機能がサポートされます。

• .NET 8.0 SDK を使用した C#
• バージョン 18 以降 Node.js 使用する JavaScript
• Python 3.9 から 3.11

エージェントを作成する

Github から C#、JavaScript、または Python のスターター サンプルを簡単に入手できます

C# でエージェントを作成するには:

builder.AddAgent( sp =>
{
    var agent = new AgentApplication(sp.GetRequiredService<AgentApplicationOptions>());
    agent.OnActivity(ActivityTypes.Message, async (turnContext, turnState, cancellationToken) =>
    {
        var text = turnContext.Activity.Text;
        await turnContext.SendActivityAsync(MessageFactory.Text($"Echo: {text}"), cancellationToken);
    });
});

これにより、新しいエージェントが作成され、メッセージタイプのアクティビティを監視し、メッセージを返信します。

ここから、選択したカスタム AI サービス (Azure Foundry や OpenAI エージェントなど) とオーケストレーション (セマンティック カーネルなど) を追加できます。

重要な用語

SDK にとって重要ないくつかの具体的な概念は次のとおりです。

• ターン: ターンは、エージェントによって実行される作業単位です。 1 つのメッセージまたは一連のメッセージを指定できます。 開発者は "ターン" を操作し、それらの間のデータを管理します
• アクティビティ: アクティビティは、エージェントによって管理される 1 つ以上の種類のユニットです
• メッセージ: メッセージは、エージェントに送信されるアクティビティの一種です。 1 つのメッセージまたは一連のメッセージを指定できます。

開始する

作業を開始する前に、いくつかの前提条件を満たす必要があります。 前提条件は、アプリケーションの開発に使用している言語によって異なります。

ダウンロードしてインストールする

開始するために必要なファイルをダウンロードします。

次のステップ

• クイック スタート: C を使用して基本的なエージェントを作成してテストする#
• アクティビティ プロトコルについて