OpenAI Fine-Tuning for Tool-Calling Agents on GPT-4o (2026)

TL;DR — Fine-tune gpt-4o-mini before reaching for gpt-4o. With 200–500 high-quality JSONL examples that include the full tools array per row, you can lift function-arg accuracy from ~82% (vanilla prompt) to 95%+ on a vertical tool surface, at $25/M training tokens and $0.30/$1.20 per 1M inference tokens.

What it does

OpenAI supervised fine-tuning (SFT) for tool-calling teaches a model which tool to pick, which arguments to fill, and how to format the call for your specific tool surface. Vanilla GPT-4o handles the public schema well, but vertical agents have private quirks — phone numbers in E.164, ICD-10 codes for healthcare, time zones inferred from caller location — that prompt-only systems hallucinate in 10–20% of calls.

Strict mode is supported during training but disabled at inference time when a fine-tuned model emits parallel tool calls, so design your training set to bias toward sequential calls if argument validation is critical.

How it works

1. Capture — log production traces (prompt + tools array + correct response) using the Stored Completions API (store: true).
2. Curate — keep ~200–500 examples that represent the hard tail (ambiguous intents, multi-tool flows, edge cases).
3. Format — JSONL with one record per turn, each containing messages and the same tools array used in production.
4. Train — POST /v1/fine_tuning/jobs with model gpt-4o-mini-2024-07-18 or gpt-4o-2024-08-06.
5. Eval — run an OpenAI Evals suite on a held-out 50–100 cases; gate the deploy on tool-name accuracy AND argument exact-match.

flowchart TD
  PROD[Production traces] -->|store:true| LOG[(Stored Completions)]
  LOG --> CURATE[Curate 200-500 hard cases]
  CURATE --> FMT[JSONL: messages + tools]
  FMT --> JOB[Fine-tune gpt-4o-mini]
  JOB --> EVAL[OpenAI Evals]
  EVAL -->|pass 95%| DEPLOY[Deploy]
  EVAL -->|fail| CURATE

CallSphere implementation

CallSphere runs 37 specialized agents across 6 verticals (healthcare, behavioral health, salon, dental, MSP, real estate), each with a private slice of the 90+ shared tool surface and 115+ DB tables. Healthcare's post-call analytics agent runs on gpt-4o-mini specifically because the tool surface is narrow (12 functions) and SFT lifts arg-accuracy from 84% to 96%. The OneRoof real-estate vertical uses the OpenAI Agents SDK which natively respects the fine-tuned model's tool routing.

Explore a live demo and compare current plans to find the right fit for your business.

Build steps with code

# 1. Capture traces in production
client.chat.completions.create(
    model="gpt-4o",
    messages=msgs,
    tools=tools,
    store=True,                          # 30-day retention
    metadata={"app": "voice-router"},
)

# 2. Format one JSONL row
{"messages":[
   {"role":"system","content":"..."},
   {"role":"user","content":"book me with Dr. Patel tomorrow at 3"},
   {"role":"assistant","tool_calls":[{
      "id":"call_1","type":"function",
      "function":{"name":"create_appointment",
        "arguments":"{\"provider\":\"dr_patel\",\"start\":\"2026-05-08T15:00-04:00\"}"}}]}
 ],
 "tools":[ /* same tools array as production */ ]}

# 3. Launch the job
client.fine_tuning.jobs.create(
    training_file=file.id,
    model="gpt-4o-mini-2024-07-18",
    hyperparameters={"n_epochs":3},
)

Pitfalls

• Missing the tools array on every row — without it, the model forgets the schema and falls back to natural-language tool descriptions.
• Over-fitting to one persona — 500 examples from a single agent creates a brittle model. Mix at least 3 agents/personas.
• Strict mode surprise — strict mode is disabled at inference for fine-tuned models when emitting parallel calls; if you need strict, force sequential.
• Skipping evals — train loss going down doesn't mean tool accuracy went up. Always run a held-out eval.

FAQ

Q: gpt-4o or gpt-4o-mini? Start with mini ($25/M training, $0.30/$1.20 inference). Only escalate to gpt-4o if mini's eval ceiling is too low after 3 epochs.

Q: How many examples are enough? 200 for a narrow surface (≤10 tools). 500–2,000 if you have 50+ tools or multi-step planning. Quality > volume.

Q: Will fine-tuning beat a bigger prompt? For tool selection, yes — past ~5 tools, prompt engineering returns flatten while SFT keeps lifting accuracy.

Q: What about catastrophic forgetting? Mix 10–15% general instruction-following examples to preserve out-of-domain reasoning.

Q: Do I need DPO too? Not initially. SFT first, measure, then add DPO if you have preference pairs (good vs bad call argument).

Sources

• OpenAI Fine-Tuning Docs
• Fine-tuning now available for GPT-4o
• OpenAI Function Calling Guide
• Azure: Fine-tuning gpt-4o & mini extended support