Telegram AI Assistant Bot

Telegram AI Assistant Bot

site icon
2025.05.02 0
Python邮件管理表格操作网页搜索文档处理数学计算交流协作开发效率内容生成
Telegram AI Assistant Bot 是一个基于推理的AI代理,名为Cortex-R,通过Telegram与用户交互。它利用多个Model Context Protocol (MCP)服务器执行各种任务,包括网页搜索、文档处理、数学计算以及Google服务集成(如Gmail和Google Sheets)。该机器人支持`stdio`和`sse`传输协议与MCP服务器通信。
View on GitHub

Overview

基本能力

产品定位

Telegram AI Assistant Bot 是一个多功能的AI助手,旨在通过Telegram平台提供高效的任务自动化服务,涵盖邮件管理、表格操作、网页搜索、文档处理和数学计算等多种功能。

核心功能

  • Telegram集成:通过Telegram与用户交互,响应查询和任务。
  • 多MCP服务器支持
  • Gmail集成:管理邮件发送、阅读和删除。
  • Google Sheets集成:创建、更新和共享电子表格。
  • 网页搜索:使用DuckDuckGo进行搜索并获取网页内容。
  • 文档处理:支持语义搜索和索引。
  • 数学计算:执行数学运算。
  • 动态工具发现:初始化时自动从MCP服务器发现工具。
  • 可定制代理策略:支持保守、重试一次和探索所有等策略。
  • 内存管理:存储和检索任务相关记忆以增强能力。
  • 可配置角色:可调整语气、详细程度和行为。

适用场景

  • 邮件管理:通过Gmail服务器发送、阅读和管理邮件。
  • 表格操作:通过Google Sheets服务器创建和更新电子表格。
  • 信息检索:使用网页搜索服务器获取最新信息。
  • 文档处理:对文档进行语义搜索和索引。
  • 数学计算:快速执行复杂数学运算。

工具列表

  • Gmail Server:管理邮件操作。
  • Google Sheets Server:处理电子表格操作。
  • Web Search Server:执行网页搜索。
  • Document Processing Server:处理文档语义搜索。
  • Math Server:执行数学计算。

常见问题解答

  • 如何配置MCP服务器?:在config/profiles.yaml中定义服务器配置。
  • 如何设置环境变量?:在.env文件中设置GEMINI_API_KEY等变量。
  • 如何启动Telegram机器人?:使用uv run telegram_agent.py命令启动。

使用教程

使用依赖

  1. 克隆仓库: bash git clone <repository-url> cd <repository-folder>
  2. 同步依赖: bash uv sync

安装教程

  1. 设置环境变量:在.env文件中配置GEMINI_API_KEY等变量。
  2. 启动Telegram机器人: bash uv run telegram_agent.py

调试方式

  1. 检查.env文件中的变量是否正确设置。
  2. 确保所有MCP服务器配置文件profiles.yaml中的路径和URL正确。
  3. 使用日志功能检查机器人运行状态。

标签信息

  • 安装类型stdiosse
  • 产品定位邮件管理, 表格操作, 网页搜索, 文档处理, 数学计算
  • 归类交流协作, 开发效率, 内容生成

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。