Article directory
场景案例

接入完整案例:让一个 Agent 处理真实材料并回写结果

用一份客户反馈练习,验证身份、连接、实际执行、连续修改四个不同阶段。

This article is currently available in Chinese.

这个练习用于回答一个常见问题:“我已经在列表里添加了 Agent,接下来怎么知道它真的能干活?”我们用一份文字反馈材料做完分类、整理和修改,全程不访问真实客户资料、不改业务系统。你会得到一份可核对的反馈表,而不是只看一次“连接成功”提示。

选择自己能操作的接入方式

操作人需要是该 Agent 的拥有者,或者已经获得当前会话使用权限。首次接入建议用自己的 Agent 练习,避免共享权限问题干扰判断。先选其中一种路径并完成对应教程:

  • 本机 OpenClaw、Hermes、Codex 或 Claude Code:在 Desktop 完成扫描、授权与接入,见 本机接入。
  • 已运行的平台 OpenClaw 或 Hermes:检查服务地址、Token、模型或 Agent ID、协议与执行路径,见 平台接入。
  • HTTP Bot:先创建身份,再把凭据交给自己的独立执行程序并持续运行,见 HTTP Bot 接入。只跑回声参考程序,不能完成下面的分析任务。

不要同时创建三种 Agent 来测试。选一条你能提供真实运行条件的路径,先完成一次闭环。运行程序和当前 AIRumo 会话需要能互通;程序不能只在你临时打开的对话工具调用期间存活。

核对四个检查点

检查点看到什么还不能据此推断什么
身份创建我的 AI 列表中有对应名称还不能认定存在执行程序
连接可用对应运行端已连接、状态正常还不能认定能完成业务任务
请求实际处理程序收到材料并完成处理还需检查结果有没有正确回传
结果回写原会话出现可核对成果仍需人工验收事实与质量

给 Agent 改成“客户专家”不会增加分类能力;HTTP Bot 能回传一句“收到”也不代表已经调用了模型。下面的任务要求它基于编号整理多条内容,可以有效区分回声、空泛回答与真实处理。

把完整材料与任务一起发送

打开对应 Agent 会话,复制下列全部内容:

PROMPT
请整理以下虚构客户反馈,不访问外部系统,也不创建工单或联系客户。
F01:我能发消息,但不知道怎样把已接入的Agent加入工作群。
F02:安装客户端后扫描不到本机Codex。
F03:希望活动文案可以有更多适合新手的模板。
F04:群里已经有Agent,但普通成员发消息没有回复。
F05:不知道之前上传的文件为什么过期,收藏后也没保住。
任务:输出一张表,列为“编号、问题类别、需要补问的信息、建议下一步”。每条必须保留原编号,不合并不同事实。
将类别限制为“使用指导、接入排查、内容需求、权限排查、文件保留”。不能确定原因时写需要补问什么,不直接判断产品故障。
最后列出最适合转为帮助文章的两项及理由。只做文字分析,不执行任何外部操作。

发送一次后观察状态,等待原会话回写。长时间未响应时先检查连接或执行日志,别立刻连发相同材料,尤其在你日后把任务改成真实工具操作时。

对照参考表验收结果

参考分类应覆盖如下方向,但具体文字可以不同:

编号合理分类应补问或核对的关键点
F01使用指导是否拥有该 Agent、当前群是否允许添加
F02接入排查是否在 Desktop、同一系统账号、Codex 是否可运行及已授权
F03内容需求目标读者、使用渠道、期望模板形式
F04权限排查Agent 是否在群开启、成员使用权限与响应规则范围
F05文件保留文件时间与保留提示,收藏不会自动续期

验收时数一数是否仍有五条、编号是否全部保留、有没有把 F04 武断地写成“服务器坏了”。“最适合写成帮助文章的两项”可以有不同合理选择,理由应基于重复使用价值和用户能独立解决的程度,不需要与这篇的参考逐字一致。

如果它把每一条原文原样复述,没有分类或下一步,不算完成。若丢了 F05,指出缺项要求补齐;如果文件保留内容与真实规则不一致,使用 文件相关教程 核对,并明确更正,不能因为排版漂亮就放过事实错误。

再做一次连续修改

在同一会话发送:

PROMPT
保留刚才五个编号和原分类。现在把“建议下一步”改为用户自己能做的一个具体动作,每条不超过40字;无法由用户完成的事项明确写“联系Agent拥有者”或“联系管理员”,不要假设普通成员拥有全部管理按钮。最后单独列出仍缺失的信息,不编造检查结果。

这一步检查它是否能承接前轮结果并按受众调整。参考 F02 应建议“在Desktop检查Codex能否运行并完成授权”,而不是让普通用户重启服务器;F04 应先检查自己可见的使用条件,必要时联系拥有者核对规则。

如果换了会话或运行端不保留会话,请把前轮表格一并提供。稳定的上下文映射需要实际执行程序支持;只换一个输入框,不保证所有材料仍然可用。

记录完成结论与下一步

本例通过需要同时满足:原会话收到结果、五条材料正确分类、有可执行下一步、第二轮保留编号并完成明确修改。HTTP Bot 还应检查在关闭当前外部 Agent 对话后仍能持续在线,避免只是临时运行。

接下来可以把它加入工作群,使用相同的小材料测试群规则与成员使用权限。若希望处理文件或真实系统数据,再单独确认解析能力、目录与工具授权、输出位置和失败恢复方式;文字练习通过不等于已经验证所有工具能力。连接失败见 Agent 排查,结果偏差见 回答不符合预期。

Still need help?Contact us ↗