通过 CLI 使用 AI 集成 API

想象一个工作流，它允许开发人员专注于构建出色的应用程序，而不是陷入与第三方服务集成的细节中。如果其他东西可以为他们阅读和理解文档怎么办？

该工作流程即将到来。我们很高兴分享新 Superface CLI 的第一个技术预览。

CLI（我们亲切地称为 EDGAR）是一个强大的工具，允许开发人员直接从命令行与第三方 API 集成。旨在通过为开发人员提供强大的 AI 分析来帮助他们节省时间和精力，使他们能够使用他们想要集成的提供商的文档为他们的应用程序生成工作集成代码。

Superface CLI 是如何工作的

Superface 利用 AI 的力量来分析 API 文档。

目前，可以摄取使用开放 API 规范 (OAS) 文档定义或由 Readme.io 托管的 API，但我们很快将允许您以任何基于文本的格式提供您想要的任何文档。

下面我们直接从 GitHub 存储库中获取Resend.com电子邮件 API的 OAS 。

npm run ingest https://raw.githubusercontent.com/resendlabs/resend-openapi/main/resend.yaml

引入系统后，您可以通过说明您想要实现的用例来为所需的 API 创建工作集成代码。例如，“发送电子邮件”、“从 IP 地址返回地理位置”或“将英语翻译成捷克语”。

npm run resend "send an email" 

有了这个用例，Superface 将分析文档并制定一个计划，说明应该如何使用 API 来实现它。map 命令启动这个过程。

npm run map 

然后可以将该计划转化为可通过 Superface OneSDK 运行的工作集成代码。重要的是要强调这不是聊天机器人到代码，因为您对生成的文件具有完全类似代码的控制，并且可以根据需要编辑它们以调整输出。

此外，我们还包含一个特定命令，允许您针对您要使用的第三方 API 运行 CLI 生成的内容，以检查它是否有效并向您显示真正的成功或失败响应。

 

npm run execute ./email-communication/email-sending/email-communication.email-sending.resend.map.js

 

这将直接针对 API 运行 CLI 为您生成的代码，没有中间人或代理，并输出响应。

总的来说，创建您想要的集成只需 4 个步骤：

1. 将 API 文档提取到系统中。
2. 陈述所需的用例（例如“发送电子邮件”）。
3. Superface 将分析文档并生成如何调用 API 以实现用例的计划。
4. 该计划被转换为通过Superface OneSDK运行的工作集成代码。

此时，所有这些步骤都可以使用 CLI 完成，使用 AI 使您能够全面、快速地控制您的 API 集成工作流程。