Skip to content

Create an agent

The agent definition: model, tools in JSON Schema, and step limit.

Updated on Aug 09, 2026

The agent is a persistent resource: define it once, run it as many times as you want. Tools are declared in JSON Schema — the model sees the name, the description, and the parameters.

POSThttps://api.hinow.ai/v1/agentsBearer

Creates an agent with a set of tools.

Parâmetros

  • namestring· bodyobrigatório
  • modelstring· bodyobrigatório
  • toolsarray· bodyobrigatório

    JSON Schema definitions.

  • max_stepsinteger· body

    Default 10. Loop limit.

Respostas

201Agent created
agente.jsonjson
{
  "name": "estoque",
  "model": "hinow/himax",
  "max_steps": 6,
  "tools": [{
    "name": "get_stock",
    "description": "Consulta o estoque de um SKU",
    "parameters": {
      "type": "object",
      "properties": { "sku": { "type": "string" } },
      "required": ["sku"]
    }
  }]
}
Was this page helpful?