business-assistant/docs/api-talent.md

POST /api/talent/chat

人才客服使用独立角色：青浦区人才客服“智”小青，面向个人和用人单位解答人才政策、人才服务及相关惠企事项。检索 talent_knowledge_policy、talent_knowledge_qa、talent_knowledge_article 三库，读取 knowledge/prepared-talent/ingestion/manifest.json。前缀配置见人才知识。

请求与事件

请求校验、附件处理、SSE事件和返回结构沿用聊天接口和正文流式协议，仅路径不同：

curl -N -X POST http://127.0.0.1:8000/api/talent/chat \
  -H 'Content-Type: application/json' \
  -d '{"thread_id":"talent-demo-1","question":"人才政策有哪些？"}'

必填 thread_id、question，可选 pictures、files；不接收 agent 或数据库名。正文通过 answer_start/answer_delta/answer_end 流式返回，前端以最终 answer_end 替换临时正文，result 为完整快照。来源保留完整记录、具体片段及政策事项关联的原文。政策卡片仅对有明确政策来源资格的资料生成，标签和相似度不是获批依据。

同一接口同一ID并发为409；工作池或共享名额满为429。附件失败及接纳后的处理失败通过SSE error 返回，与原接口一致。

隔离与启用

人才和营商分别维护会话历史、公司确认与恢复状态；即使 thread_id 相同也不串用，SSE仍回传客户端原ID。人才Redis使用 talent-assistant:context:v1: 命名空间，营商原命名空间保持。人才会话不进入现有营商DMS后台分析；后续如需写入独立业务栏目，应另行配置。

两个Agent共享BGE模型及其推理锁、进程LLM/检索并发限额和任务接纳名额；各自的数据库客户端固定库名，三库并发检索不会访问营商库。角色适配只处理程序系统提示词，不替换用户数据、原文或引用。

启动时已导入人才清单则初始化人才运行时；没有清单或人才初始化失败时，本接口返回503 agent_unavailable，营商接口照常可用。GET /health 仍表示主应用启动就绪，不保证人才端点或外部依赖健康。导入人才知识及更新本轮代码后需重启服务。

角色、需求规划、证据分析、rerank和最终综合使用人才指令；营商原提示词及知识更新入口保持。个人咨询不强制提供公司，未知资格按原文补问，不承诺审批或代办。

营商后续知识更新仍使用 reference/营商助手/ → knowledge/prepared/ 和原前缀，人才专用读取器及标记不改变该默认流程。部署共享摘要/入库代码时需同时更新新增的 src/knowledge_profiles.py 等配套模块，避免只替换单个文件造成缺失依赖。

本地验证包括合成ASGI接口/历史隔离/共享限额和真实Milvus三库只读检索；真实模型人才答复语义、Redis现场、前端及生产Linux完整链路需部署后联调。