智能体的工具使用（Tool Use）

{
  "name": "query_database",
  "description": "执行 SQL 查询并返回结果。当需要从数据库获取数据时使用此工具。支持 SELECT 查询，不支持修改操作。",
  "parameters": {
    "type": "object",
    "properties": {
      "sql": {
        "type": "string",
        "description": "要执行的 SQL 查询语句"
      },
      "database": {
        "type": "string",
        "enum": ["production", "analytics", "test"],
        "description": "目标数据库"
      }
    },
    "required": ["sql", "database"]
  },
  "returns": {
    "type": "array",
    "description": "查询结果的行列表"
  }
}

def execute_tool_with_retry(tool_name, params, max_retries=3):
    for attempt in range(max_retries):
        try:
            result = execute_tool(tool_name, params)
            
            # 验证结果合理性
            if is_valid(result):
                return result
            
            # 结果异常，尝试修正参数
            llm_reflection = llm.generate(f"""
                工具 {tool_name} 返回了异常结果: {result}
                参数是: {params}
                可能是什么问题？如何修正参数？
            """)
            params = adjust_params(llm_reflection)
            
        except ToolError as e:
            if attempt < max_retries - 1:
                # 等待后重试
                time.sleep(2 ** attempt)
            else:
                # 最终失败，让 LLM 决定如何处理
                return llm.generate(f"""
                    工具 {tool_name} 连续失败 {max_retries} 次
                    错误信息: {e}
                    请决定：1) 换一种方法完成任务 
                            2) 告知用户无法完成
                            3) 请求用户帮助
                """)

不同角色的 Agent 有不同的工具权限：

管理员 Agent:
  ✓ 所有查询工具
  ✓ 数据修改工具
  ✓ 系统管理工具
  ✓ 用户管理工具

普通用户 Agent:
  ✓ 只读查询工具
  ✓ 个人数据修改工具
  ✗ 系统管理工具
  ✗ 其他用户数据工具

访客 Agent:
  ✓ 公开信息查询
  ✗ 任何修改操作
  ✗ 敏感数据查询

# 代码执行必须在沙箱中
class CodeSandbox:
    def __init__(self):
        self.allowed_modules = ["math", "json", "datetime", "pandas", "numpy"]
        self.blocked_modules = ["os", "sys", "subprocess", "shutil", "socket"]
        self.max_execution_time = 30  # 秒
        self.max_memory = "512MB"
    
    def execute(self, code):
        # 1. 检查代码是否包含被禁模块
        for module in self.blocked_modules:
            if f"import {module}" in code:
                raise SecurityError(f"不允许使用 {module} 模块")
        
        # 2. 在隔离环境中执行
        result = run_in_container(
            code, 
            timeout=self.max_execution_time,
            memory_limit=self.max_memory,
            network=False  # 禁止网络访问
        )
        return result

Agent: "我需要执行以下操作来完成任务：
  1. 删除旧数据库备份（释放 500GB 空间）
  2. 运行数据迁移脚本
  3. 重启生产服务器
  
  这些操作不可逆，是否继续？[Y/n]"

用户: "1 可以，2 可以，但 3 等到凌晨再执行"

Agent: 调整计划，按用户指示执行

Agent 操作桌面应用的循环：

1. 截取屏幕截图
2. VLM（视觉语言模型）理解屏幕内容
3. 决定下一步操作（点击、输入、滚动等）
4. 执行操作
5. 再次截图，检查结果
6. 循环直到完成

支持的操作：
- 鼠标：点击、双击、拖拽、滚动
- 键盘：输入文本、按键、快捷键
- 窗口：切换、最大化、最小化