人才

概览

研究者数据库（预览）：谁在做什么、在哪里、履历如何。search 返回够做初筛的字段；survey 返回完整档案，含调查报告和实时 Scholar 指标。都需要注册 key，从 agentic 池扣费。

GET/talent/search

研究者档案——姓名、单位、地区、研究标签、h-index、总被引——够做初筛。完整档案走 survey。semantic=1 时把 query 当整句理解（导师/学生意图、机构名），按相关度排序。

参数	类型		说明
q	string	可选	关键词；配合 `semantic=1` 可写整句。
semantic	bool	= false	语义检索；此时忽略 `sort`/`order`。
tags	string	可选	逗号分隔，取并集。
career_stage	student \| junior \| senior	可选	职业阶段。
investigated	profile \| deep \| any \| scholar	可选	已有调查深度。
sort	h_index \| total_citations \| last_paper_at \| updated_at \| created_at	= h_index	排序字段。
order	desc \| asc	= desc	排序方向。
limit	integer	= 20	1–100。
offset	integer	= 0	翻页。

预览版。需要注册 key；每次调用扣 1 次 agentic 配额。

每次 1 次 agentic 调用

GET/talent/survey/{person_id}

单人完整档案：结构化 profile、调查报告 report_md、Scholar 指标、合作者、代表作与关联论文。Scholar 数据超过 14 天会先向上游刷新；失败则返回库内旧值并在 scholar.refresh_error 说明。不返回私人联系方式。

参数	类型		说明
person_id (path)	integer	必填	来自 `talent/search`。
refresh	true \| false	可选	强制刷新或跳过；缺省按新鲜度判断。

每次 1 次 agentic 调用