基于 FastAPI 的智能访谈平台

多阶段 AI 访谈 应用
支持图片生成与访问保护

构建结构化对话流程,集成最新 AI 模型,支持图片生成与安全访问控制。 灵活配置、持久化存储,开箱即用的企业级解决方案。

5 阶段访谈
结构化对话流程
访问保护
可选口令验证
图片生成
集成多种 API

强大功能特性

为专业访谈场景设计,提供完整的对话管理与内容生成能力

多阶段访谈流程

支持 5 个独立的访谈阶段,每个阶段配备专属系统提示词,确保对话结构化、专业化的进行。

访问口令保护

可选的访问口令验证机制,有效防止公网环境下的未授权访问,保护对话隐私与数据安全。

多源图片生成

集成 DALL·E、Imagen、Gemini 等主流图片生成 API,支持灵活配置,为对话内容添加视觉元素。

灵活配置选项

支持 OpenAI 兼容的各种 API 提供商,轻松切换模型与服务提供商,满足不同场景需求。

持久化存储

访谈记录自动保存到本地,支持历史回顾与数据分析,确保对话内容永不丢失。

容器化部署

提供 Docker 与源码两种部署方式,支持快速启动与深度定制,适配各种运行环境。

快速部署指南

选择适合你的部署方式,几分钟内即可启动 AI 访谈应用

Docker 部署(推荐)

1
克隆项目
git clone <repository-url> && cd AI-Interview
2
配置环境变量
复制 .env.example 到 .env 并填写配置
3
启动服务
docker-compose up -d
4
访问应用
http://localhost:8000

源码部署(使用 uv)

1
安装 uv
使用官方脚本安装 Python 包管理器
2
创建虚拟环境
uv venv 并激活虚拟环境
3
安装依赖
uv pip install -r requirements.txt
4
启动应用
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

环境变量配置

变量名 必填 说明 默认值
OPENAI_API_KEY LLM API 密钥 -
OPENAI_BASE_URL LLM API 基础地址 https://api.newcoin.tech
OPENAI_MODEL 使用的模型名称 doubao-seed-2-0-pro-260215
IMAGE_API_KEY 图片生成 API 密钥 -
ACCESS_CODE 访问口令 -

API 端点

RESTful API 设计,易于集成与扩展

GET
/

前端页面入口

GET
/api/health

健康检查端点

POST
/api/chat

聊天接口

POST
/api/advance-stage

推进访谈阶段

POST
/api/verify-code

验证访问口令

GET
/docs

API 文档(Swagger UI)

常见问题

关于部署、配置和使用的常见疑问解答

需要什么技术栈来部署这个应用?
Docker 部署需要 Docker 和 Docker Compose。源码部署需要 Python 3.12+ 和 uv 包管理器。推荐使用 Docker 部署,更简单且环境隔离。
如何配置不同的 LLM 提供商?
在 .env 文件中设置 OPENAI_BASE_URL 为对应的 API 地址,OPENAI_API_KEY 为你的密钥。支持所有 OpenAI 兼容的提供商,如 Azure OpenAI、Anthropic Claude 等。
访谈记录存储在哪里?
所有访谈记录自动保存到 output 目录,以 JSON 格式存储。每个访谈会话生成独立的文件,便于备份和分析。
如何启用图片生成功能?
在 .env 文件中配置 IMAGE_API_KEY、IMAGE_API_BASE_URL 和 IMAGE_API_MODEL。支持 DALL·E、Imagen、Gemini 等多种图片生成服务。
访问口令是必须的吗?
不是必须的。如果将 ACCESS_CODE 留空,则不会启用访问验证。但对于公网部署,强烈建议设置访问口令以保护应用安全。

开始构建你的 AI 访谈应用

简单配置即可启动,支持多阶段对话、图片生成与安全访问控制