Agent 使用

在 MargoWork 中，你可以把任务、文件和约束交给 Agent，再围绕实际结果继续修改。对话在选定的运行环境和工作范围中进行；Agent、模型、文件与外部服务连接都会影响它能完成的工作。

本页按照“准备材料 → 发送任务 → 查看结果 → 继续修改”的顺序说明。不同 Agent 的附件、运行中追加输入等能力可能不同，页面会按当前 Agent 的能力提供入口。

开始一个对话任务

1. 确认已经连接要使用的服务器，并选中保存任务材料的 App 或默认空间。
2. 点击新建会话。桌面端可以使用工作台顶部的入口，也可以从项目导航创建。
3. 在输入框底部选择 Agent 和模型。
4. 输入目标和已有材料，点击发送消息，或按 Enter 发送。

如果页面提示尚未连接运行环境，先完成安装部署。出现“暂无可用模型，请先设置模型”时，点击设置模型，按账户与配置完成服务商配置。

新建会话用于开始另一项任务。需要调整刚才的结果时，直接在原对话继续发送，便于沿用已有上下文。

选择 Agent 和模型

Agent 是执行任务的助手，模型是它使用的模型服务。输入框底部会显示当前选择；模型列表只提供适用于当前 Agent 的选项。

选择后确认输入框底部显示了目标模型。出现保存选择失败的提示时，先重试选择，不要把未保存的模型当成已经生效。

当前可用 Agent 以选择器为准。正在逐步适配的能力不会因为使用相同页面就自动一致；附件与运行中追加消息的差异见下文。

提供文件与上下文

上传要处理的材料

可以通过三种方式添加材料：

• 点击输入框左下角的添加附件；只支持图片的 Agent 会显示添加图片附件。
• 将文件拖进输入区域。
• 从剪贴板粘贴文件或图片。

上传期间，附件位置显示上传中…，需要等上传完成后才能发送。普通文件附件必须附上说明文字，例如“请提取这份文件中的待办事项”。

每条待发送消息最多添加 4 张图片和 4 个普通文件；普通文件是否可用取决于当前 Agent。超过数量限制或上传失败时，页面会提示，检查已经加入的附件后再继续。

上传的文件会保存到当前工作范围。附件上的移除按钮只把文件从本次待发送消息中移除，不等于删除已经保存的文件。

说明要使用哪些内容

文件提供了材料，任务文字说明如何使用材料。可以写清楚文件名称、需要处理的部分、输出格式和不得修改的内容。例如：

读取附件中的会议记录，整理为一份行动清单。

每条包括：事项、负责人、截止时间、需要确认的问题。
原文没有负责人或日期的地方写“待确认”，不要补造信息。
在对话中展示结果，并保存为《会议行动清单.md》。
保留原始文件不变。

任务使用当前对话所属 App 的工作范围。切换 App 后，不要假定另一个 App 的文件已经自动成为当前上下文；需要明确提供当前任务可访问的材料。

查看处理过程和结果

发送以后发生什么

发送流程在本地接收本次消息后，输入框中的本次文字和附件会清空，消息进入对话。清空输入框只表示消息已交给发送流程，不表示 Agent 已开始执行或任务已经完成。

继续查看对话中的运行状态、回复和错误提示。文件仍在上传、没有可用模型或当前 Agent 不支持某项操作时，输入区域会说明原因。

展开处理步骤

对话中的处理步骤会收起展示 Agent 报告的操作。点击展开，可查看读取文件、搜索、执行命令、修改文件等活动及其细节；具体内容取决于该次任务实际返回的信息。

如果任务需要补充信息或批准操作，按对话中的提示回应，再继续查看处理结果。等待输入和发生错误都不等于任务完成。

检查产物

阅读最终回复，核对结果是否满足请求。如果任务创建或修改了文件，打开对应文件检查内容；处理步骤中的文件条目提供打开入口时，也可以从那里进入。

完成一个对话回复，并不代表应用已经发布或外部服务已经配置完毕。制作应用的预览、发布和访问检查见 APP 发布。

继续修改与运行中补充

在结果上继续修改

任务结束后，在原对话描述要保留什么、修改什么。例如：

保留当前行动清单，把需要我确认的问题移到最前面。
不要修改负责人和截止时间。
更新刚才生成的文件。

