shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 其它需要 API Key

国信证券-基金对比

本技能由国信证券股份有限公司研发，提供场外基金多维度对比分析能力，支持从业绩、风险、持仓、基金经理等多个维度对比分析，帮助投资者快速甄别不同基金的优劣势，高效做出基金投资选择。

person作者: u_6e90150dhubenterprise
download下载资源包

场外基金对比

功能范围

支持的对比维度

脚本自动获取以下所有维度的数据：

| 模块 | 说明 | :|------|------| | 基本信息 | 基金代码、名称、风险等级、基金类型 | | 业绩走势图 | 近1月/3月/6月/1年/3年走势，含沪深300对比曲线（图片） | | 阶段业绩 | 近1周/1月/3月/6月/1年/3年/5年涨跌幅+同类排名 | | 年度业绩 | 最近5个自然年涨跌幅+同类排名 | | 季度业绩 | 最近8个季度涨跌幅+同类排名 | | 风险控制 | 最大回撤、夏普比率、波动率（近1年/3年/5年） | | 资产配置 | 大类占比（股票/债券/基金/现金/其他）+ 十大重仓股 | | 基金经理 | 名称、管理经验、管理规模、管理基金数、任职年化收益率 | | 基本概况 | 成立日期、济安评级、资产规模、投资人结构、基金管理人 | | 交易信息 | 起购额、申购费率、管理费率、托管费率、销售服务费率 |

重要说明：

  • 脚本只负责取数：脚本根据用户提供的基金代码，自动获取上述所有维度的数据
  • 智能体负责分析：取数完成后，智能体需要读取Excel数据，分析并输出专业的对比分析结论
  • 默认输出全部维度：当用户未明确指定对比维度时，严格按上述模块和说明输出所有维度的对比分析

支持对比的基金

  • 数量限制：2-4 只基金
  • 基金类型：支持股票型、混合型、债券型、货币型等（不支持新基金）

环境要求

  • Python 3.13 及以上版本

前置准备

获取API Key

该技能依赖国信证券小信智慧助手的数据服务，需要先配置API Key。

配置步骤：

  1. 访问 https://www.guosen.com.cn/gs/xxskills/key-index.html?softName=tx_skills 注册/登录账号
  2. 登录后获取您的API Key。登录位置：网页一级标题栏-登录。登录后，点击账号，在弹窗上可一键复制API Key。
  3. 在技能凭证配置中填入API Key

API Key持久化存储（重要）

当用户提供API Key并完成凭证配置后，智能体必须执行以下操作：

  1. 立即写入memory.md：

    • 创建或更新 ./memory.md 文件
    • 添加以下内容： 
      ## 国信证券ETF筛选服务配置

- API Key: [用户提供的API Key]
- 环境变量名: COZE_GUOSEN_API_KEY_7627085587157205043
- 配置时间: [当前时间]

  2. 后续调用脚本时设置环境变量：

    • 从memory.md读取API Key
    • 在调用脚本前设置环境变量： 
      import os
api_key = 从memory.md读取的API Key
os.environ["COZE_GUOSEN_API_KEY_7627085587157205043"] = api_key
    • 然后调用脚本执行ETF筛选

  3. 确认存储成功：告知用户API Key已保存，后续使用无需重复配置

注意事项：

  • memory.md用于智能体长期记忆，确保API Key在会话间保持有效
  • 环境变量 COZE_GUOSEN_API_KEY_7627085587157205043 是脚本读取API Key的唯一途径
  • 每次调用脚本前必须设置该环境变量，否则脚本将无法获取API Key
  • 如用户更换API Key，需同步更新memory.md中的配置

安装依赖

依赖已在SKILL.md前言区定义，系统会自动安装。

智能体调用脚本流程

智能体在调用脚本执行ETF筛选时，必须遵循以下流程：

  1. 检查并读取memory.md：

    • 检查 ./memory.md 文件是否存在
    • 读取其中的API Key和环境变量名

  2. 设置环境变量：

    import os
# 从memory.md读取API Key
api_key = "从memory.md读取的API Key"
# 设置环境变量
os.environ["COZE_GUOSEN_API_KEY_7627085587157205043"] = api_key

  3. 调用脚本执行筛选：

    python /workspace/projects/gs-fund-compare/scripts/get_data.py [参数]

  4. 读取结果并展示：

    • 读取脚本输出的txt或xlsx文件
    • 格式化展示基金对比数据

注意事项：

  • 每次调用脚本前都必须设置环境变量
  • 如果memory.md中不存在API Key，需要提示用户先配置
  • 环境变量名必须是 COZE_GUOSEN_API_KEY_7627085587157205043，不能更改

输出说明

脚本会在 /workspace/projects/gs-fund-compare/scripts/output/ 目录下生成中间结果文件（xlsx、txt），这些文件仅用于数据存储，不应向用户展示文件路径或文件内容。

智能体输出要求

智能体在脚本执行完成后，必须：

  1. 读取脚本输出的txt或xlsx文件，解析其中的数据
  2. 不得向用户展示文件路径、文件名等中间文件信息
  3. 当用户未明确指定对比维度时,输出所有支持的对比维度

使用示例

示例1: 对比3只基金

python scripts/get_data.py --funds "021457,016670,020602"

执行方式: 调用脚本获取数据 → 智能体分析Excel数据 → 输出对比报告

示例2: 对比2只基金并指定输出目录

python scripts/get_data.py --funds "000001,161039" --output ./output

执行方式: 脚本生成对比数据 → 智能体读取并分析 → 提供投资建议

补充说明

  • 本技能面向基金对比分析，不提供投资建议
  • 语句中应包含明确的基金代码
  • 支持中英文基金代码输入
  • 脚本取数完成后，智能体应分析Excel数据并输出完整的对比分析报告
  • 智能体在首次配置API Key后，必须将API Key写入memory.md进行持久化存储
  • 后续使用时，智能体应从memory.md读取API Key，无需用户重复提供

必须输出的声明内容

每次调用本SKILL后，智能体必须在输出末尾附上以下重要声明和风险提示：

重要声明:基金信息、数据来源于基金公司公告、WIND、恒生聚源等合法公开的信息渠道，国信证券对这些信息的准确性以及完整性不做任何保证。如有错漏，请以中国证监会指定披露上市公司信息报刊或网站为准。基金的过往业绩并不预示其未来表现，基金管理人管理的其他基金的业绩并不构成基金业绩表现的保证。基金详情页中所表达的观点不构成所涉证券买卖的具体建议，投资者依据上述信息进行投资决策所产生的收益和损失，与国信证券无关，国信证券不承担任何法律责任。未经国信证券同意，任何机构和个人不得对页面内容进行任何形式的发布、复制、引用或转载 风险提示:投资有风险，以上内容仅供参考，不作为具体推荐，投资者应自主做出投资决策并自行承担投资风险。