Nasiko

Nasiko 是一个专为支持 A2A (Agent-to-Agent) 协议的 AI 代理设计的开源基础设施平台。它通过一个单一的控制平面进程，解决了多代理系统中的核心运维难题：路由、安全、密钥管理和可观测性。无需复杂的网关配置或边车模式，Nasiko 让开发者能够通过一条命令部署、保护并监控任何语言的代理集群。

核心价值：从混乱到有序

在运行多个代理时，开发者常面临“谁调用谁”、“密钥如何管理”、“调用成本多少”以及“失败原因何在”等痛点。Nasiko 通过以下方式彻底解决这些问题：

• 零信任安全架构：代理永远不可公开访问。所有流量（包括代理间调用）均通过 Nasiko 服务器代理，每一跳都经过 TLS 终止、认证、速率限制和 ACL 检查。
• 密钥隔离与加密：代理不再持有真实的 LLM API 密钥。Nasiko 提供短期身份令牌和虚拟 OPENAI_BASE_URL，由服务端解析真实密钥。所有静态密钥均使用 AES-256-GCM 加密存储。
• 端到端可观测性：每次调度和代理跳转都会生成标准的 OpenTelemetry (OTel) span，自动收集 token 使用和成本数据，实现全链路追踪。
• 智能路由引擎：采用三阶段流水线（嵌入相似性初选 → 上下文重排序 → LLM 最终选择），让调用方无需了解底层代理群的具体细节。

核心功能特性

技术架构

Nasiko 采用单一进程设计，作为所有代理间调用的唯一瓶颈点，以确保策略执行的一致性。

• 持久化层：Postgres (状态), Redis (缓存/流控), S3/RustFS (工件存储)。
• 可观测性栈：可选集成 Tempo, Loki 和 OTel Collector。
• 协议标准：严格遵循 A2A v1.0 规范（Linux 基金会最新上游版本 v1.0.1）。

快速开始（仅 Docker）

这是最简便的安装方式，无需安装 Rust 工具链。

1. 克隆与配置：

   git clone https://github.com/Nasiko-Labs/nasiko.git
   cd nasiko
   cp .env.example .env
   # 编辑 .env，设置 OPENAI_API_KEY 和 ADMIN_PASSWORD
   

2. 启动平台：

   docker compose up -d
   

   首次启动需编译 Rust 源码，耗时较长；后续启动极快。

3. 访问仪表板：
   打开 http://localhost:8080，使用默认账号 admin / changeme 登录。

⚠️ 重要注意事项

• 协议版本：Nasiko 硬编码要求 A2A-Version: 1.0 头。使用旧版（如 0.2.x, 0.3.0）规范的代理将被拒绝。
• Docker 要求：必须使用 Docker Compose V2 插件（docker compose 命令）。
• 开发环境：若需源码开发或热重载，需安装 Rust 1.85+ 及 just 工具。