工具调用

AI Agent 教程 · 第 3 章 · 7 次浏览

工具(Function Calling)是 Agent 的"手":模型输出结构化指令,程序执行真实操作,把结果返回给模型。查天气、算数、搜网页、操作数据库都是工具。

工具定义

给模型声明工具:名称、描述、参数结构(JSON Schema)。模型根据用户需求选择调用哪个、传什么参数。

主流框架

OpenAI 的 function calling、LangChain 的 @tool 装饰器、Coze/扣子(无代码搭建)。

代码示例

# OpenAI 风格工具定义
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "查询指定城市的天气",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "城市名"}
            },
            "required": ["city"]
        }
    }
}]

# 模型可能返回:
# {"name": "get_weather", "arguments": {"city": "烟台"}}

# 程序执行后把结果回传给模型继续对话
📚 Python 语法速查
常用条目速查,完整版见对应教程章节。可复制代码到在线运行中测试。
写法 / 语法作用
print("hello")输出到控制台
name = "张三"变量赋值(无需声明类型)
if x > 0: ...条件判断(注意冒号和缩进)
for i in range(10): ...循环(缩进是语法的一部分)
while x < 10: ...条件循环
def fn(a, b): return a + b定义函数
class Person: ...定义类
list = [1, 2, 3]列表(可改)
tuple = (1, 2)元组(不可改)
dict = {"key": "value"}字典(键值对)
set = {1, 2, 3}集合(去重)
len(obj)取长度
str(x) / int(x) / float(x)类型转换
s.split(",")字符串按分隔符拆分
" ".join(list)列表拼接成字符串
import os导入模块
from math import sqrt从模块导入指定函数
try: ... except Exception as e: ...异常捕获
with open("a.txt", "r") as f: ...文件读取(自动关闭)
f"你好 {name}"f-string 格式化
lambda x: x * 2匿名函数
list(map(fn, arr))函数式处理列表
range(start, stop, step)生成数字序列
if __name__ == "__main__":主入口判断
pip install 包名安装第三方包(命令行)