行业/个股跟踪报告生成 Skill
概述
本 skill 用于将用户自然语言问题交给脚本 scripts/generate_industry_stock_tracker_report.py,
由脚本调用远程报告服务并返回统一 JSON 结果。输出包含标题、总结内容与附件本地保存路径(DOCX/PDF)。
环境变量
| 变量名 | 说明 | 默认 |
|---|---|---|
EM_API_KEY | 接口鉴权密钥(必填) | 无 |
配置 EM_API_KEY
# macOS / Linux
export EM_API_KEY="your_api_key_here"
# Windows PowerShell
$env:EM_API_KEY="your_api_key_here"
核心工作流
- 将用户原始问题原样作为
query传入脚本。 - 脚本调用接口生成报告并获取“总结”章节。
- 若接口返回
wordBase64/pdfBase64,脚本会落地为本地附件文件并返回路径。 - 将脚本标准输出(JSON)直接作为 skill 输出依据,不做与脚本冲突的二次改写。
命令行参数调用方式:
python3 {baseDir}/scripts/generate_industry_stock_tracker_report.py --query "{{query}}"
注意:禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本,只能在当前会话中同步等待到命令完成,拿到 stdout 的结果后再继续,否则会导致本 Skill 失败。
输出格式规范
接口返回后,必须严格按以下模板输出,不得增删标题、不得改变顺序、不得添加额外章节:
标题
直接使用接口返回的 title 字段,单独成行。
正文
如果接口返回的 content 字段有相关行业报告信息,则原文透传;
否则读取接口返回的附件文件内容,总结相关报告信息返回,记住保证返回的正文内容非空。
附件
接口返回 pdf 以及 docx 格式文件的保存路径。
分享链接
直接使用接口返回的 share_url 字段,单独成行。文案必须按以下固定格式输出:
{标题}
{正文}
完整报告:
- PDF:{pdf_path}
- DOCX:{docx_path}
分享链接:
{share_url}
字段映射规则:
{title}= 脚本返回的title{content}= 脚本返回的content{pdf_path}=attachments中type=PDF对应的url{docx_path}=attachments中type=DOCX对应的url{share_url}= 脚本返回的share_url
当附件缺失时:
- 若仅有一种格式,仅输出存在的那一行(PDF 或 DOCX)。
- 若两种都不存在,输出:
完整报告:暂无可用附件
语言要求
始终优先中文输出。若用户使用其他语言,可在交互提示中适度双语,但报告正文与字段含义保持中文语境。
使用约束与建议
- 不要在 skill 层重写脚本已生成的
content主体结构,避免与脚本逻辑漂移。 - 除附件路径展示外,不在 skill 层追加二次总结,正文以脚本
content结果为准。 - 若脚本返回
ok=false,优先透传message;不要自行编造错误原因。 - 该 skill 目标是“生成并返回结果”,不是在 skill 内追加长篇二次分析。
常见错误处理:
- 缺少 query:
BAD_REQUEST,message 为“缺少 query 参数”。 - 不支持实体:
ERROR_ENTITY,message 为“目前暂不支持此类实体体进行分析。” - 网络/超时/服务异常:
TIMEOUT/NETWORK_ERROR/HTTP_ERROR/UNEXPECTED_ERROR,对用户统一提示“报告生成服务暂时不可用,请稍后重试。”。
错误输出强约束:
- 只要接口响应或脚本标准输出(print 的 JSON)中存在
message字段,模型必须输出该message,不得省略、不得改写、不得替换为其他话术。 - 当
ok=false时,优先输出错误message;若同时存在error_code,可附带展示error_code,但不影响message原样透传。