亚马逊AWS官方博客
·
将 Kiro CLI 封装为 REST API：双通道架构实践
内容提要
本文介绍了如何将 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 在多轮会话和模型切换方面的限制。通过将 ACP 通道与 Chat 通道分开，用户可以在需要高效多轮对话时优先使用 ACP 通道，而在需要指定模型时再切换到 Chat 通道。这种灵活性使得开发者能够根据具体需求选择最合适的调用方式，提升了整体的使用体验和性能。
ACP 协议的局限性
尽管 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 的关键技术细节有哪些？
关键技术细节包括完整请求生命周期、权限请求的同步处理和文本内容的流式收集等。
