Skip to content

配置能力 ​

一个智能体的「能力」由三件事决定:跑在哪台主机上、用什么引擎、在哪个目录里工作。此外,你对智能体的描述与预期输入输出,决定了使用者如何理解和使用它。

主机 ​

智能体的执行环境。一个智能体绑定一台主机。主机必须保持在线,智能体才可用;主机离线时,这个智能体会从市场消失、会话也无法运行。

在 主机管理 页管理你的主机。接入方式见 CLI 参考 · 安装与配对。

引擎 ​

智能体实际由哪个引擎驱动。选项来自该主机真实安装的引擎(如 Claude Code、Codex 等),CLI 启动时会自动检测并上报,未安装的引擎不可选。

引擎自带的能力(推理、工具调用、文件操作、技能与 MCP 配置等)都会作用于你的智能体。以 Claude Code 为例,你本机配置的技能、命令、登录态都会被智能体复用。

建议

选择一台已安装目标引擎的主机。引擎能力直接决定智能体能干什么,建议选择你熟悉、配置完善的引擎。

工作目录 ​

智能体的执行位置由两部分组成:

  1. 主机工作根目录:CLI 接入主机时指定的 -dir,是 raagent 在这台电脑上允许操作的最大目录
  2. 相对子目录:新建智能体时选择的 workDir,相对主机根目录(空串 "" 表示根目录本身)

会话运行目录 = 主机根目录 + 相对子目录 + .raagent/workdir-<会话ID>。每个使用该智能体的会话都在自己独立的目录中执行任务,互不干扰。

  • 工作目录里放什么,智能体就能基于什么工作(代码库、文档集、数据处理脚本……)
  • 会话的文件面板、工具读写都发生在这个目录
  • 可以随时回到向导修改工作目录

描述与预期输入输出 ​

这些信息面向使用者:

  • 描述:使用者搜索时的简介,也是他们判断「这个智能体能干什么」的依据
  • 预期输入:告诉使用者「你应该输入什么样的内容」
  • 预期输出:告诉使用者「你会得到什么样的结果」

私有智能体的邀请页也会展示这些信息,帮助受邀者理解。

「AI 帮我填写」可以基于工作目录内容自动生成这些配置,再手动微调。

修改配置的影响 ​

  • 修改描述、预期输入输出、分类、标签等实质字段,如果智能体是已审核通过的公开智能体,会重新进入审核
  • 修改主机、引擎、工作目录同理,需重新审核

启停与删除 ​

  • 在「我的智能体」里可以随时启用 / 停用智能体;停用后市场不可见、无法发起新会话
  • 删除智能体不可恢复,请谨慎操作