Superagento.
All tutorials
Workflows · Lesson 03

An Agent with tools and structured output

Connect a model, calculator and output schema, then inspect the actual tool call and validated answer.

Live example

Use the player’s settings for English captions and speed. If playback is unavailable, read the transcript below.

Watch on YouTube

Before you run it

Recorded live with fictional arithmetic. The first attempt failed JSON validation; an explicit JSON instruction fixed the successful retry. Model availability and credit costs can change. No external messages were sent.

Read the related guide Open your canvas Download example workflow

Import the workflow JSON and choose an available model and account. Review every action before a live test.

Includes a recorded live example using demo data. Configuration close-ups and callouts explain the steps.
English narration generated with Kokoro Heart.

Try it step by step

  1. 1. A useful answer, with evidence

    An Agent can combine reasoning with a focused tool. This example calculates a fictional total and returns a validated record, a useful pattern for estimates and operational checks.

    THE USE CASEModel + Calculator + Structured Output

  2. 2. Make the task and answer explicit

    Ask the Agent to evaluate one hundred twenty-five times four, plus eighty, using Calculator. Explicitly request a JSON object with one numeric field named total. The first attempt failed validation until this instruction was clarified.

    01 / AGENT INSTRUCTIONS125 × 4 + 80 → JSON

  3. 3. Connect the reasoning model

    Connect a Chat Model to the Model port. This recorded example uses an available Gemini model through Superagento credits. The resource is part of the Agent and does not run as a separate workflow step.

    02 / CHAT MODELGemini · Superagento credits

  4. 4. Enable one focused tool

    Enable Calculator and connect the resource to the Tools port. Leave unrelated tools disabled. During the successful run, the Agent chose this tool and passed the exact arithmetic expression to it.

    03 / CALCULATORCalculator · 1 enabled tool

  5. 5. Define the result contract

    Choose Single record in Structured Output. Add total as a required number and attach the Output port. This shape is validated before later workflow steps can use the answer.

    04 / STRUCTURED OUTPUTSingle record · total · number

  6. 6. Read the answer and the tool trail

    The successful run returned five hundred eighty. The activity shows two model calls and one calculator call. Inspect both the answer and the tool evidence before adapting this pattern for your own workflow.

    THE REAL RESULT{"total": 580}
Read the English transcript

An Agent can combine reasoning with a focused tool. This example calculates a fictional total and returns a validated record, a useful pattern for estimates and operational checks.

Ask the Agent to evaluate one hundred twenty-five times four, plus eighty, using Calculator. Explicitly request a JSON object with one numeric field named total. The first attempt failed validation until this instruction was clarified.

Connect a Chat Model to the Model port. This recorded example uses an available Gemini model through Superagento credits. The resource is part of the Agent and does not run as a separate workflow step.

Enable Calculator and connect the resource to the Tools port. Leave unrelated tools disabled. During the successful run, the Agent chose this tool and passed the exact arithmetic expression to it.

Choose Single record in Structured Output. Add total as a required number and attach the Output port. This shape is validated before later workflow steps can use the answer.

The successful run returned five hundred eighty. The activity shows two model calls and one calculator call. Inspect both the answer and the tool evidence before adapting this pattern for your own workflow.