大模型应用开发 / 系统课时

构建可调用工具的 Agent

构建可调用工具的 Agent

本课构建一个可调用两个业务工具的 Agent:它先查询商品单价,再计算折扣后的订单总额,并把工具结果整理为最终回答。重点不在“让模型自由发挥”,而在于用工具契约、系统指令和验收条件约束决策循环。

学习目标

  • 理解 Agent 在模型判断、工具执行与结果回传之间的循环
  • 使用 create_agent 注册多个工具并发起一次完整调用
  • 为工具型 Agent 设置停止条件、安全边界和验收标准

Agent 如何完成一次工具任务

Agent 会把用户目标、系统指令和可用工具交给模型。模型可以直接回答,也可以生成工具调用;工具执行结果会作为新消息回到上下文,模型据此决定继续调用还是输出最终答案。循环结束条件通常是模型返回最终消息,或系统达到递归与步数限制。

可调用工具的 Agent 决策循环

工具越多,模型的选择难度越高。名称应可区分,说明应写清适用场景,参数不要出现多个近义字段。对于必须按顺序执行的业务,可在系统指令中明确“先查事实,再做计算”。

组合两个工具并运行 Agent

示例需要已安装对应模型提供商集成,并在环境中配置 MODEL_NAME 及该提供商要求的 API Key。MODEL_NAME 应填写支持工具调用的模型标识,例如组织内部统一配置的模型别名。

python
import os

from langchain.agents import create_agent
from langchain.tools import tool

@tool
def get_unit_price(product: str) -> float:
    """查询商品单价,仅支持 keyboard 和 mouse。"""
    prices = {"keyboard": 120.0, "mouse": 80.0}
    key = product.strip().lower()
    if key not in prices:
        raise ValueError(f"unsupported product: {product}")
    return prices[key]

@tool
def calculate_total(
    unit_price: float,
    quantity: int,
    discount_percent: float = 0,
) -> float:
    """根据单价、数量和折扣百分比计算订单总额。"""
    if quantity <= 0 or not 0 <= discount_percent <= 100:
        raise ValueError("invalid quantity or discount")
    return round(unit_price * quantity * (1 - discount_percent / 100), 2)

def main() -> None:
    model_name = os.environ["MODEL_NAME"]
    agent = create_agent(
        model=model_name,
        tools=[get_unit_price, calculate_total],
        system_prompt=(
            "你是订单计算助手。商品价格必须调用 get_unit_price 查询,"
            "订单总额必须调用 calculate_total 计算,最后用一句中文回答。"
        ),
    )

    result = agent.invoke(
        {
            "messages": [
                {
                    "role": "user",
                    "content": "购买 3 个 keyboard,打 10% 折,总价是多少?",
                }
            ]
        },
        config={"recursion_limit": 8},
    )
    print(result["messages"][-1].content)

if __name__ == "__main__":
    main()

预期输出的措辞可能因模型不同而变化,但应包含同一计算结果:

text
购买 3 个 keyboard,打 10% 折后的总价是 324.00。

若最终金额不是 324.00,先检查追踪记录中是否依次出现 get_unit_price 和 calculate_total,再核对第二次调用的参数是否为单价 120.0、数量 3、折扣 10。

增加约束与验收条件

生产环境不能只验证最终句子,还要验证过程。可以检查必需工具是否被调用、调用次数是否异常、参数是否越界,以及最终结果是否能由工具输出推导。对付款、退款、删除等动作,应把“准备执行”和“确认执行”拆成不同工具,并要求用户确认后才能进入写操作。

Agent 还需要防止无限循环。为调用设置递归或步数上限,为外部工具设置超时和重试上限,并让工具错误返回可判断的信息。无法完成任务时,应明确缺少什么数据,而不是反复调用同一个失败工具。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

构建可调用工具的 Agent

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通