SuperAPI AI 工具集

create-routine

编程与开发

查看项目

更新于 10-15 22:15

技能介绍

用途:在 Condor 中创建或编辑 Python 例程(routine),用于市场分析、监控与数据可视化。例程从 routines/ 目录自动发现,可通过 Telegram(/routines)或 Web 仪表盘运行。注意:这不是交易智能体内部的 agent routine,后者通过 /trading-agent-builder 创建。

主要能力:例程文件放在 routines/ 下,命名为 snake_case.py,必须导出 Pydantic 的 Config 与 async def run(config, context) -> str;Config.doc 作为 UI 描述,模块级 CATEGORY 用于目录分组。可返回字符串或 RoutineResult 实现富输出(表格、图表、KPI 卡片)。支持 ReportBuilder 生成 HTML 报告,以及 LiveReport 生成持续更新的实时报告。设置 CONTINUOUS = True 可运行带内部循环的持续例程。

使用方式:通过 get_client(context._chat_id, context=context) 获取 Hummingbot 客户端,调用 market_data、portfolio、executors 等异步接口;也可直接用 aiohttp 等外部 API。例程需在 Telegram、Web 仪表盘、MCP 三种上下文中都能工作,context.bot 始终可用(非 Telegram 时为 _HttpBot)。发送图表可用 context.bot.send_photo。

限制与注意:所有客户端方法均为异步,需 await;get_order_book 而非 get_order_book_snapshot;get_performance_report 使用 controller_id;create_executor 接收普通 dict;builder.kpi 为独立参数而非列表;Plotly 图例需置于底部;持续例程需捕获 asyncio.CancelledError,内层异常应记录而非抛出;数据缺失时返回错误字符串而非抛异常。ReportBuilder 仅支持 source、tags、kpi、markdown、table、plotly、manual_order、save 方法。