跳至正文

感知上下文的 Orylo Actions

查看 Markdown

让可复用的 Actions 在合适的上下文中出现,组合所需输入,并精确选择运行方式和结果交付方式。

本文章节

根据当前上下文提供操作

一个 Orylo Action 包含三项决定:何时可用、执行什么,以及将结果送到哪里。Action Bar(操作栏)会将当前上下文与每个已启用 Action 的规则进行匹配;你无需先把所有内容复制到新对话中。

感知上下文是指将捕获的上下文与你配置的规则进行匹配,并不意味着持续监视屏幕或自动运行 Action。由你选择运行哪个匹配的 Action。

上下文提供的内容
Selected Text(选中文字)你选中的文字,适用于改写、翻译或 Promptize。
文件、文件夹或图片根据配置的输入,提供选中的文件或图片,或文件夹路径。
Web Page(网页)当前页面的 URL,不会自动复制网页正文。
Focused Window(焦点窗口)应用标识、可获取的窗口标题,以及按需截取的屏幕截图;捕获需要权限。
Application(应用)当前活跃应用的标识,可选用指定应用的条件。

决定 Action 何时出现

选择一个 Primary Context(主要上下文):这是必选项,用于定义主要输入。如果要求所有附加上下文都存在,请添加 All Of(全部满足)条件;如果要求至少存在一种备选上下文,请添加 Any Of(任一满足)条件。AI Actions 会收到所有已配置且实际可用的上下文,而不只是第一个匹配的备选项。

例如,同时要求 Selected Text 和 Web Page,就能让 Action 仅在文字和页面 URL 同时可用时出现。若要将 Action 限定在某个应用中,请将 Application 设为必需条件,并选择该应用;仅将 Application 设为可选条件,并不能保证 Action 只在该应用中可用。

这些规则控制的是可用性,不会授予文件访问或屏幕录制权限。如果某个 Action 没有出现,请检查它是否已启用、所需上下文是否齐全,以及来源应用和捕获权限。

选择操作和结果交付方式

对于 AI 结果,可以选择发送到结果面板、剪贴板或 Composer(输入区),替换原先选中的文字,或不自动交付。后台命令的输出可以发送到面板、剪贴板或 Composer;在新 Terminal 窗口中运行时,不会将输出收集到 Orylo。打开网页操作只会打开配置的 URL。

除了行为,你还可以自定义 Action 的名称、描述、图标、启用状态和排序。运行命令前请先检查:命令会在你的 Mac 上执行,并不会仅仅因为被配置为 Action 就变得安全。

操作自定义选项与边界
AI Action选择 Assistant 并设置指令。它会收到主要上下文,以及已配置且可用的附加上下文。Chat Assistant 根据提供的内容生成结果;Agent Assistant 可以使用为其配置的工具。
Open Web Page(打开网页)设置 URL 模板。选中文字或页面 URL 可经编码后填入模板的上下文占位符。附加条件只决定可用性,不会传入 URL。
Run Command(运行命令)设置脚本、工作目录、超时时间,以及在后台还是新 Terminal 窗口中执行。只有主要输入会作为数据传入;应用或窗口输入目前不会向脚本提供上下文文本。

使用 Create with Chat,或自行配置

  1. 描述工作流程

    打开 Settings(设置)→ Actions → 添加 → Create with Chat。指定主要输入、必需的上下文、操作、需要时使用的 Assistant,以及交付方式。创建时需要一个已能正常工作的 Agent Assistant。

  2. 检查拟议配置

    要求先提供预览,并确认匹配条件、指令或命令、目标 Assistant 和输出位置。只保存你想要的配置;保存不会执行 Action。

  3. 用一个小例子试用

    回到目标应用并准备好上下文,打开 Action Bar,主动运行已保存的 Action。你可以在 Settings 中调整,也可以继续创建时的对话。还可以使用 Create Manually(手动创建)。

用 Action Groups 整理选项

Action Group 是一组备选操作的菜单,不是依次运行所有子项的执行序列。例如,针对选中文字的分组可以提供 AI 解释、网页搜索和本地命令。你打开分组后,从中选择一个 Action。

子项共用分组的输入和显示条件,但可以采用不同的操作和结果交付位置。分组不能嵌套。完全禁用的分组不会有可用入口。

分享与深度定制 Action 定义

Action 和 Action Group 支持 JSON 导入、导出。使用导入的定义前,检查匹配条件、指令、命令和输出位置。引用的 Assistant 必须能在接收方 Mac 上解析,显示名称相同并不足够。

JSON 格式还支持排除条件(None Of),但当前可视化编辑器没有提供该入口。指定了固定本地工作目录的命令暂不支持导出。可分享的定义不包含捕获到的输入、执行历史或本地排序偏好。

运行并查看执行情况

  1. 准备上下文

    选中所需的文字、文件、文件夹或图片,或让相关应用或窗口获得焦点。使用 Settings 中配置的快捷键打开 Action Bar。

  2. 选择匹配的 Action

    运行前先检查它的用途。AI Action 使用独立的执行会话,不会使用当前打开对话的历史记录。不要假定它包含之前聊天的上下文。

  3. 查看进度和输出

    从展开的 Action Bar 中打开 Action Executions(操作执行记录),查看正在运行的任务、近期结果、部分输出和错误。隐藏操作栏不会取消运行;如需停止,请在执行详情中明确停止。

掌控交付方式和权限

自动替换仅适用于以选中文字为主要输入的 AI Action。它取决于来源应用,以及原始选区是否仍然有效且可编辑。如果交付失败,请查看保留的结果,不要直接重新运行可能产生副作用的任务。

Actions 不提供交互式权限审批流程。需要新批准的请求不会被悄悄放行;需要此类交互的工作,请在普通对话中完成。现有的 Agent 权限仍然适用。

执行记录只在当前应用会话中临时保留,不属于永久对话历史,应用重启后也不会保留。需要长期保留的结果,请复制或保存。可选的 Action 建议功能默认关闭,只会生成可供检查的草稿,不会自动启用或执行 Actions。

从这里开始

使用 ↑ ↓ 选择,按 Enter 打开,按 Esc 关闭。