用途
Get started 是 Aeon 插件的首次运行设置技能,帮助新用户完成三件事:检查与用户 Aeon 智能体的连接、展示智能体能做什么以及还缺什么、实际运行一个技能让用户看到效果。
Aeon 是一个按计划在用户自己的 GitHub 仓库中通过 GitHub Actions 运行技能的智能体。本插件通过 Aeon Connect(https://www.aeon.fun/connect/mcp)连接到用户的 Aeon 智能体。
主要能力与使用流程
1. 检查连接
调用 list_skills。若调用成功,进入下一步;若要求登录或返回认证错误,提示用户连接 Aeon(用 GitHub 登录,然后在“Connect an app”页面选择其智能体)后重试;若用户尚无智能体,引导其访问 https://www.aeon.fun/connect 创建(约两分钟:GitHub 登录、创建仓库、连接模型),再重新连接插件。
连接一次只对应一个智能体仓库。若用户在连接时允许切换,list_instances 可列出其他 Aeon 仓库,switch_instance 可切换。仅在用户有多个智能体或询问其他仓库时提及。
2. 展示能力与待补项
根据 list_skills 结果,用几行说明:插件连接的是哪个仓库、已开启多少技能及各自计划、两三个已关闭但看起来有用的技能(每个一行)。保持简短,不逐一列出所有技能。
随后调用 setup_status。若未连接模型或已启用技能缺少 API 密钥,指出缺失项及添加位置:该智能体在 https://www.aeon.fun/connect 的 Keys 标签页。setup_status 只给出密钥名称,绝不询问密钥值。
3. 运行一个技能
若已连接模型,可提议运行 heartbeat(快速验证智能体是否正常,无需额外设置)。用户同意后,调用 run_skill 并指定 skill: "heartbeat",然后跟踪运行:部分应用会在聊天中显示实时运行视图,否则定期用返回的 run_id 调用 get_run 直到状态为 completed。一次运行约一到十分钟。成功后调用 read_output 并摘要结果;失败时 get_run 会给出可能原因(常见为模型登录缺失或过期),用通俗语言解释修复方法并指向 https://www.aeon.fun/connect。若无 heartbeat 技能,改用任一已开启技能;若未连接模型,跳过此步并回到第 2 步的缺失模型提示。
4. 后续可做的事
告知用户可以提出的请求,例如按计划开启摘要技能、查询今日失败原因、查看上次摘要结果、查看本周记录、向策略中添加目标、询问可添加的技能包、打开 Aeon 仪表盘等。
适用场景
适用于首次配置 Aeon 插件、验证与智能体的连接是否正常、了解当前仓库已启用技能及其计划、发现缺失的模型或密钥配置,以及通过运行一个技能确认智能体实际可用的场景。
限制与注意事项
update_skill、update_strategy、update_soul、install_pack(会打开拉取请求)、switch_instance、update_instance_settings 及设置开关会改变用户配置,调用前须说明将变更内容并取得用户同意。绝不索取 API 密钥、令牌或机密;setup_status 仅显示密钥名称,密钥在 Aeon Connect 中添加而非对话中。若 Aeon 工具失败或返回错误,可用 send_feedback 向 Aeon 团队报告(失败运行时传入 run_id),并告知用户已发送的内容,绝不包含机密。