> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thaliq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Acciones que el agente puede ejecutar — HTTP, MCP, A2A, nativas

Las **tools** son las acciones que tu agente puede ejecutar durante una conversacion. Permiten que la IA interactue con sistemas externos: tu API, MCP servers, otros agentes del tenant, o funciones nativas de Thaliq.

<Note>
  Las tools son **propias de cada agente**, no compartidas a nivel tenant. Si tenes varios agentes, cada uno define su propio set. Al [eliminar un agente](/platform/agent-setup) sus tools se borran en cascada.
</Note>

## Tipos de tools

<CardGroup cols={2}>
  <Card title="Nativas" icon="cube">
    Built-in de Thaliq (ej: `search_documents` para RAG). No requieren configuracion.
  </Card>

  <Card title="HTTP" icon="globe">
    Llaman a cualquier API REST que configures con metodo, URL, headers y body template.
  </Card>

  <Card title="MCP" icon="server">
    Importadas desde [MCP Servers](/platform/mcp-servers). Heredan headers del server. *(Growth+)*
  </Card>

  <Card title="A2A — Agent to Agent" icon="git-merge">
    Otro agente del tenant aparece como una tool `ask_<slug>`. Ver [A2A](/platform/a2a). *(Growth+)*
  </Card>
</CardGroup>

## Como llegar

`thaliq.com/agents/:agentId/tools`. Tambien podes pedirle al meta-agente del [Studio](/platform/studio): *"Crea una tool que consulte el stock de productos en mi API"*.

## Crear una HTTP Tool

1. Ir a **Agente > Tools**
2. Click en **Crear Tool**
3. Configurar:

| Campo             | Descripcion                                                         |
| ----------------- | ------------------------------------------------------------------- |
| **Nombre**        | Nombre descriptivo (ej: `consultar_stock`). Slug-like, sin espacios |
| **Descripcion**   | Que hace la tool — el agente usa esto para decidir cuando invocarla |
| **Metodo**        | GET, POST, PUT, DELETE                                              |
| **URL**           | Endpoint de tu API (ej: `https://api.tuempresa.com/products/stock`) |
| **Headers**       | Custom headers (ej: `Authorization`, `x-api-version`)               |
| **Body template** | Template de body para POST/PUT con variables                        |
| **Parametros**    | Schema de los parametros que el modelo debe llenar                  |
| **Requires auth** | Si la tool necesita auth del usuario final                          |

<Tip>
  La **descripcion** es critica. El agente la usa para decidir cuando invocar la tool. Se claro y especifico:

  *"Consulta el stock disponible de un producto por su codigo SKU. Retorna cantidad disponible y ubicacion en almacen."*
</Tip>

## Visibilidad: Widget vs SDK

Cada tool tiene la propiedad `requiresAuth`:

| Valor   |   Widget   | SDK / API |
| ------- | :--------: | :-------: |
| `false` |   Visible  |  Visible  |
| `true`  | No visible |  Visible  |

**Usa `requiresAuth: false`** para tools publicas (consultar info, FAQs, catalogo).

**Usa `requiresAuth: true`** para tools que acceden a datos del usuario (mis pedidos, mi cuenta, mi historial). Requieren `X-Integration-Type: sdk` y autenticacion via JWT.

## Custom headers

Podes agregar headers personalizados a tus tools HTTP. Utiles para:

* Versionado (`x-api-version: v2`)
* Identificacion de region (`x-country: PE`)
* Tokens estaticos compartidos

Los headers se envian en cada ejecucion. Las tools MCP heredan headers del MCP Server padre (visible en readonly).

### Orden de precedencia

```
1. Headers base (Content-Type: application/json)
2. customHeaders del MCP Server (solo MCP tools)
3. customHeaders de la tool (puede override)
4. Authorization (passthrough o stored)
```

## Tool nativas

| Tool               | Para que                                     |
| ------------------ | -------------------------------------------- |
| `search_documents` | Busca chunks relevantes en el RAG del agente |

Las nativas se activan automaticamente si el feature esta disponible en tu plan (RAG: Growth+).

## Limites por plan

| Plan       |  Tools max |
| ---------- | :--------: |
| Free       |      3     |
| Starter    |     10     |
| Growth     |     20     |
| Scale      | Ilimitadas |
| Enterprise | Ilimitadas |

## Que sigue

<CardGroup cols={2}>
  <Card title="MCP Servers" icon="server" href="/platform/mcp-servers">
    Conectar MCP Servers e importar sus tools.
  </Card>

  <Card title="A2A" icon="git-merge" href="/platform/a2a">
    Conectar otros agentes del tenant como tools.
  </Card>

  <Card title="Instrucciones" icon="list-check" href="/platform/instructions">
    Asociar acciones HITL a tools especificas.
  </Card>

  <Card title="Workflows" icon="git-branch" href="/platform/workflows">
    Formularios guiados con tool\_call steps.
  </Card>
</CardGroup>