Felo SuperAgent 技能评估
核心用法
Felo SuperAgent 是 Felo AI 官方推出的智能对话 API 封装技能，通过 Node.js 脚本与 Felo 开放平台进行交互。核心功能包括：
- 实时流式对话：基于 SSE（Server-Sent Events）技术，实现 Token 级实时输出，适合长文本生成和复杂推理场景
- 持久化画布：依托 LiveDoc 机制，所有对话在持久画布上留存，支持跨会话连续追问和上下文继承
- 专业化技能：内置三大技能 ID——
twitter-writer（Twitter/X 推文写作）、logo-and-branding（品牌 Logo 设计）、ecommerce-product-image（电商产品图生成） - 风格库支持：针对专业技能提供可配置的风格 DNA 库，支持自定义写作风格或视觉风格
显著优点
官方背书，技术成熟
作为 Felo 官方出品的技能，直接对接 openapi.felo.ai 平台，API 稳定性和功能迭代有保障。SSE 流式架构避免了传统阻塞式 API 的长等待问题。
状态管理严谨
技能设计了严格的会话状态追踪机制：live_doc_short_id（画布 ID）和 thread_short_id（线程 ID）双 ID 体系，配合详细的决策流程图，确保多轮对话上下文不丢失。
工具链丰富
原生支持图像生成、研究报告、文档/PPT/HTML 生成、Twitter 搜索等工具调用，结果自动提取并格式化输出。
多语言原生支持
内置 --accept-language 参数，支持简体中文、繁体中文、日语、英语等，响应语言与查询语言智能匹配。
潜在缺点与局限性
配置门槛较高
- 必须正确设置
FELO_API_KEY环境变量（注意：与felo config set不互通） - 依赖
felo-livedoc技能作为前置，需确保目录结构正确
交互流程复杂
首次使用专业技能（如发推文、设计 Logo）时，需先获取风格库列表并让用户选择，流程较长。风格 DNA 内容庞大，需要完整传递，不可截断。
实时性受限
虽然底层是 SSE 流式传输，但在 Claude Code 的 Bash 工具环境中，stdout 被完全捕获后再输出，用户无法看到"打字机效果"，体验接近非流式 API。
超时风险
图像生成、研究报告等任务耗时较长，脚本要求设置 600 秒（10 分钟）超时，对短会话场景不够友好。
适合人群
- 内容创作者：需要批量生成社交媒体内容，尤其是 Twitter/X 平台推文
- 电商运营：需要快速生成产品主图、场景图等电商视觉素材
- 品牌设计师：需要 AI 辅助 Logo 设计和品牌视觉方案探索
- 知识工作者：需要基于持续画布进行深度研究、多轮问答和报告生成
常规风险
API 稳定性风险
文档明确列出 SUPER_AGENT_CONVERSATION_CREATE_FAILED（502）等错误码，上游服务偶发故障可能导致对话创建失败。
风格配置风险--ext 参数中的 brand_style_requirement 需要完整传递风格 DNA，若被截断或格式错误，将直接影响生成质量。
共享画布误用
必须严格筛选 is_shared === false 的 LiveDoc，误用共享画布会导致 502 错误。
密钥泄露风险
API Key 通过环境变量传递，需确保不在日志、历史记录中硬编码。
会话状态丢失
若未正确提取和保存 thread_short_id 和 live_doc_short_id，后续对话将断裂，需用户手动重新开始。