Function Calling And Tool Orchestration

Workflow requires the next turn to call some tool (no plain text); operator wants to force a tool call.

Set tool_choice='required' so the model must call one of the provided tools. To force a specific tool, use tool_choice={type:'function',function:{name:...}}. Handle the returned tool_calls[].

Assistant turn returns two tool_calls (get_weather SF, get_weather NYC), each with a distinct id; agent executes both.

Return one role=tool message per tool_call_id, matched exactly by id, before the next model turn. Every tool_call must be answered.

Two tools: search_orders (by order id) and search_customers (by email). User asks 'find the order for jane@acme.com'.

Descriptions must encode routing — search_orders should state it needs an order id, search_customers that it resolves a customer by email first. Verify the model can chain customer→order rather than guessing.