Write tool cards the model uses well

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.

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 the course

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

• Decide, with explicit criteria, whether a use case calls for a single call, a workflow or an agent, and choose the right pattern.
• Write tool cards the model uses well (name, description, parameters, return, errors, idempotency, risk level).
• Specify an agent's loop (goal, context, stop conditions, budgets, error handling) and judge whether an orchestrator and subagents are warranted.
• Place human approval points and an agent's permissions according to the blast radius of each action.
• Identify prompt-injection paths through tool outputs and specify structural mitigations that do not rely on the prompt alone.
• Specify the trace of a run and the evaluation of an agent (task success, trajectory, cost, latency, consistency over several trials).

Related courses

• Build an AI assistant for your productAdvanced · ~3 hr
• Design a RAG architecture that fits your productAdvanced · ~3 hr 30 min
• Evaluate an AI feature: test sets, metrics and LLM judgesAdvanced · ~3 hr