聊天助手工具

MCP聊天助手

一个使用MCP（模型上下文协议）的简单聊天应用程序，内置对话记忆和多种工具集成。

特性

• 🤖 AI助手：由Groq的Llama 3.3 70B型号提供动力
• 🧠 对话记忆：在对话中保持上下文
• 🔧 多种工具：浏览器自动化、网络搜索和Airbnb集成
• 💬 交互式聊天：实时对话界面
• 🛡️ 错误处理：强大的错误处理功能，并提供有益的建议

可用工具

• 浏览器自动化：导航、单击、键入网页并与之交互
• 网页搜索：使用DuckDuckGo搜索网络
• Airbnb集成：搜索住宿（可能受robots.txt限制）

安装

1. 克隆存储库:

   复制

   git clone <git@github.com:SHWACODING/Build-AI-Assistant-with-MCP.git>
   cd "Build An AI Assistant Using MCP"
   

2. 安装依赖项:

   复制

   uv add -r requirements.txt
   

3. 设置环境变量: 创建一个 .env 使用Groq API密钥提交：

   复制

   GROQ_API_KEY=your_groq_api_key_here
   

用法

运行应用程序

uv run app.py

可用命令

• exit 或 quit -结束对话
• clear -清除对话历史记录

交互示例

😎 YOU 👉 help
📋 Available Commands:
- 'exit' or 'quit': End the conversation
- 'clear': Clear conversation history

💡 Tips:
- Be specific with your requests
- For web searches, try: 'search for [topic]'
- For browser actions, try: 'open [website]'
- For travel info, try: 'find hotels in [city]'

😎 YOU 👉 search for best restaurants in New York
💭 Assistant 👉 I'll search for the best restaurants in New York for you...

😎 YOU 👉 open google.com
💭 Assistant 👉 I'll open Google's homepage for you...

最近修复

版本2.0-错误处理改进

已修复的问题：

1. 工具验证错误：修复了工具调用中的参数类型不匹配问题
2. Robots.txt屏蔽：为被屏蔽的网站添加了优雅的处理方式
3. 特工崩溃：改进了错误处理，以防止应用程序崩溃
4. 用户体验：添加了有用的错误消息和建议

主要改进：

• ✅ 自定义系统提示，以更好地使用工具
• ✅ 减少最大步数以防止无限循环
• ✅ 更好的错误分类和用户指导
• ✅ 妥善处理刀具故障
• ✅ 改进了日志记录配置
• ✅ 通过表情符号和清晰的消息传递增强用户界面

技术细节

错误处理：

• 捕获并分类不同类型的错误
• 根据错误类型提供具体建议
• 当工具不可用时，优雅的回退

工具使用指南：

• 在调用工具之前验证参数
• 使用适当的数据类型（计数为数字，文本为字符串）
• 优雅地处理robots.txt限制

内存管理：

• 内置对话记忆，用于上下文
• 在需要时清除历史记录的能力
• 适当清理资源

故障排除

常见问题

1. “robots.txt”错误：一些网站阻止自动访问

   • 解决方案：尝试不同的方法或在请求中更具体

2. 工具验证错误：参数类型不匹配

   • 解决方案：系统现在会自动处理此问题，但您可以尝试重新措辞

3. 超时错误：请求时间过长

   • 解决方案：尝试更简单的查询或等待重试

4. API关键问题：确保你的 .env 文件包含正确的GROQ_API_KEY

获取帮助

• 查看错误消息以获取具体指导
• 确保所有依赖项都已正确安装

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

贡献

请随时提交问题和增强请求！