Astravia
使用指南

03 / 使用指南

创建自动化任务

把已经人工跑通的任务交给本地调度器,按单次、每天或间隔计划执行并检查历史。

自动化适合稳定、可重复、无需每次重新解释的任务。调度由桌面客户端在本机完成:Astravia 完全退出、计算机睡眠或关机时不会按计划执行。

自动化之前先手动跑通

不要把尚未验证的宽泛提示直接交给无人值守执行。先在普通会话中完成一次,并确认:

  • 输入来源在每次执行时都存在且路径稳定。
  • 输出位置明确,不会覆盖不相关文件。
  • 成功和失败可以从实际结果判断。
  • 需要的模型、MCP、技能和权限在无人值守时可用。
  • 没有必须由人临场选择的高风险步骤。

示例:每日项目状态摘要

读取当前项目中今天发生变化的文档和任务记录,生成 reports/daily-status.md。

内容包括:已完成、进行中、阻塞和明日建议。
只读取项目文件,不修改其他内容;没有变化时仍生成文件并写明“今日无记录”。
完成后确认输出文件存在,并在回复中列出使用的数据来源。

先在目标项目会话中运行这段任务,检查 reports/daily-status.md,再创建自动化。

创建任务

入口:侧栏 自动化。页面也提供晨间简报、工作总结和每周复盘等模板,使用后仍应按自己的数据来源和输出要求修改。

字段说明
任务名称卡片和执行历史中的识别名称
提示词无人值守时仍能独立理解的完整任务
工作目录「对话」或已有项目目录
模型每次执行使用的模型
计划单次、每天或每隔 N 小时 / 天
沙盒跟随默认、完全访问或使用沙盒
启用保存后是否允许调度触发

固定输入和输出

在提示中写出输入来源、目标路径、允许修改的范围和失败条件,不依赖“上次我们讨论过”的会话记忆。

选择时间计划

核对界面显示的下次执行时间。计划使用操作系统当前时区;跨时区或夏令时变化后重新检查。

保存后立即执行

第一次使用 立即执行,不要等到下一个计划点才发现模型、目录或权限不可用。

验收历史和实际产物

在执行历史中打开对应会话,同时检查目标目录中的实际文件或外部结果。

运行状态和恢复

任务详情提供执行历史,状态包括成功、失败、执行中和已中止。常用动作:

  • 暂停:保留配置,但阻止后续计划触发。
  • 启用:恢复之后的计划,不自动补跑错过的时间点。
  • 立即执行:不改变原计划,额外启动一次验证或补跑。
  • 编辑:调整任务、目录、模型或计划;修改后再次立即执行。
  • 删除:移除任务配置,历史与相关会话按界面确认语义处理。

项目维度的自动化概览也会出现在活动面板中,可查看今日执行、启用任务和最近记录。

常见失败

现象检查
到点没有执行Astravia 是否运行、设备是否睡眠、任务是否启用、时区是否变化
模型调用失败模型和凭证是否仍可用、是否触发配额或速率限制
找不到文件项目目录是否移动,提示中的相对路径是否仍成立
卡在权限确认是否选择了不适合无人值守的动作或执行模式
显示成功但没有结果提示是否要求实际产物和验证,不要只依赖最终回复

需要一份从试跑到启用计划的完整配方,参见按计划生成项目报告;需要对多个目录同时运行同一提示时使用批量任务。

本页内容