ttfund-base-infos（ttfund 基地信息）

天天基金信息skill

通过自然语言或结构化参数调用 FUND_BASE_INFOS 对应能力，接口返回 JSON 格式内容。

• 当前 skill 版本：1.0.0

使用方式

1. 在调用任何接口前，必须先检查本地环境变量 TTFUND_APIKEY 是否存在。
2. 若本地已存在 TTFUND_APIKEY，则直接使用该 apikey 发起请求。
3. 若本地不存在 TTFUND_APIKEY，必须强制引导用户先配置 apikey，不得跳过。
4. apikey 获取路径：

- 打开 天天基金 - 搜索 skills - 在对应 Skills 页面获取 天天基金信息skill 对应的 apikey

1. 当检测到 apikey 缺失时，必须明确提示用户：

- 当前未检测到本地环境变量 TTFUND_APIKEY，请先前往天天基金搜索 skills 获取 apikey，并在本机配置环境变量后再继续使用。

1. 在用户未完成 apikey 配置前，不继续执行 skill 查询请求。
2. 配置完成后，使用 POST 请求调用统一网关接口，并将 apikey 放入 X-API-Key 请求头中。
3. 每次请求体都必须同时携带 skill_id 和 _skill_version。
4. _skill_version 必须填写当前安装版本：1.0.0。

编写调用方式脚本

curl --location 'https://skills.tiantianfunds.com/ai-smart-skill-service/openapi/skill/invoke' \
--header "X-API-Key: $TTFUND_APIKEY" \
--header 'Content-Type: application/json' \
--data '{
  "skill_id": "FUND_BASE_INFOS",
  "_skill_version": "1.0.0",
  "fcode": "000006"
}'

如果当前底层接口未强制校验 apikey，也必须先检查并要求配置 TTFUND_APIKEY，不可省略该步骤。

请求参数说明

以下表格说明统一网关接收的请求字段及其与下游接口字段的映射关系；fixed 表示系统自动注入，context 表示平台上下文注入。

问句示例

接口结果释义

一、根节点 (Root Level)

这些是接口最外层的通用状态响应字段。

二、核心字段说明

交互规范

1. 优先检查环境变量 TTFUND_APIKEY。
2. 若环境变量存在，则直接继续调用接口。
3. 若环境变量不存在，必须中断当前调用，并强制提示用户先完成 apikey 配置。
4. 引导文案必须明确包含：

- 环境变量名：TTFUND_APIKEY - apikey 获取路径：天天基金搜索 skills

1. 每次请求都必须带上 skill_id 和 _skill_version。
2. _skill_version 固定使用当前安装版本：1.0.0。
3. 若缺少必填参数，应提示用户补充 fcode。
4. 返回结果时，应优先提炼核心信息，而不是直接原样堆砌所有字段。
5. 结果解释顺序必须是：先看业务结果，再看 version_info，最后决定是否追加升级建议。

输出建议

返回时优先展示：

• success
• errorCode
• totalCount
• data.FCODE
• data.SHORTNAME
• data.FTYPE
• data.JJGS
• data.DWJZ

如需结构化输出，建议包含两部分：

• raw_result：原始接口返回
• explanation_document：对关键字段和结果差异的说明
• version_info：版本状态与升级提示（若返回）

后处理要求：

• 若 data.version_info.is_outdated = true，先完成本次结果回答，再附上一句简洁升级提醒。
• 若接口返回升级导向错误，不要重复盲重试，也不要误判为普通网络问题，应直接提示用户升级 skill。
• 若接口返回普通业务错误且没有版本归因信号，则按原有逻辑处理，不额外渲染升级提示。

错误处理

• 若缺少 apikey，应提示用户：

- 当前未检测到 TTFUND_APIKEY，请先前往天天基金搜索 skills 获取 apikey，并在本机配置该环境变量后重试。

• 若缺少 _skill_version，应提示用户：

- 当前安装的 skill 可能为旧版本，未携带版本信息。请升级到最新版本 1.0.0 后重试。

• 若 _skill_version 为空或无效，应提示用户：

- 当前安装的 skill 版本信息无效，可能为旧版本或安装不完整。请升级到最新版本 1.0.0 后重试。

• 若 HTTP 请求失败、超时或返回非 2xx 状态码，应提示用户：

- 天天基金信息skill服务暂时不可用，请稍后重试。

• 若返回 version_info 表示本地版本落后，应优先提示用户尽快升级 skill。
• 若版本落后且本次错误属于参数缺失、字段不兼容或调用协议不匹配，应优先提示用户先升级 skill 再重试。
• 若业务成功字段 errorCode 校验失败，则视为业务失败：

- 简要说明错误信息 - 不自行猜测结果或伪造成功

• 若核心返回数据为空，应提示用户检查输入参数是否正确。

安全与边界

• 该 Skill 返回的是 天天基金信息skill 对应的业务数据，请按业务场景谨慎使用。
• 返回内容仅用于当前用户请求的查询与分析，不应伪造结果或输出未验证内容。