亚马逊AWS官方博客
·
将 Kiro CLI 封装为 REST API：双通道架构实践
💡
原文中文，约5500字，阅读约需13分钟。
📝
内容提要
本文介绍了如何将 AWS 的 Kiro CLI 封装为标准 REST API，以解决其仅支持终端交互的问题。通过双通道架构设计，支持多轮会话与模型切换。核心挑战在于 ACP 协议的限制，无法在运行时切换模型。最终实现了两个 Python 文件，提供多种 API 接口，支持高效的 AI 编码能力。
🎯
关键要点
- Kiro CLI 是 AWS 推出的终端 AI 编码工具，原生只支持 stdio 交互，无法被程序化调用。
- 本文介绍将 Kiro CLI 封装为标准 REST API 的实现方案，核心产出为两个 Python 文件：acp_client.py 和 server.py。
- ACP 协议是 Kiro CLI 的双向通信机制，支持多轮会话和流式输出，但不支持运行时模型切换。
- 双通道架构设计用于解决 ACP 协议的限制，分别处理多轮会话和单次调用。
- REST API 接口提供多种功能，包括创建会话、发送任务和列出可用模型，但存在无鉴权和会话不持久化等限制。
- 最终实现的 REST API 支持多模型与多轮会话，核心难点在于理解协议的实际行为。
❓
延伸问答
Kiro CLI 是什么？
Kiro CLI 是 AWS 推出的终端 AI 编码工具，支持代码生成、分析与重构，但原生只支持终端用户交互。
如何将 Kiro CLI 封装为 REST API？
通过双通道架构设计，将 Kiro CLI 封装为标准 REST API，核心产出为两个 Python 文件：acp_client.py 和 server.py。
ACP 协议的主要限制是什么？
ACP 协议不支持运行时模型切换，这是 Kiro CLI 的协议设计限制，无法在多轮会话中指定模型。
双通道架构的设计目的是什么？
双通道架构用于解决 ACP 协议的限制，分别处理多轮会话和单次调用，以提高性能和灵活性。
REST API 提供了哪些功能？
REST API 提供创建会话、发送任务、列出可用模型等功能，但存在无鉴权和会话不持久化等限制。
实现 Kiro CLI REST API 的关键技术细节有哪些？
关键技术细节包括完整请求生命周期、权限请求的同步处理和文本内容的流式收集等。
➡️
