# 把 TradeScope 数据交给 AI Agent

API 是数据入口，Skill 是使用规则；两者一起用，Agent 才能按已购范围安全读取

Product: tradescope
Journey stage: use
Audience: 数据人员、运营人员、AI Agent 使用者
Last verified: 2026-08-25

TradeScope 账户提供两样东西：

- **Content API Key**：证明这个 Agent 可以读取哪些已购数据；
- **Agent Skill**：告诉 Agent 按什么顺序读取、怎样引用、哪些事情不能做。

![账户内可复制 Agent 使用说明或下载 Skill；说明只引用环境变量，不包含你的真实 Key。](https://fengtalk.ai/images/help/tradescope/account-agent-instructions-desktop-2026-08-25.png)

图：账户内可复制 Agent 使用说明或下载 Skill；说明只引用环境变量，不包含你的真实 Key。（生产付费账户 · 脱敏截图 · 2026-08-25）

## 推荐设置

1. 按[创建 API Key](https://fengtalk.ai/help/tradescope/content-api-key)保存 Key。
2. 在 Agent 平台创建名为 `TRADESCOPE_CONTENT_API_KEY` 的 Secret。
3. 从账户下载 Agent Skill，交给 ChatGPT、Codex、Claude、OpenClaw 或其他支持 Skill/说明文件的 Agent。
4. 先让 Agent 调用 `GET /api/content/projects`，从返回结果中选择产品和国家。
5. 再读取市场、进口商或供应商，要求输出引用链接和未知项。

可以直接给 Agent 这样的任务：

> 列出我已购买的 TradeScope 项目，找到 HS 392410 的墨西哥项目。先总结市场规模和来源国结构，再筛选值得进一步核验的进口商。每个结论引用 TradeScope 返回链接，缺失字段明确写“不可用”，不要猜测。

**重要｜先选项目，再读内容**

不要让 Agent 猜 `project_id` 或拼 URL。它必须从 `/api/content/projects` 返回的已购项目开始，并只沿 API 返回的链接继续读取。

下一篇：[Agent 能看到什么、不能做什么](https://fengtalk.ai/help/tradescope/agent-capabilities)。