AI待办事项聊天机器人

一款基于自然语言处理的AI待办事项管理工具,通过聊天界面实现任务增删改查及多轮对话。

  • by AlizaGhaffar
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 AlizaGhaffar/todo-ai-chatbot

使用说明

所有查特博特

一个由人工智能驱动的Todo聊天机器人,用户可以通过自然语言管理任务。使用OpenAI代理SDK(使用Gemini API后端)和MCP构建任务操作。

建筑

ChatKit (UI) → FastAPI (Backend) → OpenAI Agent → MCP Server → Neon PostgreSQL

快速开始

看 规格/001人工智能聊天机器人/quickstart.md 有关设置说明。

项目结构

backend/           # FastAPI server + Agent
├── src/
│   ├── api/       # FastAPI routes
│   ├── models/    # SQLModel models
│   ├── services/  # Agent and conversation logic
│   ├── auth/      # Better Auth configuration
│   └── db/        # Database connection and migrations
└── tests/

mcp/               # MCP Server (Official SDK)
├── src/
│   ├── server.py  # MCP server
│   └── tools/     # MCP tools (add, list, update, complete, delete)
└── tests/

frontend/          # ChatKit React UI
├── src/
│   ├── components/
│   └── services/
└── package.json

主要特点

  • 单聊天端点: POST /api/{user_id}/chat
  • 5个MCP工具:添加任务、列表任务、更新任务、完成任务、删除任务
  • 具有Neon PostgreSQL持久性的无状态后端
  • 自然多回合对话的对话语境

环境变量

# backend/.env
GEMINI_API_KEY=your-gemini-api-key
DATABASE_URL=postgresql+asyncpg://user:pass@host/db

# mcp/.env
DATABASE_URL=postgresql+asyncpg://user:pass@host/db

宪法

本项目遵循 .define/memory/constitution.md.