AgentKai - 智能AI代理系统

一个具有自主意识、长短期记忆、目标管理和自主决策能力的AI助手系统。AI助手的名字是"凯"(Kai)。

功能特点

• 🧠 长短期记忆管理 - 自动区分短期对话和长期重要信息
• 🎯 目标导向决策 - 根据设定的目标优先级进行规划决策
• 🤖 自主学习和适应 - 能保存和利用过往交互经验
• 🔍 自然语言搜索 - 通过语义理解查找相关记忆
• 🛠️ 工具调用能力 - 能根据需要使用专业工具完成任务
• 📊 完善的日志系统 - 支持多级日志控制，方便调试和使用

技术栈

• TypeScript + Node.js
• 向量数据库 (HNSW) 用于语义搜索
• 通义千问/OpenAI API 支持的大型语言模型
• 命令行工具库 Commander.js
• 异步处理和性能监控

安装

通过npm安装

# 全局安装CLI工具
npm install -g @agentkai/cli

# 作为项目依赖安装
# 核心功能
npm install @agentkai/core

# Node.js环境适配层（服务器端）
npm install @agentkai/node

# 浏览器环境适配层（前端）
npm install @agentkai/browser

# 全功能包（包含所有组件）
npm install @agentkai/core @agentkai/node

源码安装

# 克隆仓库
git clone https://github.com/Peiiii/agentkai.git
cd agentkai

# 安装依赖
pnpm install

# 构建所有包
pnpm build

# 全局链接CLI（开发测试用）
pnpm link-global

快速开始

环境要求

• Node.js >= 16
• TypeScript >= 4.5
• npm >= 7

配置

AgentKai支持多级配置管理，配置加载优先级（从高到低）：

1. 当前目录的.env文件
2. 用户主目录的.agentkai/config文件
3. 系统全局配置（/etc/agentkai/config或Windows下的%ProgramData%\agentkai\config）

首次使用时，可以通过以下命令创建默认配置：

# 创建默认用户配置文件
agentkai config --init

# 编辑配置文件
agentkai config --edit

主要配置项：

# AI模型配置
AI_API_KEY=your_api_key_here
AI_MODEL_NAME=qwen-max-latest
AI_MAX_TOKENS=2000
AI_TEMPERATURE=0.7
AI_BASE_URL=https://dashscope.aliyuncs.com/api/v1
AI_EMBEDDING_MODEL=text-embedding-v3

# 记忆系统配置
MEMORY_MAX_SIZE=1000
MEMORY_SIMILARITY_THRESHOLD=0.6

# 决策系统配置
DECISION_CONFIDENCE_THRESHOLD=0.7

命令行使用

通过全局安装后可直接使用命令行工具：

# 配置管理
agentkai config                       # 显示当前配置
agentkai config --init                # 初始化默认配置文件
agentkai config --edit                # 编辑配置文件
agentkai config --path                # 显示配置文件路径
agentkai config --get AI_TEMPERATURE  # 获取特定配置项
agentkai config --set AI_TEMPERATURE 0.8  # 设置配置项

# 聊天模式
agentkai chat

# 记忆管理
agentkai memory --list                  # 列出所有记忆
agentkai memory --add "这是新记忆内容"    # 添加新记忆
agentkai memory --search "搜索关键词"    # 搜索记忆
agentkai memory --remove 123           # 删除指定ID的记忆

# 目标管理
agentkai goals --list                  # 列出所有目标
agentkai goals --add "完成项目文档"      # 添加新目标
agentkai goals --progress 123 0.5      # 更新目标进度
agentkai goals --status 123 completed  # 更新目标状态

# 设置日志级别
agentkai --log-level debug chat           # 全局设置DEBUG级别
agentkai chat --debug                     # 仅对chat命令使用DEBUG级别
agentkai --log-level warn memory --list   # 使用WARN级别（减少输出）
agentkai --log-level silent goals --list  # 静默模式（仅输出命令结果）