Agent 框架

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

做一个简单的客服 Agent：能查订单、查物流、退换货引导。这是 Agent 最常见的落地场景，也最能体现"工具调用"的价值。

设计

工具：查订单（数据库）、查物流（接口）、转人工（标记）。流程：识别意图 → 调工具 → 组织回答。搞不定转人工。

代码示例

# 客服 Agent 骨架
from openai import OpenAI

client = OpenAI(api_key="...")

TOOLS = [{
    "type": "function",
    "function": {
        "name": "query_order",
        "description": "按订单号查询订单状态",
        "parameters": {
            "type": "object",
            "properties": {
                "order_id": {"type": "string"}
            },
            "required": ["order_id"]
        }
    }
}]

def query_order(order_id):
    # 真实场景查数据库
    return {"order_id": order_id, "status": "已发货", "logistics": "顺丰 SF123456"}

def chat(user_msg):
    resp = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": user_msg}],
        tools=TOOLS,
        tool_choice="auto",
    )
    msg = resp.choices[0].message
    if msg.tool_calls:                    # 模型要调工具
        for call in msg.tool_calls:
            if call.function.name == "query_order":
                result = query_order(
                    eval(call.function.arguments)["order_id"])
        # 把结果返回给模型生成最终回答
        resp2 = client.chat.completions.create(
            model="gpt-4o-mini",
            messages=[
                {"role": "user", "content": user_msg},
                msg,
                {"role": "tool", "tool_call_id": call.id,
                 "content": str(result)},
            ])
        return resp2.choices[0].message.content
    return msg.content

print(chat("帮我查一下订单 SH20260101 到哪了"))

📚 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 包名`	安装第三方包（命令行）