Newshot

Show HN:面试官助手——AI 开源项目

Translation(model translation, not the source's own text)

AI 面试助手

题图
题图

一个面向面试官的 AI 助手。一个机器人加入面试视频通话(目前是 Microsoft Teams,Zoom 或 Google Meet 即将支持),旁听,并在一个 web 应用中私下指导面试官:实时转写文本、对每个回答打分(正确性、深度、清晰度、相关性,并引用表达薄弱的语句、给出更好的回答建议),以及接下来可以追问的问题。该助手从不在会议中发言,只有面试官能在 web 应用中看到这些指导。

会议接入和实时转写由 Recall.ai 提供。AI 分析使用 Anthropic Claude 和 Azure OpenAI 模型。本仓库包含调度机器人、接收转写文本并运行 AI 的后端,以及面试官使用的 web 应用。

同意至关重要。一个可见的机器人会加入通话,会议会被录制并转写。任何运行此系统的人都必须告知每一位参与者并事先取得他们的许可,并遵守适用于他们的录制与隐私法律。数据由 Recall.ai 和你的 AI 提供商处理,并存储在你自己的数据库中。你需自行承担运行风险;请参阅应用内的条款与隐私页面(web/src/pages/Legal.tsx)并根据你的情况调整。

先读这里:风险以及你可以如何帮忙

  • 由 vibe-coding 生成、开源、使用风险自负。本应用很大程度上是在 AI 辅助下构建的。我尽力弥补了缺口(有测试,登录、访问控制和 webhook 验证都经过审查),但它尚未经过独立的安全审计,肯定存在 bug。不要将其评分或建议作为招聘决策的依据,也不要依赖它来保存或恢复数据(参见应用内的条款)。
  • 取得同意。告知候选人和通话中的每个人,一个机器人将加入,会议会被录制、转写并由 AI 分析,并事先取得他们的许可。
  • 它是自托管的,而且由我付费。托管实例运行在我自己的基础设施上:我支付会议机器人(Recall.ai)和 AI 模型的费用。如果它对您的面试有帮助,请考虑贡献:通过应用内的 Stripe 随心付费($5、$7 或 $10)。没有任何功能以此作为门槛。应用会在面试设置表单下方显示一行小的、可选的“觉得有用?”文字,并在 Interviews 页面显示一张卡片;$ 金额仅在设置了 STRIPE_SECRET_KEY 时出现。在您自己的面试中试用,并将 bug 或粗糙之处作为 GitHub issue 报告。通过 pull request 贡献代码、测试、文档或修复,或帮助维护它。使用您自己的 Recall.ai、Infra 和 AI 密钥运行您自己的副本(见下文)。
  • 通过应用内的 Stripe 随心付费($5、$7 或 $10)。没有任何功能以此作为门槛。应用会在面试设置表单下方显示一行小的、可选的“觉得有用?”文字,并在 Interviews 页面显示一张卡片;$ 金额仅在设置了 STRIPE_SECRET_KEY 时出现。
  • 在您自己的面试中试用,并将 bug 或粗糙之处作为 GitHub issue 报告。
  • 通过 pull request 贡献代码、测试、文档或修复,或帮助维护它。
  • 使用您自己的 Recall.ai、Infra 和 AI 密钥运行您自己的副本(见下文)。

文档:方案 · 托管与 DNS · 入站电子邮件 · Recall 集成 · 数据与备份 · 端到端流程 · 为什么不用我们自己的 Teams 机器人。

你需要什么

需求原因是否必需?
Node.js 24 和 npm(Docker 镜像所用的版本)运行后端和 Web 应用是
Recall.ai 账户和 API key加入会议并流式传输转录内容的 bot用于真实会议(本地开发不需要)
Anthropic API key 和/或 Azure OpenAI 资源为回答打分并建议问题的 AI用于辅导功能
Microsoft Entra 应用注册“使用 Microsoft 登录”用于真实登录(本地开发不需要)
后端的公网 HTTPS URLRecall 和 SendGrid 向其投递 webhook(测试时可用 ngrok 之类的隧道)用于真实会议
SendGrid 账户 + 一个子域名可选:让人们通过电子邮件邀请 bot( iv-<alias>@your-subdomain )可选
Stripe 账户可选的“支持我们”付款可选
装有 Docker 的 Linux VM生产环境托管(Caddy 提供自动 HTTPS)用于生产环境

工作原理


        interviewer adds [email protected] to the meeting invite
        │  (no mailbox: the subdomain's MX record points at SendGrid)
SendGrid Inbound Parse ──POST──►  backend /inbound/sendgrid/<secret>
                      │  parse link (Teams/Zoom/Meet) + calendar data, match alias → paid interview
                      ▼
                 Recall: create bot (scheduled for the start time, or immediate)
                      │
 meeting ◄──joins──  Recall bot ──live transcript + status──►  backend /webhooks/recall  (HMAC-verified)
                                                                   │
                                                                   ▼
                                                    status tracking, transcript segments → coaching (next)
      

目录结构

路径内容状态
backend/TypeScript(Fastify)。接收邀请邮件、Recall 客户端、bot 调度、webhook 接收、实时 AI 辅导与评分、SQLite 持久化已测试;已端到端实测验证
web/React + Vite 单页应用:Microsoft 登录、面试设置、实时转录、评分和建议问题已构建
deploy/Docker Compose:后端 + Caddy(自动 HTTPS)、每晚数据库备份已用于生产环境
infra/sendgrid/用于创建 SendGrid Inbound Parse 主机的脚本已编写
infra/azure/provision.sh :资源组 + Key Vault已使用
teams-app/可选的 Teams 聊天应用,用于私密辅导消息(仅聊天)Manifest 已打包,未侧载
doc/计划、流程、Recall 集成指南、研究历史

标签 teams-media-bot-spike 保存了早先自建 Teams 媒体 bot 的尝试(它可以加入会议,但 Microsoft 不允许通过链接加入的 bot 录制或转录)。

快速开始(本地,无需账户)

本地开发模式会跳过 Microsoft 登录,且绝不会创建真实 bot,因此你可以在自己的机器上运行整个应用。


        git clone https://github.com/blackarck/intaiassist.git && cd intaiassist

# 1. backend (http://localhost:3000)
cd backend
npm install
cp .env.example .env            # git-ignored; set INTAKE_TOKEN to any long random string
DEV_AUTH=1 RECALL_API_KEY= ALLOWED_ORIGINS=http://localhost:5173 npm run dev

# 2. web app (http://localhost:5173), in a second terminal
cd web
npm install
cp .env.example .env.local
# in .env.local set: VITE_API_URL=http://localhost:3000   [email protected]
npm run dev
      

打开 http://localhost:5173。要在没有 Recall 的情况下模拟一场会议,请参阅 web/README.md 中的“Local development”。将 ANTHROPIC_API_KEY(和/或 AZURE_OPENAI_* 那一对)添加到 backend/.env 即可获得真实的 AI 评分。当 NODE_ENV=production 时,DEV_AUTH=1 会被拒绝,并且 VITE_DEV_USER 绝不能设置在已部署的构建中。

配置

后端设置位于 backend/.env(完整且带注释的列表见 backend/.env.example)。主要项:

VariablePurpose
INTAKE_TOKEN用于 admin/dev API 调用的操作员 bearer token。长随机字符串。
MS_CLIENT_ID用于登录的 Entra 应用(客户端)id。与 web 构建的 VITE_MS_CLIENT_ID 值相同。
ALLOWED_ORIGINS允许调用该 API 的 Web 应用来源(CORS),例如 https://app.example.com 。
RECALL_API_KEY , RECALL_REGION , RECALL_WEBHOOK_SECRETRecall.ai 凭据、区域和 webhook 校验密钥。
PUBLIC_BASE_URL后端的公开 https URL;Recall 会将转录内容发送到 <PUBLIC_BASE_URL>/webhooks/recall 。
ANTHROPIC_API_KEY , AZURE_OPENAI_ENDPOINT , AZURE_OPENAI_API_KEYAI 提供商。各任务的模型选择在 backend/src/ai/ 中。
ALIAS_DOMAIN , INBOUND_TOKEN可选:用于电子邮件邀请的 SendGrid Inbound Parse。
ADMIN_SUBJECTS可更改 AI 设置的用户 id,以逗号分隔(登录后从 GET /api/me 获取你的 id)。
DATABASE_PATHSQLite 文件。未设置表示使用内存(重启后丢失)。
STRIPE_SECRET_KEY , WEB_BASE_URL可选的支持付款。留空即关闭。

Web 设置是 web/.env.local 中的构建时变量(见 web/.env.example):VITE_API_URL、VITE_MS_CLIENT_ID、VITE_MS_AUTHORITY。

Microsoft 登录 (Entra)

  • 在 Entra ID 中创建应用注册,账户类型选择任何组织目录和个人 Microsoft 账户(多租户),这样任何公司的面试官都能登录。
  • 添加平台 Single-page application,重定向 URI 为 http://localhost:5173/redirect.html 和 https://<your-web-domain>/redirect.html。
  • 将客户端 id 设置为 MS_CLIENT_ID(后端)和 VITE_MS_CLIENT_ID(Web),并设置 VITE_MS_AUTHORITY=https://login.microsoftonline.com/common。

更多细节见 web/README.md。

接入你自己的 Recall.ai 和 AI 模型

运行你自己的副本意味着使用你自己的账户。所有内容都在 backend/.env(生产环境中为 /opt/intassist/.env)中设置,然后重启后端(npm start,或 docker compose restart backend)。

Recall.ai(会议机器人)

  • 在 recall.ai 创建账户,并记下你的区域(us-west-2、us-east-1、eu-central-1 或 ap-northeast-1)。密钥只能在其创建所在的区域使用。
  • 在 Recall 仪表板中创建 API key,并在 Developers 下添加 webhook 端点 https://<your-backend-domain>/webhooks/recall;复制其校验密钥(whsec_...)。
  • 在 env 文件中设置:RECALL_API_KEY=<your api key> RECALL_REGION=us-west-2 RECALL_WEBHOOK_SECRET=whsec_... PUBLIC_BASE_URL=https://<your-backend-domain> # 末尾不带斜杠,必须是公开的 HTTPS # 可选:BOT_NAME=Interview Assist TRANSCRIPT_LANGUAGE=en 全部设置或全部不设置:如果设置了 RECALL_API_KEY 但缺少其他项,后端会报告缺少什么。如果全部未设置,则不会创建真实机器人。本地测试时使用隧道(ngrok、Cloudflare Tunnel)作为 PUBLIC_BASE_URL。

在 env 文件中设置:


        RECALL_API_KEY=<your api key>
RECALL_REGION=us-west-2
RECALL_WEBHOOK_SECRET=whsec_...
PUBLIC_BASE_URL=https://<your-backend-domain>     # no trailing slash, must be public HTTPS
# optional: BOT_NAME=Interview Assist   TRANSCRIPT_LANGUAGE=en
      

全部设置或全部不设置:如果设置了 RECALL_API_KEY 但缺少其他项,后端会报告缺少什么。如果全部未设置,则不会创建真实机器人。本地测试时使用隧道(ngrok、Cloudflare Tunnel)作为 PUBLIC_BASE_URL。

  • 详情与故障排查:doc/recall-integration.md。

AI 模型(评分和辅导)

后端通过两个提供商调用模型。为你使用的提供商设置密钥:


        ANTHROPIC_API_KEY=sk-ant-...                       # Claude (console.anthropic.com)
AZURE_OPENAI_ENDPOINT=https://<resource>.openai.azure.com   # optional: Azure OpenAI / Foundry
AZURE_OPENAI_API_KEY=...
      
  • 仅 Anthropic 就够了。有几个任务默认先使用 Azure 模型,失败后回退到 Claude,因此如果没有 Azure 设置,它们仍能工作,但每次调用都会先尝试 Azure 并失败。通过重新分配这些任务(下一点)来避免这种情况。

文章标题:Show HN: Interviewer assistant – AI open source

正文:

  • 无需重新部署即可选择哪个模型执行哪项任务:以管理员身份登录并打开 AI settings。管理员是 ADMIN_SUBJECTS 中列出的用户(登录一次,调用 GET /api/me,复制 subject,将其放入 ADMIN_SUBJECTS,重启)。对于每个任务(live coach、answer scoring、opening questions、scorecard、assist),选择一个主模型和一个备用模型。
  • 模型列表:可用模型位于 backend/src/ai/models.ts(CATALOG)中。Azure 条目是你 Azure 资源上的部署名称,因此请修改它们以匹配你的部署。每个任务的默认值位于 backend/src/ai/tasks/*.ts 中。
  • 更改密钥后请重启后端。如果任务失败,请检查后端日志;缺少密钥会显示为 ANTHROPIC_API_KEY is not set 或 AZURE_OPENAI_ENDPOINT / AZURE_OPENAI_API_KEY are not set。

部署到你自己的环境

生产环境是一台运行 Docker Compose 的 Linux VM:Caddy(HTTPS,提供构建后的 web 应用)和后端(SQLite 位于 Docker 卷上)。概要:

  • 创建一台装有 Docker 的 VM,并将你的 API 域名和 web 域名的 DNS 指向它。
  • 将上述后端设置放入 /opt/intassist/.env,另外加上 DOMAIN(API 主机)和 WEB_DOMAIN(web 主机)。
  • 构建 web 应用(cd web && VITE_API_URL=https://<api-domain> VITE_MS_CLIENT_ID=<id> VITE_MS_AUTHORITY=https://login.microsoftonline.com/common npm run build),并将 web/dist 复制到 /opt/intassist/web。
  • 在 deploy/ 中:docker compose --env-file /opt/intassist/.env up -d --build。
  • 在 Recall 中,将 webhook 指向 https://<api-domain>/webhooks/recall。可选:运行 infra/sendgrid/ 以发送电子邮件邀请。

infra/azure/ 中的脚本可在 Azure 上自动完成此过程(VM、用于存储机密的 Key Vault、部署);它们包含我们自己的资源名称,因此请将它们视为一个完整示例并更改名称。完整操作指南见 doc/hosting.md。不要在实时面试期间部署或重启:重启会导致进行中的 webhook 丢失几秒钟。

仅后端:试用 intake 流程

没有 RECALL_API_KEY 时,后端使用仅记录日志的 bot 控制器。设置 DEV_AUTH=1 后,你可以用 curl 测试 intake:


        curl -X POST localhost:3000/api/dev/interviews -H "authorization: Bearer $INTAKE_TOKEN" -H 'content-type: application/json' \
  -d '{"alias":"7KQ2","ownerEmail":"[email protected]"}'
curl -X POST localhost:3000/api/intake/link -H "authorization: Bearer $INTAKE_TOKEN" -H 'content-type: application/json' \
  -d '{"alias":"7KQ2","link":"https://meet.google.com/abc-defg-hij"}'
      

Recall 只能将 webhook 投递到公开的 HTTPS URL,因此真正的端到端测试需要将后端托管或通过隧道暴露(见 doc/recall-integration.md)。

可选的支持付款(Stripe)

人们可以选择支付 $5、$7 或 $10;没有任何功能以此作为门槛。要启用它,请将你的密钥放入 backend/.env(已被 git 忽略):


        STRIPE_SECRET_KEY=sk_test_...        # https://dashboard.stripe.com/apikeys
WEB_BASE_URL=http://localhost:5173   # where Stripe sends people back
      

将 STRIPE_SECRET_KEY 留空,web 应用就不会显示付款金额(那行小的“found it useful?”仍会保留,只是不带金额)。

如果你运行自己的副本,贡献提示会说明此实例的运行需要花费基础设施、会议 bot 和 AI 费用。请在 web/src/components/Support.tsx(SupportCard 和 SupportNote)中根据你自己的情况改写这些提示。Stripe 密钥是你的,因此付款会进入你的 Stripe 账户。要移除这些提示,请从 web/src/pages/Interviews.tsx 中删除 <SupportCard />,并从 web/src/components/SetupForm.tsx 中删除 <SupportNote />。后端会创建 Stripe Checkout 会话(POST /api/me/support/checkout);金额在 backend/src/support.ts 中固定。对于 Azure 部署,请将密钥存储为 Key Vault 机密 stripe-secret-key。付款不会记录在数据库中:Stripe 仪表板就是记录。

测试


        cd backend && npm test && npm run typecheck
cd web && npm test && npm run typecheck
      

许可证与赞助商

来源:https://github.com/blackarck/intaiassist。基于 Apache License 2.0 发布:可自由使用、修改和分发,包括商业用途。欢迎贡献,详见 CONTRIBUTING.md。Interview Assist 由 Proso.ai 赞助。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