PraisonAI Creator Suite 实战指南:用 AI 自动化内容创作的新闻采集、脚本、钩子与简报全流程
【免费下载链接】PraisonAIPraisonAI 🦞 — Hire a 24/7 AI Workforce. Stop writing boilerplate and start shipping autonomous self-improving agents that research, plan, code, and execute tasks. Deployed in 5 lines of code with built-in memory, RAG, and support for 100+ LLMs.项目地址: https://gitcode.com/GitHub_Trending/pr/PraisonAI
本篇技术指南围绕 PraisonAI 仓库中的 Creator Automation Suite(创作者自动化套件)示例展开,它是一套面向 AI 内容创作者的完整工具箱,覆盖"新闻情报采集 → 脚本与故事创作 → 捕获与屏幕自动化 → 视频生成 → 发布与分发 → 反馈与学习"的端到端内容生产流水线。读完本文,你将掌握如何基于 examples/recipes/creator_suite 下的四个可运行示例,快速搭建自己的 AI 新闻早报、多平台脚本生成、爆款钩子筛选与新闻简报流水线,并理解其背后由 PraisonAI 模板加载器驱动的运行机制。
Creator Suite 是什么:内容创作者的 AI 自动化套件
Creator Suite 是 PraisonAI 提供的一组面向 AI 内容创作者的开箱即用示例。它的核心思路是把内容生产中重复、耗时、需要人工判断的环节,逐一拆解为可独立调用、可组合编排的 AI 能力单元,例如:
- 采集:从 HackerNews、arXiv 等公开源抓取 AI 行业新闻,且无需任何 API Key;
- 创作:基于采集结果或自定义主题,生成 YouTube 长视频脚本、短视频脚本、X(Twitter)帖子串、吸引眼球的标题钩子(hook)、新闻简报(brief);
- 编排:通过 Orchestrator 将上述能力串联为"AI 每日新闻秀"(AI Daily News Show)这样的端到端流水线。
套件按功能分为七大层(详见下文"功能全景"),示例代码集中在 examples/recipes/creator_suite,共包含 4 个可直接运行的 Python 示例与 1 个说明文档,全部以# praisonai: skip=true标记,即不会被 PraisonAI 的示例自动扫描执行,需要手动运行。
快速开始:三步跑通第一个示例
先设置 API Key,再运行示例。由于四个示例对 LLM 的依赖不同,API Key 要求也不一致(详见下一节表格):
# 1. 设置你的 API Key export OPENAI_API_KEY=your_key_here # 2. 运行一个示例 python news_crawler_example.py # 采集 AI 新闻,无需 API Key python script_writer_example.py # 生成 YouTube / X / LinkedIn 脚本,需要 OpenAI python hook_generator_example.py # 生成吸引眼球的标题钩子,需要 OpenAI python brief_generator_example.py # 生成新闻简报,需要 OpenAI需要说明的是:示例文件头部通过sys.path.insert引入了开发者的本机绝对路径(如/Users/praison/Agent-Recipes/agent_recipes/templates/ai-news-crawler)来加载对应模板的tools模块。该路径是作者环境专属,在仓库中并不存在,直接复制运行会因路径无效而导入失败。实际使用时,应将其替换为你本地安装的对应 Agent-Recipes 模板目录,或改用 PraisonAI 的praisonai templates run <template>CLI 方式运行模板(机制详见"模板运行机制"一节)。
示例总览:四个示例与各自的 API Key 要求
下表完整对应 README.md 中的示例清单:
| 示例 | 功能 | 是否需要 API Key |
|---|---|---|
news_crawler_example.py | 从多个来源采集 AI 新闻 | 否(HN、arXiv 为公开接口) |
script_writer_example.py | 为 YouTube、X、LinkedIn 生成脚本 | 是(OpenAI) |
hook_generator_example.py | 生成吸引眼球的标题钩子 | 是(OpenAI) |
brief_generator_example.py | 从文章生成新闻简报 | 是(OpenAI) |
三个需要 OpenAI Key 的示例在启动时都会做硬校验:若环境变量OPENAI_API_KEY缺失,直接打印ERROR: OPENAI_API_KEY environment variable required并sys.exit(1)退出,避免在无 Key 情况下浪费调用。
示例一:AI 新闻爬虫(News Crawler)——零 Key 的多源情报采集
news_crawler_example.py 演示从多个来源爬取 AI 新闻,对应套件"News Intelligence Layer"中的 AI News Crawler。它从模板工具模块导入三个函数:
from tools import crawl_hackernews, crawl_reddit_ai, crawl_arxiv, crawl_ai_news主流程分三步,覆盖了"单源 → 单源 → 多源聚合"的完整用法:
1. 爬取 HackerNews(无需 API Key)
hn_articles = crawl_hackernews(max_articles=5, time_window_hours=48)关键参数:max_articles控制最多返回条数;time_window_hours控制时间窗口(此处取近 48 小时)。返回的每条文章以字典形式携带title等字段,示例仅打印标题前 60 字符用于预览。
2. 爬取 arXiv(无需 API Key)
arxiv_articles = crawl_arxiv(categories=["cs.AI", "cs.LG"], max_results=5)关键参数:categories为 arXiv 学科分类列表(cs.AI人工智能、cs.LG机器学习);max_results控制结果上限。这对追踪最新论文动态非常实用。
3. 多源聚合爬取
all_articles = crawl_ai_news( sources=["hackernews", "arxiv"], max_articles=10, time_window_hours=48 ) print(f" Total articles: {all_articles.get('total', 0)}") print(f" Sources crawled: {all_articles.get('sources_crawled', [])}")聚合结果是一个字典,total为文章总数,sources_crawled列出实际被爬取的来源,方便核对采集覆盖度。由于 HackerNews 与 arXiv 均提供公开接口,此示例可在完全不配置任何 API Key的情况下运行——这也是整个套件中最适合作为"第一跑"的示例。
示例二:AI 脚本生成器(Script Writer)——一次主题,三种平台脚本
script_writer_example.py 对应"Script & Story Layer"中的 AI Script Writer,针对不同平台形态分别生成内容:
from tools import write_youtube_script, write_short_script, write_thread topic = "AI agents are revolutionizing software development"1. YouTube 长视频脚本
yt_script = write_youtube_script( topic=topic, target_length=180, # 目标时长(秒) key_points=["automation", "productivity", "future of coding"] ) print(f" Format: {yt_script.get('format')}") print(f" Estimated duration: {yt_script.get('estimated_duration')}s")target_length以秒为单位控制脚本篇幅,key_points向模型注入必须覆盖的论点;返回结构携带format(平台/体裁标识)与estimated_duration(预计时长,秒)。
2. YouTube Short 短视频脚本
short_script = write_short_script(topic, duration=30)duration控制短视频秒数(30 秒短视频对应 YouTube Shorts 的典型形态),返回结构与长视频一致,便于统一处理。
3. X(Twitter)帖子串
thread = write_thread(topic, num_tweets=3) for i, tweet in enumerate(thread.get('tweets', [])[:3], 1): print(f" Tweet {i}: {tweet[:80]}...")num_tweets控制帖子条数,返回的tweets为字符串列表,可直接逐条发布。整个示例仅需一个主题字符串,即可同时产出三种平台形态的初稿,适合作为多平台内容分发的起点。
示例三:AI 钩子生成器(Hook Generator)——生成并排序爆款开头
hook_generator_example.py 对应"Script & Story Layer"中的 AI Hook Generator 与 AI A/B Hook Tester 的思想:先批量生成多种风格的钩子,再按互动潜力排序,选出最优方案。
from tools import generate_hooks, rank_hooks topic = "GPT-5 just released with groundbreaking capabilities"1. 批量生成钩子
hooks = generate_hooks(topic, num_variants=5) for hook in hooks.get('hooks', []): print(f"\n [{hook.get('style', 'unknown')}]") print(f" {hook.get('text', '')}")num_variants控制变体数量;每个钩子是一个带style(风格标签,如悬念式、数据式、对比式等)与text(钩子文案)的字典。多风格生成的意义在于覆盖不同受众的点击心理。
2. 按互动潜力排序
ranked = rank_hooks(hooks.get('hooks', [])) best = ranked.get('best_hook', {}) print(f"\n Best hook (score: {best.get('score', 0)}):") print(f" {best.get('text', '')}")rank_hooks接收上一步生成的钩子列表,输出best_hook(含score评分与text文案)。这一步正是套件中"Feedback & Learning"层 A/B Hook Tester 的离线雏形——先让模型打分排序,再进入真实投放验证,避免凭直觉选标题。
示例四:AI 简报生成器(Brief Generator)——把多篇文章压缩成可消费情报
brief_generator_example.py 对应"News Intelligence Layer"中的 AI Brief Generator,把多条新闻压缩成每日简报,并抽取核心亮点:
from tools import generate_brief, extract_highlights1. 生成每日简报
brief = generate_brief(articles, format="daily", max_articles=3) print(f" Articles included: {brief.get('article_count', 0)}") print(f"\n Brief preview:\n {brief.get('brief', '')[:500]}...")输入articles是结构化的文章列表,每篇含title、content、source、url四个字段(示例内置了三条模拟新闻作为演示数据);format="daily"指定简报形态;max_articles控制纳入简报的文章上限;返回的brief字典含article_count(实际纳入数)与brief(简报正文)。
2. 抽取核心亮点
highlights = extract_highlights(articles, num_highlights=3) for h in highlights.get('highlights', []): print(f" - {h}")num_highlights控制亮点条数,highlights为字符串列表。该能力对应套件中 AI Context Enricher / Signal Ranker 的下游消费场景——采集、去重、排序之后,最终以"简报 + 亮点"的形式交付给创作者或下游编排器。
环境变量:用.env统一管理密钥
套件遵循标准 dotenv 实践。将.env.example复制为.env并填入密钥即可:
cp .env.example .env需要说明的是:当前仓库的 examples/recipes/creator_suite 目录中并未包含.env.example文件(该文件随 Agent-Recipes 模板仓库分发),但四个示例的 Key 要求已在 README 表格中列明。无论是否使用.env,运行脚本前都应确保对应 Key 已注入环境变量,其中仅news_crawler_example.py完全免 Key。
功能全景:Creator Suite 的七大能力层
README.md 完整列出了套件覆盖的能力矩阵,共七大层:
1. 新闻情报层(News Intelligence Layer)
- AI News Crawler(多源新闻爬虫)
- AI News Deduper(新闻去重)
- AI Signal Ranker(信号排序)
- AI Context Enricher(上下文增强)
- AI Brief Generator(简报生成)
2. 脚本与故事层(Script & Story Layer)
- AI Script Writer(脚本撰写)
- AI Angle Generator(创作角度生成)
- AI Hook Generator(标题钩子生成)
- AI CTA Generator(行动号召生成)
- AI Fact Checker(事实核查)
3. 捕获与屏幕自动化(Capture & Screen Automation)
- AI Screenshot Capture(截图捕获)
- AI Screen Recorder(屏幕录制)
- AI News Capture Pack(新闻捕获包)
4. 视频生成(Video Generation)
- AI B-roll Builder(B-roll 素材构建)
- AI Voiceover Generator(配音生成)
- AI Video Merger(视频合并)
5. 发布与分发(Publishing & Distribution)
- AI Publisher Pack(发布工具包)
- AI Content Calendar(内容日历)
- AI Post Copy Generator(帖文文案生成)
- AI Hashtag Optimizer(话题标签优化)
6. 反馈与学习(Feedback & Learning)
- AI Performance Analyzer(数据表现分析)
- AI Comment Miner(评论挖掘)
- AI A/B Hook Tester(A/B 钩子测试)
7. 编排器(Orchestrator)
- AI Daily News Show(端到端"每日新闻秀"流水线)
从仓库现状看,四个示例文件对应的是第 1、2 层中的核心能力(爬虫、脚本、钩子、简报),而其余能力(屏幕捕获、视频生成、发布分发、反馈分析、端到端编排)属于该套件声明的完整能力矩阵,可通过praisonai templates run运行对应模板或在 examples/catalog/fetch_templates.py 的模板目录中检索获取。以"AI Daily News Show"为例,它正是把上述 1、2 层能力串联为"采集 → 筛选 → 写稿 → 成片 → 发布"的端到端流水线,也是 Creator Suite 最具代表性的组合玩法。
模板运行机制:示例背后的 PraisonAI 模板引擎
四个示例本质上是"模板封装函数"的薄调用层,真正的工作由 PraisonAI 的模板引擎完成。理解运行机制有助于将示例迁移为自己的流水线。
CLI 模板命令
PraisonAI CLI 提供模板管理命令组,实现在 src/praisonai-code/praisonai_code/cli/commands/templates.py:
praisonai templates list:列出可用模板;praisonai templates create <name> [--source <file>]:从指定源文件创建新模板。
模板运行与依赖检查
praisonai templates run <template> [args...]是运行模板的核心命令,其实现位于 src/praisonai/praisonai/cli/features/templates.py#L480,关键流程包括:
- 模板发现:通过
TemplateDiscovery在自定义目录与内置包中查找模板,未命中时回退到 URI 解析加载; - 依赖检查:
- 加
--strict-tools时进入严格模式,由DependencyChecker.enforce_strict_mode做 fail-fast 校验,任何缺失依赖直接失败退出; - 默认(非严格)模式则打印缺失的 Python 包(并给出
pip install ...安装提示)与缺失的环境变量警告,继续运行;
- 加
- 工具注册表构建:支持
--tools、--tools-dir、--tools-source覆盖默认工具源,并默认自动加载模板目录下的tools.py(可用--no-template-tools-py关闭); - 工作流执行:解析模板参数(
--offline表示离线模式)后,若工作流配置同时含agents与tasks,则由praisonaiagents的Agent、Task、AgentTeam编排执行。
这也解释了四个示例为什么都以from tools import ...引入能力函数——它们调用的正是模板目录下的tools.py所暴露的封装函数。示例中的硬编码路径是该文件在作者机器上的位置,真实使用时以模板安装路径或templates run命令为准。
模板目录检索
若想确认某个 Creator Suite 模板是否可用,可参考 examples/catalog/fetch_templates.py 的做法:拉取模板目录 JSON,按名称、描述、标签搜索,或按requires.tools过滤,再生成对应的praisonai templates run <name>、praisonai templates info <name>等命令。
套件级测试:run_all_recipes 的启示
examples/recipes/run_all_recipes.py 是全部 Agent-Recipes 的测试外壳,其设计对 Creator Suite 的使用者有两点启发:
- dry-run 验证:它通过
praison templates run <recipe> --dry-run dummy_input逐个模板做无副作用验证,并汇总pass / fail / skip统计(skip 通常源于缺失的外部依赖如ffmpeg、pdftotext)。Creator Suite 中涉及视频/屏幕捕获的模板同样可能依赖ffmpeg等系统工具,运行前可用同样的方式预检; - 依赖自检:启动时会自动检查
OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY等环境变量与ffmpeg、git等外部二进制是否存在。将其作为运行 Creator Suite 前的前置检查,可以避免跑到一半才发现缺 Key 或缺工具。
实践建议与注意事项
- 从无 Key 示例起步:先用
news_crawler_example.py验证模板加载与网络访问,再接入 OpenAI Key 运行其余三个示例,便于隔离环境问题; - 路径替换:四个示例头部的
sys.path.insert均为作者本机绝对路径,迁移到自己的环境时必须替换为实际模板目录,这是"复制即运行"前唯一需要手工处理的部分; - 组合编排:四个示例天然构成一条流水线——爬虫采集(免 Key)→ 简报生成(压缩信息)→ 钩子生成(提炼卖点)→ 脚本生成(多平台输出)。可在此基础上叠加 Creator Suite 声明的去重、排序、视频生成、发布分发等层,最终组装成完整的"AI 每日新闻秀"编排器;
- 依赖预检:涉及视频生成与屏幕捕获的模板可能依赖
ffmpeg等系统二进制,建议先用run_all_recipes.py的 dry-run 模式做环境预检。
通过本文,你已了解 Creator Suite 从零配置到四类核心示例的完整用法,以及其背后的模板引擎运行机制——接下来即可基于 examples/recipes/creator_suite 快速搭建属于你自己的 AI 内容创作自动化流水线。
【免费下载链接】PraisonAIPraisonAI 🦞 — Hire a 24/7 AI Workforce. Stop writing boilerplate and start shipping autonomous self-improving agents that research, plan, code, and execute tasks. Deployed in 5 lines of code with built-in memory, RAG, and support for 100+ LLMs.项目地址: https://gitcode.com/GitHub_Trending/pr/PraisonAI
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考