函数工具代理

函数工具代理

演示如何使用 @function_tool 装饰器创建自定义函数工具。

本演示所展示的内容

• 自定义函数工具：使用 @function_tool 装饰器创建工具
• 工具描述：为大语言模型提供清晰的文档字符串以帮助理解
• 参数处理：类型提示与默认参数
• 错误处理：优雅地管理工具执行失败的情况

快速入门

1. 安装 OpenAI Agents SDK：

   pip install openai-agents
   ​

2. 设置环境：

   cp ../env.example .env
   # Edit .env and add your OpenAI API key
   ​

3. 运行代理：

   from agents import Runner
   from agent import root_agent
   
   result = Runner.run_sync(root_agent, "What time is it in New York?")
   print(result.final_output)
   ​

关键概念

• @function_tool 装饰器：将 Python 函数转换为代理工具
• 工具文档字符串：大语言模型如何理解何时使用工具
• 类型提示：参数验证与文档说明
• 工具注册：将工具添加到代理配置中

可用工具

get_current_time(timezone: str = "UTC")

• Returns current time in specified timezone
• Handles timezone validation and error cases

greet_user(name: str)

• 简单的问候工具，演示基本工具使用方法
• 展示从大语言模型到工具的参数传递

下一步

• 内置工具 - 使用 WebSearch、CodeInterpreter
• 代理作为工具 - 高级代理编排

免责声明：
本文档采用基于机器的 AI 翻译服务进行翻译。尽管我们力求准确，但请注意，自动翻译可能存在错误或不准确之处。应以原文（母语）文档作为权威依据。如需获取关键信息，建议使用专业的人工翻译。对于因使用本翻译而产生的任何误解或误读，我们概不负责。