newpaw/ai-webchat

FastAPI集成OpenAI Assistant API应用

概述

本Docker镜像提供预配置环境，用于运行集成OpenAI Assistant API的FastAPI应用。应用采用Server-Sent Events（SSE）实现响应的实时流传输，支持与AI助手的交互式会话及实时数据处理，可灵活切换标准OpenAI或Azure OpenAI服务。

核心功能

• 多API支持：可配置使用标准OpenAI API或Azure OpenAI API
• 线程管理：创建、维护对话线程以保存上下文
• 实时流输出：通过SSE实现AI响应的实时推送
• 扩展预留：包含未来函数调用集成的占位符

使用场景

适用于智能客服、实时AI问答系统、AI辅助工具开发等需要实时交互式对话的场景，支持企业级Azure服务或标准OpenAI服务的灵活选择。

配置说明

前提条件

需在运行容器的目录下创建.env文件，填写必要的API凭证：

OPENAI_API_KEY=你的OpenAI密钥
OPENAI_ASSISTANT_ID=你的OpenAI助手ID
AZURE_OPENAI_API_KEY=你的Azure OpenAI密钥
AZURE_BASE_URL=你的Azure服务端点
AZURE_OPENAI_ASSISTANT_ID=你的Azure助手ID
USE_AZURE=False # 切换为True启用Azure服务

获取凭证步骤

标准OpenAI

1. 注册并登录OpenAI平台，进入API密钥页面生成密钥
2. 在助手页面创建AI助手并获取ID

Azure OpenAI

1. 登录Azure门户，创建OpenAI资源
2. 从资源页面获取API密钥和端点
3. 按Azure文档创建助手并获取ID

部署示例

拉取镜像

bash
docker pull newpaw/ai-webchat:v1.0

启动容器

bash
docker run -p 8000:8000 --env-file .env newpaw/ai-webchat:v1.0

端点测试

• 健康检查：curl http://localhost:8000/healthcheck
• 获取助手配置：curl http://localhost:8000/api/v1/assistant
• 创建线程：curl -X POST http://localhost:8000/api/v1/assistant/threads -H "Content-Type: application/json"
• 发送消息：

  bash
  curl -N -X POST \
  -H "Accept: text/event-stream" -H "Content-Type: application/json" \
  -d '{"text":"你好，请介绍自己","thread_id":"你的线程ID"}' \
  http://localhost:8000/api/v1/assistant/chat
  

许可证

采用MIT许可证分发，详见LICENSE文件。

致谢

感谢xbreid的技术贡献。