Skip to main content
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.
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 sus tools se borran en cascada.

​
Tipos de tools

Nativas

Built-in de Thaliq (ej: search_documents para RAG). No requieren configuracion.

HTTP

Llaman a cualquier API REST que configures con metodo, URL, headers y body template.

MCP

Importadas desde MCP Servers. Heredan headers del server. (Growth+)

A2A — Agent to Agent

Otro agente del tenant aparece como una tool ask_<slug>. Ver A2A. (Growth+)

​
Como llegar

thaliq.com/agents/:agentId/tools. Tambien podes pedirle al meta-agente del 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:
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.”

​
Visibilidad: Widget vs SDK

Cada tool tiene la propiedad requiresAuth: 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

​
Tool nativas

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

​
Limites por plan

​
Que sigue

MCP Servers

Conectar MCP Servers e importar sus tools.

A2A

Conectar otros agentes del tenant como tools.

Instrucciones

Asociar acciones HITL a tools especificas.

Workflows

Formularios guiados con tool_call steps.