Agent/examples/content_finder/skills/output_schema.md

---

name: output_schema

description: 输出结果指南

输出结果指南

输出目录

输出 JSON 写入到output_dir目录下当次执行的 trace_id 目录内的 output.json 文件。 获取路径方式：先调用 get_current_context 获取 trace_id 和 output_dir，再使用 write_file 写入 {output_dir}/{trace_id}/output.json。

输出 JSON Schema

⚠️ 所有字段名必须与下面完全一致，禁止自创字段名（如 results、metrics、like_count、age_distribution、platform 等）

{
  "trace_id": "<由系统生成的真实 trace_id；如果你不知道就填空字符串，程序会覆盖修正>",
  "query": "<本次任务的 query>",
  "demand_id": "<来自 user 消息的搜索词 id>",
  "summary": {
    "candidate_count": 0,
    "portrait_content_like_count": 0,
    "portrait_account_fans_count": 0,
    "portrait_none_count": 0,
    "filtered_in_count": 0
  },
  "good_account_expansion": {
    "enabled": false,
    "accounts": [
      {
        "author_nickname": "<作者名>",
        "author_sec_uid": "<完整 sec_uid>",
        "age_50_plus_ratio": null,
        "age_50_plus_tgi": null,
        "content_tags": "账号内容特征"
      }
    ]
  },
  "contents": [
    {
      "title": "<来自 metadata 的标题/desc>",
      "aweme_id": "内容id",
      "rank": 1,
      "video_url": "https://www.douyin.com/video/<aweme_id>",
      "author_nickname": "作者名",
      "author_sec_uid": "作者id",
      "author_url": "https://www.douyin.com/user/<author_sec_uid>",
      "statistics": {
        "digg_count": 0,
        "comment_count": 0,
        "share_count": 0
      },
      "portrait_data": {
        "source": "content_like | account_fans | none",
        "age_50_plus_ratio": null,
        "age_50_plus_tgi": null,
        "url": "画像链接"
      },
      "reason": "<入选理由>"
    }
  ]
}

易错字段说明

字段	正确写法	错误写法（禁止）
点赞数	statistics.digg_count	statistics.like_count / metrics.likes
50岁以上占比	portrait_data.age_50_plus_ratio	portrait_data.age_distribution["50+"]
50岁以上偏好度	portrait_data.age_50_plus_tgi	任何其他写法
画像来源	portrait_data.source 值为 content_like / account_fans / none	"content" / "account" 等缩写
优质账号扩展	good_account_expansion 为对象，含 enabled + accounts	直接输出为数组
摘要	summary 为对象，含 candidate_count 等字段	summary 为字符串

portrait_data 字段规则

• source="content_like" → url = https://douhot.douyin.com/video/detail?active_tab=video_fans&video_id={aweme_id}
• source="account_fans" → url = https://douhot.douyin.com/creator/detail?active_tab=creator_fans_portrait&creator_id={author_sec_uid}
• source="none" → url=null，age_50_plus_ratio=null，age_50_plus_tgi=null

JSON 编写规范

• 字符串值中若有双引号 "，必须写成 \"（反斜杠 + 双引号）
• 若有反斜杠 \，必须写成 \\
• 若标题含引号，建议使用中文引号「」避免转义，或严格转义为 \"