通过 OpenAPI 为 AI 代理提供工具：Microsoft 语义内核代理的实践指南

[jrineakter]

通过 OpenAPI 为 AI 代理提供工具：Microsoft 语义内核代理的实践指南

步骤 3：配置语义内核代理。我们将此代理称为“SalesAgent”。
交易 ID 确认 InventoryService 的两个 API 均已被我们的 AI 代理成功调用！！

客座博客：在语义内核中构建具有多模型的多智能体系统 - 第 1 部分
索菲亚·拉格克兰斯·潘迪阿拉法特·德辛

今天，Semantic Kernel 团队很高兴欢迎我们的客座作者Akshay Kokane的回归。我们将请他深入探讨他最近在 Medium 上发表的有关 Semantic Kernel 的文章。

随着我们在人工智能世界中向代理方法迈进，我想分享我对语义内核如何帮助构建人工智能代理以及利用现有 API 创建智能代理的见解。

在之前的一篇文章中，我讨论了 Semantic Kernel 如何开发多智能体系统，为这些智能体营造一个协作环境，让它们可以交互并交付成果。在这篇新博文中，我很高兴地分享，通过使用 OpenAPI 规范，我们可以利用现有的 API 与智能体集成。这些被称为工具或插件，AI 智能体可以调用它们来获取上下文数据。

使用 Semantic Kernel，通过 OpenAPI 规范添加插件的过程变得简单。此外，这些插件会在需要时使用 OpenAI 工具调用自动触发。Semantic Kernel 消除了与工具调用相关的复杂性，通过消除对这些复杂性的关注，简化了 AI 代理的开发。

在这篇博文中，我将展示如何为电子商务平台 IT 主管经理电子邮件列表 创建基于聊天的应用程序，该应用程序通过集成其现有的支付服务 API 来管理客户付款。以下是通过 OpenApi 导入插件的高级步骤：


);
对于希望充分利用现有 API 而无需重新设计轮子的企业来说，这种方法具有变革意义。此外，OpenAPI 规范还为您的 AI 代理提供了微服务架构，从而便于在插件级别实现轻松的可扩展性和资源管理。

Semantic Kernel 提供了几种调用 API 的方法。博客中包含了一个非 Auth API 的简单示例，但也可以调用基于 Auth 的 API。有关更多信息，请参阅授予代理访问 OpenAPI API 的权限 | Microsoft Learn 的文档。有关更多详细信息，请阅读下面的完整文章。

通过 OpenAPI 为 AI 代理提供工具：Microsoft 语义内核代理的实践指南


我最近探索了如何利用 OpenAPI 规范为 AI 代理提供可操作的功能。在这篇博客中，我旨在分享我的见解并演示该过程。

了解 OpenAPI 规范
OpenAPI 规范 （以前称为 Swagger）是一种标准化、与语言无关的框架，用于定义 HTTP API。它允许人类和机器发现服务的功能，而无需访问其源代码或文档。正确定义的 OpenAPI 规范使消费者能够使用最少的实现逻辑与服务进行交互。 在此处了解更多信息。

为什么将 OpenAPI 与 AI 代理一起使用？
许多企业已经拥有强大的 API。随着对支持 AI 的应用程序的需求不断增长，使用基于 OpenAPI 的插件简化了使用现有 API 为 AI 代理赋能的过程。Semantic Kernel 与 OpenAPI 集成后，可为 AI 代理提供详细的 API 语义，包括端点描述、数据类型和预期响应。

例如，假设一个电子商务平台推出了一项名为 ShopChat.AI的新功能，客户可以与 AI 代理互动以查找和购买产品。AI 代理可以 通过 OpenAPI 规范利用现有的支付服务 API来处理付款并检查订单状态。

OpenAPI 与语义内核相结合的主要优势
将 OpenAPI 规范与 Semantic Kernel 和 Azure OpenAI 集成可带来许多优势：

1.简化的AI集成
OpenAPI 规范为 AI 代理理解和与现有 API 交互提供了一种标准化方法，从而无需复杂的自定义集成。

2. 增强代理功能
通过利用现有的 API，AI 代理可以处理各种任务，例如库存管理和支付处理，从而产生更加通用的应用程序。

3. 提高可扩展性
随着应用程序的发展，使用 OpenAPI 集成新 API 变得更加容易。这可确保您的 AI 代理能够随平台一起发展。

使用 OpenAPI 和语义内核构建 AI 驱动的应用程序

基于代理的应用程序示例
让我们考虑一个例子：假设您已经在使用电子商务平台的支付服务。该服务公开两个 API：

payment/accept：此 API 接受信用卡信息、处理付款并返回 transactionId。
payment/status：此API使用 transactionId 来检索付款状态。
现在，该电子商务网站正计划推出新功能“ShopeChat.AI”，您可以与 AI 代理互动，就像与实际店主互动一样，以找到最佳产品并购买该产品。

步骤 1：公开服务的 OpenAPI 规范
确保您的支付服务公开了 OpenAPI 规范。我在 .net 中执行此操作，因此在 .net 中，您可以使用 Swagger 公开 OpenAPI 规范。