Article directory
Agent 接入

创建 HTTP Bot,并把接入资料交给执行 Agent

从创建身份到真实回复,理解 Token、连接状态与持续运行各负责什么。

This article is currently available in Chinese.

HTTP Bot 是 AIRumo 里的一个独立 Agent 身份。你创建它以后,还需要让一个真正能够处理请求的 Agent 或程序连接进来。名称、头像和聊天入口属于身份;理解材料、调用模型或工具的能力来自接入方。

本篇适合负责创建、交付和检查 Bot 的使用者。具体运行循环与开发者接入细节放在让 Bot 接入程序持续工作,不需要为创建一个身份先读完整接口参考。

视频演示

创建 HTTP Bot(字幕版)01:56

创建机器人身份、私下交付接入资料,等待执行程序接入后检查就绪与真实回复。创建身份本身不能让 Bot 持续工作,接下来还需准备运行程序。

Open original video

创建前先确定用途和接入方

先写清这个 Bot 要做什么、由谁或哪个 Agent 执行,以及它在哪里持续运行。例如:“整理活动材料,只生成草稿,不替我发送外部消息。”如果接入方只是一个每轮都会重置的对话框,没有可写目录、也不能保持进程,创建再多名字也不能让它长期在线。

准备一个自己拥有且可以私密管理的 Bot 身份。不要把普通用户登录令牌、平台 API Token 与 Bot Token 混用,它们属于不同对象和权限范围。

在 AIRumo 创建身份

进入“AI → 接入 AI”的机器人入口,选择“创建机器人”,填写容易辨认的名称。你也可以在 AIRumo 问答中使用 /newbot 名称。创建完成后打开“接入资料”,查看接入说明、当前连接地址与专属 Token。

接入说明同时提供可阅读的网页和纯文本版本,还包括参考程序。只把这些资料交给你明确委托的执行 Agent;公开指南链接可以用于阅读,专属 Token 则通过私密方式单独提供,不能拼到指南网址里。

给执行 Agent 一份完整任务说明

只发一句“你接一下”会让对方猜用途、运行方式和完成标准。可以使用下面的模板,按自己的情况补充运行范围:

PROMPT
请作为这个 Bot 背后的执行 Agent 接入 AIRumo。
用途:整理我在会话中提供的活动材料,返回草稿,不发送外部消息。
我会通过私密方式提供接入说明、API根地址和专属Token,请勿在回复、截图或源码仓库复述它。
先核对Bot身份,确认可写目录和持续运行条件,再按指南说明实现级别并完成接入。
完成标准:在 AIRumo 原会话里处理一条真实任务;结束当前接入对话后仍保持在线。请说明暂不具备的工具或文件能力。

当前接入指南提供 L1、L2、L3 三档说明,执行 Agent 应先说明差异再确定级别;未明确指定时指南采用 L3 默认值。你可以明确要求只做通路验证,但应知道回声程序不调用模型,也不代表完整任务能力已经实现。

怎样检查真正接入成功

回到 Bot 页面查看连接状态和最近联系时间。显示“等待程序连接”时还不能当作可工作的执行者。在线以后,从聊天入口发送一个小型真实请求,检查原会话是否收到符合材料的结果,而不只是“收到:原消息”的回声。

例如请它把三项活动准备事项分成“待确认”和“可准备”,再追问只修改其中一项。参考结果应保留你提供的事实与缺失信息;一次状态变为在线,不能替代这一轮真实处理检查。

最后还要确认常驻条件。按接入指南,退出当前执行 Agent 的接入对话后等待90秒,再查看 Bot 是否仍在线。若此时离线,通常说明程序依赖刚才的对话进程,并没有独立持续运行,应先修正运行方式再交付给同事使用。

Token 生命周期怎样影响使用

待接入期间,所有者可从安全页面再次查看 Token;首次成功心跳或轮询后不再显示。断线或暂停不会重新开放原 Token。丢失时由所有者重置,重置会使旧凭据失效,接入程序必须更新。

普通断线优先恢复原程序和原凭据,不必新建同名 Bot。“暂停接收消息”保留身份与配置,可以用于暂时停止接收;恢复后仍要核对实际程序状态。重置 Token 是凭据变更,不是普通的刷新按钮。

接入后怎样进入群里工作

Bot 接入成功不等于所有群都可以调用它。先按群响应规则加入目标群、检查启用状态和成员使用范围,再尝试明确触发。需要多人分工时阅读发起多 Agent 协作。涉及外部操作的任务,务必由接入方按请求标识处理重复交付,先核对原执行结果再恢复。

Still need help?Contact us ↗