需要使用新材料时，先添加附件，再说明新旧材料的关系。已有对话仍使用最初选定的 Agent；想换 Agent 处理同一问题，需要另建会话并提供必要材料。

Agent 还在执行时补充

支持运行中追加输入的 Agent，会提供直接插入当前任务的发送方式。输入补充要求并发送后，消息进入当前任务，不会另建一个独立任务。

不支持时，页面会提示“当前 Agent 不支持直接插入，请等待任务结束后发送”。如果提示当前运行尚未准备好接收消息，检查输入仍在后再重试。

追加输入不会撤回已经完成的文件修改或外部操作。需要改变尚未完成的工作时，把新的限制写清楚，并继续检查实际结果。

停止任务与保留历史

Agent 正在执行、输入框没有待发送内容或上传中的附件时，发送按钮会显示为停止生成。有补充内容时，先保留好需要稍后发送的文字，并清空当前待发送内容，再使用停止按钮。

点击停止后，MargoWork 会请求中断当前执行。停止请求已被接受，不等于执行已经结束；需要等对话更新到结束状态。停止失败的信息会显示在输入区域附近。

停止不会清空对话历史，也不会自动回滚已经完成的文件修改或外部操作。检查现有结果后，可以在原对话继续提出新的要求。

找回已有对话

从项目导航中的对话列表打开历史会话，继续查看回复和文件变更。确认当前选择的是原来的 App 和对话；新建会话不会自动带入另一段对话的全部历史。

遇到消息发送失败或连接中断时，先检查原对话是否已经出现该条消息和后续回复，再按页面提示处理。详细排查见消息没有回复或发送失败。

按需连接 MCP

MCP 用于连接外部工具和服务，例如让 Agent 访问已经授权的数据源。打开设置 → MCP，先确认当前服务器是任务实际使用的服务器。

连接列表中已有的服务

在服务列表中找到目标服务，点击连接，按服务要求完成授权。显示等待授权时，授权尚未完成；若授权页面没有打开，可以使用继续授权入口。

回到 MargoWork 后检查连接结果，再在对话中说明要使用哪个服务、读取哪些数据或完成什么操作。授权被取消或失败时，不要把服务当成已经可用。

手动添加服务

有管理权限时，可以点击添加服务。填写内容随服务类型变化：

远程 HTTP / SSE 服务提供测试连接。显示连接成功只表示本次测试通过，还需要点击添加服务或保存提交配置。OAuth 服务可能在连接或测试时要求授权，按页面指引完成即可。

已有服务的类型不能直接修改。修改地址、凭据等配置后需要重新保存；按钮不可用或要求所有者授权时，需要由有管理权限的人完成。

MCP 是否能在某个 Agent 的当前任务中使用，以该 Agent 的实际能力和连接状态为准。连接问题集中见 MCP 与 Skills 常见问题。

使用与创建 Skills

Skill 是可以重复使用的一组任务方法和指引。打开设置 → 技能，可以切换查看内置和个人技能。

使用已有技能

1. 找到需要的技能，点击使用。
2. 页面会在当前服务器的默认空间打开对应 Agent 的新会话，并把技能指令带入输入框。
3. 补充这次任务的目标、材料和要求，检查后发送。

点击使用只会准备好对话和输入内容，不会替你立即发送任务。技能入口会选择该技能提供的 Agent，因此不要假定所有技能都能在任意 Agent 中使用。

创建个人技能

在技能页点击新增，会打开使用 Codex 的技能创建对话，输入框中带有创建个人技能的请求。补充你要沉淀的流程，例如“把我整理会议记录的格式保存成个人技能”，然后发送并完成对话中的创建步骤。

创建后回到个人技能列表确认是否出现对应条目；打开创建对话本身不代表技能已经保存。

个人技能列表中的卸载会要求确认，并移除该技能及其文件。出现重试时，针对对应技能处理未完成的操作。

遇到问题时查看哪里

• 无法发送、没有回复、停止失败：先查看当前对话和输入区域提示，再阅读消息问题。
• 附件显示只支持图片：这是当前 Agent 提供的附件能力；使用普通文件前确认所选 Agent 支持。
• MCP 授权未完成、Skill 无法使用：查看对应配置页面的状态，详见扩展能力问题。

模型服务、账户登录、订阅和用量配置统一在账户与配置说明；定时重复执行同类任务见自动化创建。