持久化 Agent

OpenSquilla agent 是命名的 runtime 档案。当不同的工作流需要不同的默认设置时使用它们，例如一个研究工作区、一个写作工作区或一个面向 channel 的助手。

内置的 main agent 始终可用。其他 agent 通过 opensquilla agents 配置。

何时创建 Agent

当你希望为以下内容拥有稳定身份时，创建一个持久化 agent：

• 专属的工作区；
• 默认的模型选择；
• 独立的 channel 或自动化目标；
• 周期性任务档案；
• 专门的助手名称与描述。

不要为每次对话都创建新的 agent。请使用 session 来维持普通对话的连续性。

列出 Agent

opensquilla agents list
opensquilla agents list --json

添加 Agent

opensquilla agents add research \
  --name Research \
  --description "Research and synthesis workspace" \
  --workspace /path/to/research \
  --model gpt-5.4-mini

Agent 的更改会写入配置。在依赖更新后的 agent 列表之前，请重启 gateway：

opensquilla gateway restart

在 Session 中使用 Agent

按 agent 过滤 session：

opensquilla sessions list --agent research

为某个 agent 创建调度任务：

opensquilla cron add \
  --agent research \
  --every 1h \
  --text "Summarize new research notes" \
  --name research-hourly-summary

Channel 配置也可以根据 channel 设置将接收到的消息路由到已配置的 agent。

删除 Agent

opensquilla agents delete research
opensquilla agents delete research --force

删除 agent 条目不会影响工作区文件和状态。仅当你确认它们不再需要时，再单独清理这些内容。

Agent 与 Session、Skill 的对比

接下来阅读：

• sessions.md
• features/skills.md
• features/meta-skills.md
• channels.md

文档索引 · 产品指南 · 改进此页面 · 报告文档问题