Última modificación: 11 de septiembre de 2025
En HubSpot, puedes crear un agente de IA que realizará diversas acciones basándose en tus instrucciones. Por ejemplo, puedes crear un agente que te envíe un correo electrónico cada mañana con notas sobre las próximas reuniones del día. Para realizar las tareas, los agentes se apoyan en las herramientas de agente. Las herramientas son como las funciones de un lenguaje de programación: tienen parámetros que pasas a la herramienta y la herramienta devuelve un output. Las herramientas en HubSpot son similares al concepto de herramientas en MCP (Protocolo de contexto del modelo). Una herramienta de agente incluirá las llamadas a la API, pasos para el LLM y otro contexto de apoyo para que la IA pueda hacer su función. Las herramientas están diseñadas para realizar tareas específicas y definidas, como consultar una base de datos, realizar operaciones CRUD (Crear, Leer, Actualizar, Eliminar) o utilizar la IA generativa para resumir contenido. En términos de implementación, una herramienta de agente es una versión mejorada de una acción de workflow personalizada, que crearás utilizando la estructura de proyectos para desarrolladores de HubSpot. Este tutorial te guiará sobre cómo empezar a crear una herramienta de agente.

​
Requisitos previos

Antes de empezar, necesitarás:
  • Instalar la última versión beta de la CLI de HubSpot ejecutando npm i -g @hubspot/cli@next.
  • Crear una cuenta de prueba de desarrollador desde la cuenta de desarrollador que está inscrita en la beta.
  • Autenticar la cuenta de prueba con la CLI ejecutando el comando hs auth en tu terminal.
1

Crear un proyecto

Si empiezas desde cero, primero tendrás que crear un nuevo proyecto. Alternativamente, si quieres utilizar un proyecto existente, puedes pasar a la siguiente sección (se requiere la versión del proyecto 2025.2).Para crear un nuevo proyecto:
  1. En la terminal, ejecuta el siguiente comando para crear un nuevo proyecto a partir de una de las plantillas de inicio rápido.
hs project create --platform-version 2025.2
  1. Sigue las indicaciones de la terminal para configurar el nombre y la ubicación del proyecto y selecciona una plantilla. Se proporcionan varias opciones de plantillas dependiendo de cómo planees distribuir tu aplicación. A efectos de este tutorial, selecciona el proyecto Comenzar el proyecto con la plantilla del mercado de aplicaciones.
  2. La plantilla del proyecto se descargará en tu directorio de trabajo, donde podrás ver su contenido.
Esta plantilla de proyecto incluye todos los archivos necesarios para subir un proyecto con una aplicación que incluya algunas funciones de aplicación de ejemplo. Estas funciones incluyen una tarjeta de aplicación, un webhook y una acción de workflow. A efectos de este tutorial, estos componentes no son necesarios, pero puede ser útil repasarlos por si quieres experimentar con ellos más adelante.
2

Agregar una herramienta de agente al proyecto

Entre bastidores, las herramientas de agente son acciones de workflow personalizadas que se configuran específicamente para el contexto del agente. Para que un agente pueda ejecutar la herramienta, de forma similar a como un workflow ejecutaría una acción, tendrás que habilitar la acción para que esté disponible en los agentes mediante el campo supportedClients.
  • En el directorio workflow-actions, crea un nuevo archivo JSON para la configuración de la herramienta. El archivo puede tener cualquier nombre, pero debe terminar en -hsmeta.json (por ejemplo, my-agent-tool-hsmeta.json).
  • Crea la configuración de la acción utilizando la documentación de referencia de las herramientas del agente. Asegúrate de incluir el cliente AGENTS en el campo supportedClients, como se muestra en el código de ejemplo de abajo.
{
  "uid": "agent_tool_action",
  "type": "workflow-action",
  "config": {
    "actionUrl": "https://example.com",
    "toolType": "GET_DATA",
    "llmDescription": "A description that helps the LLM understand what this tool does.",
    "isPublished": false,
    "supportedClients": [
      {
        "client": "AGENTS"
      },
      {
        "client": "WORKFLOWS"
      }
    ],
    "inputFields": [
      {
        "typeDefinition": {
          "name": "message",
          "type": "string",
          "fieldType": "textarea"
        },
        "supportedValueTypes": ["STATIC_VALUE"],
        "isRequired": false
      }
    ],
    "labels": {
      "en": {
        "actionName": "My custom agent tool",
        "actionDescription": "A description of the tool.",
        "actionCardContent": "Send a notification",
        "inputFieldLabels": {
          "message": "Notification Message"
        },
        "inputFieldDescriptions": {
          "message": "Enter the message to be sent in the notification"
        }
      }
    },
    "objectTypes": ["CONTACT"]
  }
}
Cuando crees tu herramienta, ten en cuenta lo siguiente:
  • Cuando estés desarrollando activamente, no debes establecer tus campos de entrada como obligatorios, ya que los campos obligatorios no pueden actualizarse ni eliminarse una vez subidos.
  • Las solicitudes a los endpoints públicos se realizarán como solicitudes a POST.
Cuando estés listo para subirlos a tu cuenta de prueba, guarda los archivos y ejecuta hs project upload. Si has empezado con un proyecto nuevo, se te pedirá que pulses y para crear el proyecto en la cuenta.

​
Nota:

HubSpot sigue desarrollando activamente funciones para permitir pruebas de herramientas de agente. Esta página se actualizará con más instrucciones una vez que estas funciones de prueba estén disponibles.