使用 Microsoft 365 代理程式 SDK，您可以建立可部署至您選擇的管道的代理程式，例如 Microsoft 365 Copilot、Microsoft Teams、Web 和自訂應用程式等，並使用腳手架來處理所需的通訊。 開發人員可以使用他們選擇的 AI 服務，並使用 SDK 的通道管理功能提供他們建置的代理程式。
代理程式 SDK 的主要功能
開發人員需要靈活地將來自任何提供者或技術堆疊的代理程式整合到他們的企業系統中。 Agents SDK 使用他們選擇的 AI 簡化了代理模式的實施，允許他們選擇一個或多個服務、模型或代理來滿足他們的特定要求。
使用代理程式 SDK 可以：
- 快速建置具有狀態、儲存體以及管理活動和事件能力的代理程式「容器」。 跨任何通道部署此容器，例如 Microsoft 365 Copilot 或 Microsoft Teams。
- 實作代理模式，而不局限於特定技術堆疊。 Agents SDK 與您選擇的 AI 無關。
- 自定義您的代理程式以符合用戶端的特定行為，例如 Microsoft Teams。
支援的語言
代理程式 SDK 支援：
- 使用 .NET 8.0 SDK 的 C#
- 使用 Node.js 18 版及更高版本的 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 很重要的一些特定概念包括：
- 輪次：輪次是由代理人完成的工作單元。 它可以是單一訊息或一系列訊息。 開發人員將使用“輪次”並管理它們之間的數據
- 活動：活動是由代理程式管理的一或多種類型的單元
- 訊息：訊息是傳送給客服專員的一種活動類型。 它可以是單一訊息或一系列訊息。
開始
在開始之前，您需要注意一些先決條件。 必要條件取決於您用來開發應用程式的語言。
下載並安裝
下載開始所需的檔案。
將 代理程式 GitHub 儲存庫 複製到本機。 存放庫包含 SDK 來源程式庫和範例，可協助您開始使用 SDK 建置應用程式。 安裝範例會安裝 SDK 所需的套件。