AX-300 · Lesson 4 of 12 · Module 2: Tools and Data · 3:10

Give it the right tools

A tool is an action the agent can ask for; behind it there is usually an API, a door one program offers to others. The agent never runs a tool itself: it asks by name with the inputs filled in, and the agent builder runs it and returns the result, so the description is all the agent knows. Good descriptions say what the tool does, when to use it and when not, the inputs with their limits and what comes back, and good errors say how to fix the call. Narrow tools return only what the job needs; read tools come first, then draft tools, and tools that send or spend last, behind an approval. Worked example: a vague “orders” tool returned 386 orders with names and addresses; a narrow “sales by tea” tool returns totals only.

Frame from lesson 4 of Sophyx Certified AI Agent Builder – Professional, "Give it the right tools"

What you will learn

  • Write a tool description an agent can follow
  • Narrow a tool to return only what’s needed
  • Keep read, draft and send tools apart

The one thing to remember

Narrow tools, clear words, drafts before sends.

Common mistake: Giving the agent a do-everything tool

A wide tool returns far more than the job needs, puts customer data where it doesn’t belong, and lets one wrong choice do real damage.

The fix: Give it narrow tools with clear descriptions, and drafts before sends.

Key terms

API
A door one program offers so other programs can use it.
Tool description
Plain words telling the agent what a tool does, and when.
Read-only tool
A tool that can look things up but change nothing.

Part of AI Agent Builder (AX-300)

For people who run AI workflows: build an agent with the right tools, tests and guardrails, and approvals where it counts.

12 lessons, practice quizzes, a final exam and the Sophyx Certified AI Agent Builder – Professional certificate. Regular price USD 49.99. Your first certification is free. Free with any paid Sophyx plan.

Start the course free
Book a Demo