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:
CampoDescripcion
NombreNombre descriptivo (ej: consultar_stock). Slug-like, sin espacios
DescripcionQue hace la tool — el agente usa esto para decidir cuando invocarla
MetodoGET, POST, PUT, DELETE
URLEndpoint de tu API (ej: https://api.tuempresa.com/products/stock)
HeadersCustom headers (ej: Authorization, x-api-version)
Body templateTemplate de body para POST/PUT con variables
ParametrosSchema de los parametros que el modelo debe llenar
Requires authSi la tool necesita auth del usuario final
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:
ValorWidgetSDK / API
falseVisibleVisible
trueNo visibleVisible
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

ToolPara que
search_documentsBusca 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

PlanTools max
Free3
Starter10
Growth20
ScaleIlimitadas
EnterpriseIlimitadas

​
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.