Intelligent Agent

🤖 智能助手代理

集Telegram、MCP服务器和向量知识库于一体的智能任务与项目管理代理。

🎯 用途

此代理旨在帮助开发人员和项目经理在以下方面：

• 任务与项目管理
• 在网上搜索信息
• 与GitHub仓库的工作
• 分析文件和项目结构
• 保存对话上下文

🔧 功能

Telegram机器人

• 团队 /start， /help， /health， /status
• 自然语言理解
• 对话的上下文记忆

MCP集成

1. GitHub - 搜索代码库，查看问题，分析项目
2. 网络搜索 - 在互联网上搜索最新信息
3. 文件系统 - 分析项目文件，代码搜索

记忆系统

• SQLite数据库用于存储对话
• 用户上下文和偏好
• 互动历史

知识向量库

• 用于语义搜索的FAISS
• 用于嵌入的Sentence Transformers
• 文档的自动索引

🚀 快速启动

初步要求

• Python 3.11及以上版本
• Docker 和 Docker Compose
• Telegram机器人令牌
• GitHub 个人访问令牌

1. 克隆仓库

git clone 
cd intelligent-agent

2. 配置设置

cp env.example .env
nano .env

填写必填参数：

TELEGRAM_BOT_TOKEN=your_telegram_bot_token
MCP_GITHUB_TOKEN=your_github_token
MCP_WEB_SEARCH_API_KEY=your_search_key

3. 使用Docker启动

# Сборка и запуск
docker-compose up -d

# Просмотр логов
docker-compose logs -f

4. 在服务器上启动

# Автоматическое развертывание
./deploy.sh

# Или ручная настройка systemd
sudo cp intelligent-agent.service /etc/systemd/system/
sudo systemctl enable intelligent-agent
sudo systemctl start intelligent-agent

📋 使用

机器人指令

• /start - 开始工作
• /help - 团队证明
• /health - 检查系统状态
• /status - 用户信息

查询示例

GitHub集成：

Покажи популярные Python репозитории
Найди issues в проекте microsoft/vscode
Проанализируй мой репозиторий

网络搜索：

Найди информацию о FastAPI
Что нового в Python 3.12?
Поиск лучших практик Docker

任务管理：

Создай задачу: изучить новый фреймворк
Покажи мои активные задачи
Обнови статус задачи

项目分析：

Проанализируй структуру проекта
Найди все Python файлы
Покажи статистику кода

🏗️ 建筑学

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Telegram Bot  │    │   Memory        │    │   Vector DB     │
│   Handler       │◄──►│   Manager       │◄──►│   (FAISS)       │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │    │   SQLite DB     │    │   Embeddings    │
│   (GitHub, Web, │    │   (Conversations│    │   (Transformers)│
│    File System) │    │    & Context)   │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

📁 项目结构

intelligent-agent/
├── src/
│   ├── __init__.py
│   ├── config.py          # Конфигурация
│   ├── memory_manager.py  # Управление памятью
│   ├── vector_db.py       # Векторная база знаний
│   ├── mcp_client.py      # MCP-клиент
│   └── telegram_bot.py    # Telegram обработчик
├── main.py                # Главный файл
├── requirements.txt       # Зависимости
├── Dockerfile            # Docker образ
├── docker-compose.yml    # Docker Compose
├── intelligent-agent.service # systemd сервис
├── deploy.sh             # Скрипт развертывания
└── README.md             # Документация

🔧 MCP服务器

1. GitHub 集成

• 搜索存储库
• 查看项目信息
• 分析问题和拉取请求
• 提交统计

2. 网络搜索

• 查找最新信息
• 新闻与文档
• 技术问题的解决方案
• DuckDuckGo API集成

3. 文件系统操作

• 项目结构分析
• 按类型搜索文件
• 阅读和分析代码
• 项目统计

💾 存储系统

组件

• 对话 - 存储对话
• 信息 - 单条消息
• 用户上下文 - 用户上下文
• 向量存储 - 语义搜索

特点

• 理解整个对话的上下文
• 用户个性化定制
• 自动清理旧数据
• 搜索聊天记录

🚀 部署

Docker（推荐）

# Простой запуск
docker-compose up -d

# С пересборкой
docker-compose up -d --build

# Остановка
docker-compose down

Systemd 服务

# Установка
sudo systemctl enable intelligent-agent
sudo systemctl start intelligent-agent

# Управление
sudo systemctl status intelligent-agent
sudo systemctl restart intelligent-agent
sudo systemctl stop intelligent-agent

自动部署

# Запуск скрипта развертывания
./deploy.sh

📊 监测

日志

# Docker логи
docker-compose logs -f

# Systemd логи
sudo journalctl -u intelligent-agent -f

# Файловые логи
tail -f logs/agent.log

健康检查

• 团队 /health 在Telegram上
• HTTP 端点（如已配置）
• Systemd 状态

🔒 安全性

• 用于密钥的环境变量
• Docker容器中的隔离
• 用户受限权限
• 安全存储令牌

🛠️ 开发

安装依赖项

pip install -r requirements.txt

以开发模式启动

python main.py

代码结构

• 模块化架构
• 异步编程
• 错误处理
• 日志记录

📈 性能

• 异步处理请求
• Redis中的缓存
• 优化的向量查询
• 有效的内存管理

🐛 调试

共同问题

1. 机器人没有回应

- 检查TELEGRAM_BOT_TOKEN - 确保机器人已启动

1. MCP错误

- 检查API令牌 - 检查网络连接

1. 记忆力问题

- 检查数据库文件的访问权限 - 清除旧数据

日志记录

import logging
logging.basicConfig(level=logging.DEBUG)

📝 许可证

麻省理工学院许可证（MIT License）

🤝 对项目的贡献

1. 仓库的分支（或译为：仓库的分叉）
2. 创建特性分支
3. 做出修改
4. 创建拉取请求

📞 支持

• 问题：
• 文档：README.md
• 日志： logs/agent.log

______________________________________________________________________

用心打造，助力高效项目管理