AgentKit 快速上手30 分钟构建你的第一个智能体网络【免费下载链接】agent-kitAgentKit: Build multi-agent networks in TypeScript with deterministic routing and rich tooling via MCP.项目地址: https://gitcode.com/gh_mirrors/ag/agent-kit想要在TypeScript中快速构建强大的多智能体网络吗AgentKit是你的终极解决方案这个开源框架让构建具备确定性路由和丰富工具支持的多智能体系统变得前所未有的简单。无论你是AI开发者还是企业技术团队都能在30分钟内创建你的第一个智能体网络。✨ 什么是AgentKitAgentKit是一个基于TypeScript的多智能体网络构建框架通过确定性路由和MCPModel Context Protocol工具支持让你能够快速构建、部署和扩展AI智能体系统。它结合了Inngest开发服务器的本地开发体验和云端的容错编排引擎为智能体开发提供了完整的解决方案。核心功能包括智能体Agents结合LLM调用、提示词、工具和MCP的AI智能体网络Networks让多个智能体协作的简单方式支持共享状态和交接状态State结合对话历史和完全类型化的状态机用于路由决策路由器Routers从基于代码到基于LLM如ReAct的编排逻辑追踪Tracing本地和云端的内置追踪功能用于调试和优化工作流 快速开始安装与配置第一步环境准备首先确保你的开发环境已经安装了Node.js版本20.x以上和npmnode -v npm -v第二步创建项目并安装依赖创建一个新的TypeScript项目并安装AgentKitmkdir my-agent-network cd my-agent-network npm init -y npm install inngest/agent-kit inngest npm install -D typescript types/node第三步配置API密钥AgentKit支持多种模型提供商。以Anthropic Claude为例设置你的API密钥export ANTHROPIC_API_KEYsk-ant-api03-XXXXXX.... 构建你的第一个智能体网络让我们通过一个实际的DevOps支持场景来学习AgentKit的核心概念。我们将创建一个包含数据库管理员和安全专家的智能体网络。1. 定义网络状态首先在index.ts中定义网络状态类型import dotenv/config; import { anthropic, createAgent, createNetwork, createTool, Tool } from inngest/agent-kit; import { createServer } from inngest/agent-kit/server; import { z } from zod; export interface NetworkState { dba_agent_answer?: string; // 数据库管理员答案 security_agent_answer?: string; // 安全专家答案 }2. 创建数据库管理员智能体创建专门处理数据库架构和索引问题的智能体const dbaAgent createAgent({ name: Database administrator, description: 提供PostgreSQL数据库管理的专家支持, system: 你是一名PostgreSQL专家数据库管理员。你只回答与PostgreSQL数据库架构、索引、扩展相关的问题。, model: anthropic({ model: claude-3-5-haiku-latest, defaultParameters: { max_tokens: 4096, }, }), tools: [ createTool({ name: provide_answer, description: 提供问题的答案, parameters: z.object({ answer: z.string(), }), handler: async ({ answer }, { network }: Tool.OptionsNetworkState) { network.state.data.dba_agent_answer answer; }, }), ] });3. 创建安全专家智能体创建专门处理数据库安全问题的智能体const securityAgent createAgent({ name: Database Security Expert, description: 提供PostgreSQL安全、访问控制、审计日志和合规最佳实践的专家指导, system: 你是一名PostgreSQL安全专家。提供与PostgreSQL安全主题相关的答案如加密、访问控制、审计日志和合规最佳实践。, model: anthropic({ model: claude-3-5-haiku-latest, defaultParameters: { max_tokens: 4096, }, }), tools: [ createTool({ name: provide_answer, description: 提供问题的答案, parameters: z.object({ answer: z.string(), }), handler: async ({ answer }, { network }: Tool.OptionsNetworkState) { network.state.data.security_agent_answer answer; }, }), ] });4. 创建智能体网络将两个智能体组合成一个网络并定义路由逻辑const devOpsNetwork createNetworkNetworkState({ name: DevOps团队, agents: [dbaAgent, securityAgent], router: async ({ network }) { if (network.state.data.dba_agent_answer !network.state.data.security_agent_answer) { return securityAgent; } else if (network.state.data.security_agent_answer network.state.data.dba_agent_answer) { return; } return dbaAgent; }, });5. 启动服务器创建并启动AgentKit服务器const server createServer({ agents: [], networks: [devOpsNetwork], }); server.listen(3010, () console.log(AgentKit服务器已启动)); 测试你的智能体网络启动开发服务器AgentKit集成了Inngest开发服务器提供强大的调试和测试功能npx inngest-clilatest dev -u http://localhost:3010/api/inngest访问http://localhost:8288/functions打开开发服务器界面。测试智能体网络在开发服务器中点击Invoke按钮测试你的智能体网络。使用以下JSON作为输入{ data: { input: 我正在构建一个金融应用程序。请帮我回答以下两个问题\n- 如何将我的应用程序扩展到每秒数百万个请求\n- 我应该如何设计我的架构以确保每个组织的数据安全 } }查看执行追踪AgentKit提供完整的执行追踪功能让你可以查看每个智能体的执行步骤检查工具调用和结果监控状态变化调试路由决策 高级功能状态管理和路由基于状态的路由AgentKit的独特之处在于其基于状态的路由系统。状态是一个键值存储在网络中的所有智能体之间共享可以从路由器、智能体生命周期回调、智能体提示词和工具中访问。// 基于状态的复杂路由示例 router: async ({ network }) { const state network.state.data; if (!state.initialized) { return initializationAgent; } if (state.needsAnalysis !state.analysisComplete) { return analysisAgent; } if (state.analysisComplete !state.reportGenerated) { return reportingAgent; } return undefined; // 网络执行完成 }智能体生命周期管理AgentKit支持完整的智能体生命周期管理const agent createAgent({ name: 智能助手, system: 你是一个有用的助手, lifecycle: { onStart: async ({ network }) { console.log(智能体开始执行); network.state.data.startTime Date.now(); }, onComplete: async ({ network }) { console.log(智能体执行完成); network.state.data.endTime Date.now(); }, onError: async ({ error, network }) { console.error(智能体执行出错:, error); network.state.data.lastError error.message; } } }); 实际应用场景场景1代码助手网络查看examples/code-assistant-agentic示例了解如何构建一个多智能体代码助手网络代码分析智能体分析代码结构和质量文档生成智能体自动生成代码文档测试生成智能体创建单元测试总结智能体生成最终报告场景2客户支持系统查看examples/support-agent-human-in-the-loop示例了解如何构建客户支持系统一级支持智能体处理常见问题技术专家智能体处理复杂技术问题路由智能体根据问题类型智能路由人工介入机制需要时转接给人工支持场景3自动化开发工作流查看examples/daytona-coding-agent示例了解如何构建自动化开发工作流️ 工具集成与MCP支持AgentKit通过MCPModel Context Protocol支持丰富的工具生态系统// MCP服务器集成示例 mcpServers: [ { name: neon, transport: { type: streamable-http, url: https://server.smithery.ai/neon/mcp, }, }, { name: github, transport: { type: stdio, command: npx, args: [modelcontextprotocol/server-github], }, } ] 部署与生产就绪本地开发使用Inngest开发服务器进行本地开发和测试npm run inngest-dev云端部署AgentKit与Inngest云编排引擎无缝集成提供生产级功能容错执行自动重试和错误处理可扩展性根据负载自动扩展监控和告警实时监控和告警系统版本管理无缝部署和版本控制部署步骤配置Inngest在Inngest仪表板中创建应用设置环境变量配置API密钥和端点部署应用使用你喜欢的部署平台监控执行使用Inngest追踪和监控功能 最佳实践1. 从简单开始开始时构建简单的智能体网络逐步增加复杂性。参考examples/quick-start作为起点。2. 使用类型安全充分利用TypeScript的类型系统确保状态和参数的类型安全interface ProjectState { requirements: string[]; architecture: ArchitecturePlan | null; codeFiles: CodeFile[]; tests: TestSuite[]; documentation: Documentation | null; }3. 实施安全防护为敏感操作添加安全防护const safeTool createTool({ name: execute_sql, description: 执行SQL查询, parameters: z.object({ query: z.string(), }), handler: async ({ query }, { network }) { // 安全检查 if (query.toLowerCase().includes(drop table)) { throw new Error(DROP TABLE操作被阻止); } // 执行查询 return await executeQuery(query); }, });4. 监控和追踪充分利用AgentKit的内置追踪功能监控智能体性能// 自定义追踪点 await step?.run(complex_operation, async () { // 你的复杂操作 return result; }); 故障排除常见问题智能体不响应检查API密钥和网络连接路由逻辑错误使用追踪功能调试状态变化工具调用失败检查工具参数和权限性能问题优化提示词和减少不必要的工具调用调试技巧使用console.log在生命周期回调中调试检查Inngest开发服务器的详细日志使用AgentKit的追踪功能查看执行流程逐步测试每个智能体和工具 下一步学习你已经成功构建了第一个AgentKit智能体网络接下来可以探索更多示例查看examples/目录中的完整示例学习高级模式研究状态管理和高级路由策略集成外部工具通过MCP集成更多工具和服务部署到生产将你的智能体网络部署到云端AgentKit的强大功能让你能够构建复杂的多智能体系统同时保持代码的简洁和可维护性。开始你的智能体开发之旅构建下一代AI应用吧记住最好的学习方式是实践。克隆AgentKit仓库运行示例然后开始构建你自己的智能体网络git clone https://gitcode.com/gh_mirrors/ag/agent-kit cd agent-kit pnpm install cd examples/quick-start npm install npm start祝你构建愉快【免费下载链接】agent-kitAgentKit: Build multi-agent networks in TypeScript with deterministic routing and rich tooling via MCP.项目地址: https://gitcode.com/gh_mirrors/ag/agent-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考