name: add-backend-tool description: 向后台OpenAI函数调用系统添加新工具。当用户提到“新工具”、“添加工具”、“后端函数”、“智能体能力”或希望扩展AI智能体功能时使用。
添加后端工具
使用说明
-
阅读
backend/main.py了解现有工具模式:- 查找包含函数定义的
tools列表 - 查看辅助函数(read_file、write_file、run_terminal_command、web_search)
- 查找包含函数定义的
-
创建辅助函数:
def 新工具名称(param1: str, param2: int = 10) -> str: """工具说明文档字符串。""" try: # 实现代码 return 结果 except Exception as e: return f"错误: {str(e)}" -
将工具定义添加到
tools列表:{ "type": "function", "function": { "name": "新工具名称", "description": "此工具的功能及使用场景", "parameters": { "type": "object", "properties": { "param1": {"type": "string", "description": "..."}, "param2": {"type": "integer", "description": "..."} }, "required": ["param1"] } } } -
在WebSocket消息循环中添加工具调用处理程序:
elif func_name == "新工具名称": result = 新工具名称(**args) -
如有需要,更新模式限制:
- 智能体模式:完全访问
- 聊天模式:仅当工具为只读/安全时才添加到允许列表
示例
- “添加列出目录内容的工具”
- “创建用于git操作的工具”
- “添加网页抓取功能”
安全规范
- 包含适当的try/except错误处理
- 为任何长时间运行的操作添加超时限制
- 考虑安全影响(聊天模式限制)
- 切勿硬编码API密钥或机密信息
- 在函数文档字符串中记录工具的用途