Skip to content

Agents

Agents with tools: definition, step-by-step execution, and call history.

Updated on Aug 09, 2026

An agent is a model with tools and a step limit. You declare what it can call, and the platform handles the loop: the model asks for a tool, you return the result, it decides the next step — until it answers or hits the limit.

The loop

  1. 1

    Define

    A POST https://api.hinow.ai/v1/agents with the tools, the model, and the step limit.

  2. 2

    Run

    A POST https://api.hinow.ai/v1/agents/{id}/runs with the user message.

  3. 3

    Respond to the tools

    The run stops at requires_action with the requested calls; you return the results.

  4. 4

    Read the result

    The run goes back to completed and brings the final answer and the step history.

Create an agentTools in JSON Schema and the step limit.OpenRunRun the agent over a message.OpenRun stepsEach tool call, with arguments and tokens.Open
Was this page helpful?