AgentKit 工具开发指南创建自定义工具扩展智能体能力【免费下载链接】agent-kitAgentKit: Build multi-agent networks in TypeScript with deterministic routing and rich tooling via MCP.项目地址: https://gitcode.com/gh_mirrors/ag/agent-kitAgentKit 是一个强大的 TypeScript 框架用于构建多智能体网络通过 MCPModel Context Protocol提供确定性路由和丰富的工具支持。本文将详细介绍如何为 AgentKit 创建自定义工具以扩展智能体的能力让你的 AI 应用更加强大和灵活。为什么需要自定义工具在构建 AI 智能体时工具是连接智能体与外部世界的桥梁。AgentKit 提供了基础的工具支持但实际应用中往往需要针对特定业务场景开发专用工具。无论是数据库操作、文件管理还是第三方 API 集成自定义工具都能让智能体具备更专业的能力。AgentKit 开发服务器展示了工具执行结果的界面清晰呈现了智能体使用工具后的输出内容自定义工具的核心组件创建一个 AgentKit 工具需要以下几个核心部分1. 工具元数据包括工具名称、描述和参数定义。这些信息帮助智能体理解工具的用途和使用方式。2. 处理函数实现工具的核心逻辑接收输入参数并返回处理结果。处理函数可以访问智能体的状态和网络上下文实现复杂的业务逻辑。3. 类型定义使用 TypeScript 和 Zod 模式定义输入输出类型确保类型安全和数据验证。从零开始创建自定义工具步骤 1导入必要的模块首先需要导入 AgentKit 的createTool函数和 Zod 库用于参数验证import { createTool } from inngest/agent-kit; import { z } from zod;步骤 2定义工具参数使用 Zod 定义工具的输入参数 schema确保输入数据的有效性const parameters z.object({ answer: z.string().describe(The answer to be provided to the user), });步骤 3实现工具处理函数处理函数接收验证后的输入参数和工具选项实现具体的业务逻辑const handler async ({ answer }, { network }) { // 将结果存储到网络状态中 network.state.data.dba_agent_answer answer; };步骤 4创建工具实例使用createTool函数组合元数据和处理函数创建工具实例const provideAnswerTool createTool({ name: provide_answer, description: Provide the answer to the questions, parameters, handler, });完整工具示例以下是一个完整的工具示例展示了如何创建一个用于提供答案的工具import { createTool } from inngest/agent-kit; import { z } from zod; import type { Tool } from inngest/agent-kit; import type { NetworkState } from ./types; export const provideAnswerTool createTool({ name: provide_answer, description: Provide the answer to the questions, parameters: z.object({ answer: z.string().describe(The answer text to be stored), }), handler: async ({ answer }, { network }: Tool.OptionsNetworkState) { network.state.data.dba_agent_answer answer; return { success: true, storedAnswer: answer }; }, });将工具集成到智能体创建工具后需要将其添加到智能体的工具列表中const dbaAgent createAgent({ name: Database administrator, description: Provides expert support for managing PostgreSQL databases, model: anthropic({ model: claude-3-5-haiku-latest, defaultParameters: { max_tokens: 4096 }, }), tools: [provideAnswerTool], // 添加自定义工具 });工具开发最佳实践1. 保持工具职责单一每个工具应专注于完成一项特定任务这样不仅便于维护也让智能体更容易理解和使用工具。2. 完善工具描述详细的工具描述和参数说明能帮助 AI 模型更好地决定何时以及如何使用工具。3. 处理错误和异常在工具处理函数中添加适当的错误处理确保智能体能够优雅地处理异常情况。4. 使用类型系统充分利用 TypeScript 的类型系统和 Zod 模式验证提高代码质量和可靠性。工具开发进阶技巧访问网络状态工具可以通过network.state访问和修改网络状态实现智能体之间的数据共享handler: async (input, { network }) { // 读取状态 const currentState network.state.data; // 修改状态 network.state.data { ...currentState, newData: input.value }; }调用其他工具在复杂场景下工具可以调用其他工具来完成更复杂的任务handler: async (input, { agent }) { // 调用其他工具 const result await agent.callTool(other_tool, { param: input.value }); return processResult(result); }流式输出对于耗时操作可以实现流式输出实时向用户反馈进度handler: async (input, { network }) { for (const item of input.items) { const result await processItem(item); // 流式更新状态 network.state.data.results.push(result); // 发送中间结果 network.stream({ type: progress, data: result }); } return { complete: true }; }总结自定义工具是扩展 AgentKit 智能体能力的关键方式。通过本文介绍的方法你可以创建各种专用工具使智能体能够处理更复杂的任务。无论是数据库操作、文件管理还是第三方 API 集成AgentKit 的工具系统都能提供灵活而强大的支持。要开始创建自己的工具只需遵循以下步骤定义工具元数据和参数实现处理函数将工具添加到智能体在网络中使用工具通过不断优化和扩展工具集你可以构建出真正强大的 AI 智能体应用满足各种复杂的业务需求。更多工具开发细节请参考官方源代码packages/agent-kit/src/tool.ts【免费下载链接】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），仅供参考