# Invoke agent — Botize Agents

Botize method — `agents.invoke` (action).

Invoke an agent by its key. The step is just a pointer: the agent's identity (role, brain, tools) lives in the config.json of its folder, next to its documents and memory.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `agent_key` *(string)* — Agent key
- `user_content` *(string)* — User message
- `session_id` *(string)* — Session (optional)

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{result}}` *(text)* — Answer. The text answer produced by the agent.
e.g. Hello, how can I help you?

## Account

Needs a connected Botize Agents account in Botize: https://botize.com/en/app/agents/authenticate

## This app

Every trigger and action for Botize Agents: https://botize.com/en/app/agents.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/agents/invoke