Agent 接口调用
概览
本技能通过 scripts/agents.py 调用通用 Agent 接口；hot-topic-list 与 security-clue-list 为独立脚本调用（参数差异较大）。
支持接口：
one-pager：公司一页通investment-logic：投资逻辑peer-comparison：同业对比earnings-review：绩点评（自动串联 getId + 轮询 getContent，最长 600s）viewpoint-debate：观点 PK（自动串联 getId + 轮询 getContent，最长 600s）theme-tracking：主题跟踪（晨报/晚报）research-outline：公司调研提纲hot-topic-list：热点话题报告（早报/午报/盘中快报/晚报等，分页与多维筛选，结构化话题与可选标的/精读）security-clue-list：投研线索列表（按证券/行业查询，支持时间与来源筛选，分页最大 500）
授权方式与其他 gangtise 技能一致：在 scripts/.authorization 中配置 long-term-token，或配置 accessKey 与 secretAccessKey。
统一脚本
scripts/agents.py
scripts/hot_topic.py（仅 hot-topic-list）
scripts/security_clue.py（仅 security-clue-list）
参数说明
scripts/agents.py
| 参数 | 必填 | 说明 |
|---|---|---|
-a / --agent-type | 是 | 接口类型，见上方枚举。earnings-review 与 viewpoint-debate 会自动串联 getId + 轮询 getContent（最长 600s）。 |
-s / --security-code | 条件必填 | 证券代码（如 600519.SH）。用于 one-pager、investment-logic、peer-comparison、research-outline、earnings-review。 |
-p / --period | 条件必填 | 报告期（如 2026q3）。仅用于 earnings-review。 |
-d / --data-id | 否 | 保留参数，当前无对外场景。 |
--viewpoint | 条件必填 | 观点文本（最长 1000 字）。仅用于 viewpoint-debate。 |
-t / --theme-id | 条件必填 | 主题 ID 或中文主题名（会按映射自动转为 ID）。仅用于 theme-tracking。 |
--date | 条件必填 | 查询日期（yyyy-MM-dd）。仅用于 theme-tracking。 |
--type | 条件必填 | 资讯类型（morning/night，支持逗号分隔多选）。仅用于 theme-tracking。 |
scripts/hot_topic.py
| 参数 | 必填 | 说明 |
|---|---|---|
--page-from | 否 | 分页起始偏移，默认 0。 |
--page-size | 否 | 分页条数，默认 500，最大 500。 |
-sd / --start-date | 否 | 开始日期，支持 yyyy-MM-dd。 |
-ed / --end-date | 否 | 结束日期，支持 yyyy-MM-dd。 |
--hot-category | 否 | 热点类型，逗号分隔：morning、noon、afternoon、evening。 |
--with-securities | 否 | 是否包含相关证券。 |
--with-close-reading | 否 | 是否包含精读。 |
scripts/security_clue.py
| 参数 | 必填 | 说明 |
|---|---|---|
--page-from | 否 | 分页起始偏移，默认 0。 |
--page-size | 否 | 分页条数，默认 500，最大 500。 |
-st / --start-time | 否 | 开始时间，支持 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。 |
-et / --end-time | 否 | 结束时间，支持 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。 |
-q / --query-mode | 是 | 查询方式：bySecurity（按证券）或 byIndustry（按行业）。 |
-g / --gts-code-list | 是 | 证券/行业代码列表，逗号分隔；也可传 all。例如 000001.SZ,000063.SH 或 888888.CI,999999.CI。 |
--source | 否 | 来源多选，逗号分隔：researchReport、conference、announcement、view。 |
-o / --output | 否 | 结果保存路径。 |
示例
python3 scripts/agents.py -a one-pager -s 600519.SH
python3 scripts/agents.py -a investment-logic -s 600519.SH
python3 scripts/agents.py -a peer-comparison -s 600519.SH
python3 scripts/agents.py -a earnings-review -s 600519.SH -p 2025q3
python3 scripts/agents.py -a viewpoint-debate --viewpoint "飞天茅台的批价低点是1500元"
python3 scripts/agents.py -a theme-tracking -t 23600839952306231 --date 2026-03-01 --type morning,night
python3 scripts/agents.py -a theme-tracking -t 核电 --date 2026-04-01 --type morning,night
python3 scripts/agents.py -a research-outline -s 600519.SH
python3 scripts/hot_topic.py --page-from 0 --page-size 5 -sd 2026-03-22 -ed 2026-03-27 --hot-category morning,noon,afternoon --with-securities --with-close-reading
python3 scripts/security_clue.py --page-from 0 --page-size 10 -q bySecurity -g 000001.SZ,600519.SH
python3 scripts/security_clue.py --page-from 0 --page-size 10 -st "2026-03-01 00:00:00" -et "2026-03-23 23:59:59" -q byIndustry -g 888888.CI,999999.CI --source conference,view