工具

模型不能直接、安全地读取你的客户数据库、订单系统或私有业务状态。工具让 Agent 可以请求调用由应用拥有的函数，而数据访问、授权和副作用仍由你的服务控制。

Python

from agents import function_tool, Runner
from iztro_agents import ChatSession, iztro_ziwei_agent

@function_tool
def lookup_customer(customer_id: str) -> str:
    return "客户正在使用年度套餐。"

agent = iztro_ziwei_agent(tools=[lookup_customer])
session = ChatSession(external_user_id="user_42")
result = await Runner.run(agent, "回答时请使用我的客户资料。", session=session)

TypeScript

import {tool, run} from '@openai/agents';
import {ChatSession, iztroZiweiAgent} from 'openai-iztro-agents';

const lookupCustomer = tool({
  name: 'lookup_customer',
  description: '读取客户资料',
  parameters: {type: 'object', properties: {customerId: {type: 'string'}}, required: ['customerId']},
  execute: async ({customerId}: {customerId: string}) => `${customerId} 正在使用年度套餐。`,
});
const agent = iztroZiweiAgent({tools: [lookupCustomer]});
const session = new ChatSession({externalUserId: 'user_42'});
await run(agent, '回答时请使用我的客户资料。', {session});

真实示例：07_multi_step_booking.py

这个示例会顺序使用两个本地工具：先检查日历是否空闲，只有目标日期空闲时才创建预约。下面直接展示与页面语言对应的完整真实输出。

源码：examples/07_multi_step_booking.py。

本次运行使用的 Prompt

我出生于1990年6月15日上午10点，男性。请根据我的命盘，为下周的重要会议找一个合适的日子，先检查日历，如果有空再帮我预约。

完整真实输出

正在加载真实输出…