AI代理网关

AAI Gateway是一个统一管理和共享AI代理应用(Agent Apps)的交互网关,通过智能摘要和按需加载显著减少上下文令牌消耗,支持快速搜索和安装工具。

  • by gybob
  • TypeScript
  • 本地部署
  • 91 星标
  • 更新于
在 GitHub 查看 gybob/aai-gateway

使用说明

英语 | 简体中文 | 日本语 | 韩语


AAI网关:统一的MCP和技能管理,跨AI代理共享,节省99%的上下文令牌


这是什么

人工智能研究所 = 代理应用程序界面

AAI网关是代理应用程序的交互网关。

什么是A 代理应用程序?代理应用程序是代理可以使用的功能的集合。例如:

  • 一 MCP服务器 是一个代理应用程序——它提供了一组工具
  • A. 技能包 是一个代理应用程序——它提供了一种或多种技能

在AAI网关中,它们被抽象为 代理应用程序 统一管理。导入一次,所有AI代理都可以立即使用它们。


它解决了什么问题

上下文块

传统:10个MCP×5个工具= 50个完整模式≈7500个令牌 注入每一次谈话。

AAI网关:每个代理应用程序只需要 摘要少于50个令牌,细节按需加载。 99%的代币节省。

寻找工具很难

传统:搜索GitHub→ 阅读自述文件→ 复制JSON配置→ 调试连接→ 重新启动代理。

AAI网关: 告诉您的代理“使用AAI搜索xxx”--自动搜索、安装、即用.

“使用AAI搜索浏览器自动化工具”

→ 搜索→ 寻找剧作家MCP→ Agent总结了一行Agent应用程序摘要→ 安装→ 即用型,无需重新启动

“使用AAI搜索PPT创作技能”

→ 搜索→ 查找PPT技能→ 将技能描述用作代理应用程序摘要→ 安装→ 即用型,无需重新启动

重复配置

在Claude Code、Codex和OpenCode中分别配置相同的东西?通过AAI网关导入一次,所有代理立即共享。


快速启动(30秒)

克劳德代码:

claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway

食品法典:

codex mcp add aai-gateway -- npx -y aai-gateway

开源代码 --添加到 ~/.config/opencode/opencode.json:

{
  "mcp": {
    "aai-gateway": {
      "type": "local",
      "command": ["npx", "-y", "aai-gateway"],
      "enabled": true
    }
  }
}

开爪:

openclaw plugins install openclaw-aai-gateway-plugin

安装后,只需告诉您的代理您想做什么。


内置工具

工具 说明
search:discover 使用自然语言搜索和安装新工具
mcp:import 将MCP服务器作为代理应用程序导入
skill:import 将技能包作为代理应用程序导入
listAllAaiApps 列出所有已注册的代理应用
enableApp / disableApp 为每个代理启用或禁用代理应用程序
removeApp 删除代理应用程序
aai:exec 在代理应用程序中执行特定工具

每个导入的代理应用程序都会生成一个 app_<app-id> 调用时返回完整操作指南和工具列表的工具。

预设代理应用程序(本地安装时自动发现)

应用程序ID 名称 描述
claude Claude Code 用于代码编辑、分析和开发的AI编码助手
codex Codex 基于OpenAI的AI编码助手
opencode OpenCode 用于编辑文件和运行命令的AI开发助手

建筑


开发人员:自动发现您的代理应用程序

创建一个 aai.json 描述符并将其提交给 src/discovery/descriptors/当用户的本地环境满足以下条件时 discovery.checks 如果条件允许,代理将自动发现您的代理应用程序。

{
  "schemaVersion": "2.0",
  "version": "1.0.0",
  "app": {
    "name": { "default": "My App" }
  },
  "discovery": {
    "checks": [
      { "kind": "command", "command": "my-app" }
    ]
  },
  "access": {
    "protocol": "mcp",
    "config": {
      "command": "my-app-mcp",
      "args": ["--stdio"]
    }
  },
  "exposure": {
    "summary": "Use when the user wants to do X."
  }
}

discovery.checks 支持三种检查类型: command (命令存在), file (文件存在), path (目录已存在)。

支持的协议: mcp, skill, acp-agent

欢迎来到 提交PR 贡献新的代理应用描述符,或 打开一个问题 以获取反馈。