Herramientas del agente
Las herramientas son lo que el agente puede hacer más allá de conversar: consultar un sistema, mostrar una tarjeta, recoger un formulario, mostrar un mapa, buscar en la web, generar una imagen.
La pantalla
Sección titulada «La pantalla»La tabla lista Nombre, Tipo, Habilitada, Orden y Actualizada en, con las acciones Editar y Eliminar. Deshabilitar una herramienta es más seguro que eliminarla cuando solo quieres probar el comportamiento sin ella.
Haz clic en + Nueva Herramienta. El primer campo es el Tipo, y es el que determina el resto del formulario. Después vienen Nombre, Activar herramienta y Descripción.
| Tipo | Para qué sirve | Detallado en |
|---|---|---|
| External API | Llamar a un endpoint de otro sistema | API Externa |
| Sub Agent | Delegar parte del trabajo a otro agente | Herramientas nativas |
| Generic Card / HTML Card | Mostrar contenido con formato en el chat | Herramientas nativas |
| Mapa | Mostrar puntos en el mapa | Herramientas nativas |
| Forms | Recoger datos estructurados | Herramientas nativas |
| Generación de imágenes | Crear imágenes durante la conversación | Herramientas nativas |
| Búsqueda Web | Buscar información actual, con fuentes | Herramientas nativas |
| Enviar Texto / Enviar Archivo / Resolver Contenido de Archivo | Enviar contenido y leer archivos de la conversación | Herramientas nativas |
La descripción es lo que hace funcionar la herramienta
Sección titulada «La descripción es lo que hace funcionar la herramienta»Todos los tipos tienen el campo Descripción, con el aviso “Esta descripción ayuda al LLM a entender cuándo usar esta herramienta”. No es documentación interna: es la instrucción que decide si el agente activa o no la herramienta.
Escríbela como un disparador, no como una etiqueta:
| Evita | Prefiere |
|---|---|
| ”Consulta de pedidos" | "Consulta el estado de un pedido por su número. Úsala siempre que la persona pregunte dónde está su pedido, si ya se envió o cuál es el código de seguimiento." |
| "Búsqueda en la web" | "Busca información pública y actual en internet. Úsala cuando la respuesta dependa de datos que no están en los documentos del agente.” |
Indica también cuándo no usarla, si hay riesgo de activación indebida.
La columna Orden organiza cómo se presentan las herramientas al modelo. En la práctica, los agentes con muchas herramientas se equivocan más al elegir: si el agente activa la herramienta equivocada, el camino no es reordenar, sino reducir el número de herramientas o hacer que las descripciones se distingan más entre sí.
Abre el chat y haz la pregunta que debería activar la herramienta. El bloque Actividad, encima de la respuesta, muestra lo que el agente ejecutó en ese turno: ahí confirmas si la herramienta fue llamada.