后端工具添加器Skill add-backend-tool

这是一个用于扩展AI智能体能力的技能模板,指导开发者如何为OpenAI函数调用系统添加新的后端工具。包含完整的代码规范、安全指南和实现示例,帮助构建可扩展的AI代理功能。关键词:AI工具扩展、函数调用系统、后端开发、智能体能力、OpenAI API、WebSocket集成、安全规范

后端开发 0 次安装 0 次浏览 更新于 3/2/2026

name: add-backend-tool description: 向后台OpenAI函数调用系统添加新工具。当用户提到“新工具”、“添加工具”、“后端函数”、“智能体能力”或希望扩展AI智能体功能时使用。

添加后端工具

使用说明

  1. 阅读backend/main.py了解现有工具模式:

    • 查找包含函数定义的tools列表
    • 查看辅助函数(read_file、write_file、run_terminal_command、web_search)
  2. 创建辅助函数:

    def 新工具名称(param1: str, param2: int = 10) -> str:
        """工具说明文档字符串。"""
        try:
            # 实现代码
            return 结果
        except Exception as e:
            return f"错误: {str(e)}"
    
  3. 将工具定义添加到tools列表:

    {
        "type": "function",
        "function": {
            "name": "新工具名称",
            "description": "此工具的功能及使用场景",
            "parameters": {
                "type": "object",
                "properties": {
                    "param1": {"type": "string", "description": "..."},
                    "param2": {"type": "integer", "description": "..."}
                },
                "required": ["param1"]
            }
        }
    }
    
  4. 在WebSocket消息循环中添加工具调用处理程序:

    elif func_name == "新工具名称":
        result = 新工具名称(**args)
    
  5. 如有需要,更新模式限制:

    • 智能体模式:完全访问
    • 聊天模式:仅当工具为只读/安全时才添加到允许列表

示例

  • “添加列出目录内容的工具”
  • “创建用于git操作的工具”
  • “添加网页抓取功能”

安全规范

  • 包含适当的try/except错误处理
  • 为任何长时间运行的操作添加超时限制
  • 考虑安全影响(聊天模式限制)
  • 切勿硬编码API密钥或机密信息
  • 在函数文档字符串中记录工具的用途