机器人AI代理——Spring Boot+Spring AI+OpenAI+Telegram集成
Bot AI Agent是一个智能助手,由 Spring Boot, 春季AI,以及 开放人工智能,能够通过以下方式与用户交互:
- 一 REST API (HTTP端点),
- 或一个 电报机器人.
该代理旨在连接到内部 MCP服务器 它提供特定领域的数据(例如,员工、工资、资历等)。\ 用户可以自然地查询代理——它理解意图,从MCP服务器获取数据,并制定上下文答案。
______________________________________________________________________
主要特点
| 特性 | 描述 |
|---|---|
| AI助手 | 使用Spring AI+OpenAI进行对话理解和推理 |
| MCP服务器集成 | 使用内部API调用动态获取员工数据 |
| REST API | 公开端点以供外部集成和编程使用 |
| 电报机器人 | 与同一后端代理交互的自然聊天界面 |
| 模块化设计 | 单独的模块 bot-ai-agent 和 mcp-server |
| 可配置的秘密 | 通过环境变量或 application.properties |
______________________________________________________________________
项目结构
mcp-server/-实现MCP服务器的Spring Boot应用程序bot-ai-agent/-Spring Boot应用程序实现了与Telegram集成的AI Agent
______________________________________________________________________
运作原理
- 用户输入
- 用户通过以下方式发送消息 电报 或致电 REST API.
- 使用MCPTools进行人工智能推理
- 消息由处理 Spring AI,由一个 OpenAI模型. - AI代理分析意图(例如。, *“向我展示所有员工”* 或 *“爱丽丝的薪水是多少?”*).
- 数据获取(MCP服务器)
- AI Agent调用 MCP服务器 获取结构化数据(如员工记录)。
- 响应生成
- 代理制定一个人类可读的上下文响应(例如,解释、总结、故事)。
- 交付
- 响应通过Telegram发回或作为流返回。
______________________________________________________________________
Telegram机器人演示
对话示例:
运行项目
先决条件
- Java 21+
- 弹簧靴3+
- OpenAI API
- 电报机器人API
- 梅文
1–运行MCP服务器
cd mcp-server
mvn spring-boot:run
npx -y @modelcontextprotocol/inspector
# Transport Type: Streamable HTTP
# URL: http://localhost:8989/mcp
# Connection Type: Via ProxyMCP Server是一个Spring Boot应用程序,它实现了模型上下文协议(MCP)服务器功能。它提供有关员工的信息
MCP客户端(主应用程序)
# in main directory
mvn spring-boot:run它连接到MCP服务器,使用模型上下文协议(MCP)客户端获取和显示员工数据。 MCP客户端使用Spring Boot构建,并利用MCP客户端依赖关系与MCP服务器通信。
使用OpenAI的GPT-4 API,该应用程序可以根据提取的员工数据生成见解和摘要,或执行其他AI驱动的任务。 我们使用浏览器访问应用程序并提出以下问题:
http://localhost:8087/ai-agent/chat?query=raconte%20moi%20une%20histoire%20sur%20l%27avenir%20de%20l%27ia%20generative%20et%20les%20entreprise______________________________________________________________________
配置
1.环境变量
创建一个 .env 或使用以下配置您的环境:
OPENAI_API_KEY=sk-xxxxxxx
TELEGRAM_BOT_TOKEN=xxxxxxx许可证
这个项目是根据麻省理工学院许可证授权的——你可以随意使用和修改它。
