Skip to content
Module
Module 3 of 7Lesson 1 of 2~19 min

Write tool cards the model uses well

An agent is only as good as the tools it gets, and a poorly named or poorly described tool leads it into silent mistakes. This lesson teaches you to design an agent's tooling and document each tool so the model uses it wisely and the application stays in control of risky actions.

Lesson objective

By the end of this lesson, you will be able to design an agent's set of tools (consolidated by task, named unambiguously) and write a complete card for each: description, parameters, return, risk level and application checks.

Topics covered

  • tool calling
  • agent tools
  • function calling
  • tool specification
  • AI agents

In the glossary

Full glossary

Where it fits

Design tools the model uses well

Which tools should the agent get, how should they be described, and what happens when they fail?

Lessons in this module

  1. Write tool cards the model uses well (this lesson)
  2. Specify tool errors and idempotency

What you will learn in this module

This lesson is part of the course Design reliable agents and tool calling

  • Write tool cards the model uses well (name, description, parameters, return, errors, idempotency, risk level).