Every Code开发者进阶指南：自定义智能体和子智能体配置

【免费下载链接】code- Every Code - push frontier AI to it limits. A fork of the Codex CLI with validation, automation, browser integration, multi-agents, theming, and much more. Orchestrate agents from OpenAI, Claude, Gemini or any provider. 项目地址: https://gitcode.com/gh_mirrors/co0de102/code-

Every Code（co0de102）是一款强大的AI开发工具，它允许开发者通过自定义智能体和子智能体来实现复杂的任务自动化。本指南将详细介绍如何配置和管理智能体，帮助你充分发挥Every Code的潜能。

智能体配置基础

智能体是Every Code的核心组件，它们负责执行特定的任务并与其他智能体协作。在Every Code中，智能体的配置主要通过TOML文件完成，你可以在config.toml中定义智能体的各种属性和行为。

智能体配置文件结构

智能体的配置文件通常包含以下几个关键部分：

• agent_metadata: 定义智能体的基本信息，如名称、ID和角色
• agent_path: 指定智能体在系统中的路径
• agent_nickname: 智能体的昵称，用于在日志和用户界面中显示
• agent_role: 智能体的角色，决定其行为模式和权限

以下是一个基本的智能体配置示例：

[agent_metadata]
agent_id = "agent-123"
agent_path = "/agents/code-reviewer"
agent_nickname = "代码审查助手"
agent_role = "code_reviewer"

自定义智能体的步骤

1. 创建智能体配置文件

首先，你需要在项目的.codex目录下创建一个新的配置文件。可以使用以下命令快速生成一个模板：

mkdir -p .codex/agents
touch .codex/agents/my_agent.toml

2. 配置智能体基本信息

编辑你创建的配置文件，添加智能体的基本信息：

[agent_metadata]
agent_id = "my-custom-agent"
agent_path = "/agents/my-custom-agent"
agent_nickname = "我的自定义智能体"
agent_role = "custom_agent"

3. 定义智能体行为

你可以通过配置文件定义智能体的行为模式。例如，设置智能体的工作目录、环境变量和执行策略：

[shell_environment_policy]
inherit = "core"
[shell_environment_policy.set]
WORKDIR = "/project"
LANG = "en_US.UTF-8"

4. 配置智能体技能

Every Code允许你为智能体配置特定的技能，这些技能定义在skills目录中。你可以通过以下配置指定智能体可以使用的技能：

[skills]
allowed_skills = ["code-analysis", "unit-testing", "documentation"]

Every Code智能体管理界面，显示了当前运行的智能体及其状态

子智能体配置与管理

子智能体是从主智能体派生出来的辅助智能体，它们可以分担主智能体的任务，提高整体效率。在Every Code中，你可以通过AgentControl结构体来管理子智能体的创建和生命周期。

创建子智能体

以下是创建子智能体的基本步骤：

1. 使用spawn_agent方法创建新的子智能体
2. 指定子智能体的父智能体ID和深度
3. 配置子智能体的路径和角色

let child_agent = agent_control.spawn_agent_with_metadata(
    config,
    initial_operation,
    Some(SessionSource::SubAgent(SubAgentSource::ThreadSpawn {
        parent_thread_id,
        depth: 1,
        agent_path: Some(AgentPath::from("my-agent/child-1")),
        agent_nickname: Some("子智能体1号".to_string()),
        agent_role: Some("assistant".to_string()),
    })),
    SpawnAgentOptions::default()
).await?;

子智能体的层级结构

Every Code支持多层级的子智能体结构，你可以通过设置depth参数来控制子智能体的层级。这对于构建复杂的任务处理流程非常有用。

// 创建二级子智能体
let grandchild_agent = agent_control.spawn_agent_with_metadata(
    config,
    initial_operation,
    Some(SessionSource::SubAgent(SubAgentSource::ThreadSpawn {
        parent_thread_id: child_agent.thread_id,
        depth: 2,
        agent_path: Some(AgentPath::from("my-agent/child-1/grandchild-1")),
        agent_nickname: Some("孙智能体1号".to_string()),
        agent_role: Some("specialist".to_string()),
    })),
    SpawnAgentOptions::default()
).await?;

子智能体间的通信

子智能体之间可以通过InterAgentCommunication结构体进行通信，实现信息共享和任务协作：

let communication = InterAgentCommunication::new(
    child_agent_path,
    parent_agent_path,
    Vec::new(),
    "需要协助处理这个任务".to_string(),
    false,
);
agent_control.send_inter_agent_communication(parent_thread_id, communication).await?;

智能体配置的高级技巧

使用环境变量

你可以通过环境变量来动态配置智能体的行为。在配置文件中使用${ENV_VAR}语法引用环境变量：

[shell_environment_policy.set]
API_KEY = "${MY_API_KEY}"

配置智能体的资源限制

为了防止单个智能体占用过多资源，你可以配置资源限制：

[resource_limits]
max_memory_mb = 512
max_cpu_usage = 50
max_execution_time_sec = 300

智能体的自动扩展

Every Code支持根据负载自动扩展智能体数量。你可以在配置文件中设置自动扩展规则：

[auto_scaling]
min_agents = 2
max_agents = 10
scale_up_threshold = 70
scale_down_threshold = 30

智能体配置文件的位置

Every Code会在以下位置查找智能体配置文件：

1. 项目根目录下的.codex/agents目录
2. 用户主目录下的.codex/agents目录
3. 系统级别的/etc/codex/agents目录

你可以通过EXTERNAL_AGENT_CONFIG环境变量指定额外的配置文件路径。

总结

自定义智能体和子智能体是Every Code的强大功能，它允许你构建复杂的自动化工作流来处理各种开发任务。通过本文介绍的方法，你可以创建适合自己需求的智能体配置，提高开发效率。

要了解更多关于智能体配置的细节，请参考项目中的AGENTS.md文档和codex-rs/core/src/agent/control.rs源代码。

通过灵活配置智能体和子智能体，你可以充分发挥Every Code的潜力，实现更高效、更智能的开发流程。开始尝试创建你自己的智能体吧！

【免费下载链接】code- Every Code - push frontier AI to it limits. A fork of the Codex CLI with validation, automation, browser integration, multi-agents, theming, and much more. Orchestrate agents from OpenAI, Claude, Gemini or any provider. 项目地址: https://gitcode.com/gh_mirrors/co0de102/code-