AgentKit 终极指南：如何构建强大的多智能体网络系统

班妲盼Joyce

468人浏览 · 2026-07-04 08:53:26

班妲盼Joyce · 2026-07-04 08:53:26 发布

AgentKit 终极指南：如何构建强大的多智能体网络系统

【免费下载链接】agent-kit AgentKit: Build multi-agent networks in TypeScript with deterministic routing and rich tooling via MCP. 项目地址: https://gitcode.com/gh_mirrors/ag/agent-kit

AgentKit 是一个基于 TypeScript 的强大框架，用于构建多智能体网络系统，它通过 MCP（多智能体协作协议）提供确定性路由和丰富的工具支持。本指南将帮助你快速掌握 AgentKit 的核心功能，从零开始构建自己的多智能体应用。

为什么选择 AgentKit？

在人工智能快速发展的今天，单一智能体往往难以处理复杂任务。AgentKit 引入了多智能体网络的概念，让不同功能的智能体协同工作，共同解决复杂问题。这种架构不仅提高了系统的灵活性和可扩展性，还通过确定性路由确保了系统行为的可预测性。

AgentKit 提供直观的追踪界面，展示多智能体网络的执行流程和状态变化

核心概念：多智能体网络的基石

1. 智能体（Agents）

智能体是 AgentKit 系统的基本构建块，每个智能体专注于特定任务。例如，在代码编写网络中，你可能会有：

规划智能体（Planner）：负责分析问题并制定解决方案
编辑智能体（Editor）：负责实际编写和修改代码

智能体通过工具（Tools）与外部世界交互，并可以修改网络的共享状态。

2. 网络（Networks）

网络是智能体的集合，它定义了智能体之间如何协作。网络通过路由器（Router）来决定下一步应该调用哪个智能体，这基于当前的系统状态。

3. 状态（State）

状态是网络中共享的数据结构，记录了工作流的当前进度。所有智能体都可以读取和修改状态，这使得它们能够基于共同的信息做出决策。

4. 确定性路由（Deterministic Routing）

AgentKit 的核心创新在于确定性路由。与完全自主的智能体不同，AgentKit 的路由器根据明确的状态条件决定下一步行动，使系统行为更加可预测和可调试。

AgentKit 的确定性路由架构确保智能体交互的可预测性和安全性

快速入门：构建你的第一个多智能体网络

环境准备

首先，克隆 AgentKit 仓库并安装依赖：

git clone https://gitcode.com/gh_mirrors/ag/agent-kit
cd agent-kit
npm install

创建状态定义

定义一个结构化的状态来表示你的工作流进度：

export interface AgentState {
  files?: string[];
  plan?: {
    thoughts: string;
    plan_details: string;
    edits: Array<{
      filename: string;
      idea: string;
      reasoning: string;
    }>;
  };
  done: boolean;
}

实现智能体

创建专注于特定任务的智能体。以下是一个规划智能体的示例：

export const planningAgent = createAgent<AgentState>({
  name: "Planner",
  description: "Plans the code to write and which files should be edited",
  tools: [
    listFilesTool,
    createTool({
      name: "create_plan",
      description: "Describe a formal plan for how to fix the issue",
      parameters: z.object({
        thoughts: z.string(),
        plan_details: z.string(),
        edits: z.array(
          z.object({
            filename: z.string(),
            idea: z.string(),
            reasoning: z.string(),
          })
        ),
      }),
      handler: async (plan, opts) => {
        if (opts.network) {
          opts.network.state.data.plan = plan;
        }
      },
    }),
  ],
  system: ({ network }) => `
    You are an expert programmer working on project: ${network?.state.data.repo}.
    Create a detailed plan to fix the reported issue by analyzing the codebase.
  `,
});

配置网络和路由器

创建网络并实现路由器函数来控制智能体的协作流程：

export const codeWritingNetwork = createNetwork<AgentState>({
  name: "Code writing network",
  agents: [planningAgent, editingAgent],
  router: ({ network }): Agent | undefined => {
    if (network.state.data.done) {
      return; // 工作流完成
    }
    
    if (network.state.data.plan === undefined) {
      return planningAgent; // 需要先创建计划
    }
    
    return editingAgent; // 已有计划，执行编辑
  }
});