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

# Crear una herramienta de agente

> Sigue este tutorial para construir una herramienta de agente, que es una acción de workflow personalizada adaptada a los agentes de IA.

<style>
  {`
    .table-key, .table-key div, .table-key p {
      margin: 0;
      font-size: 14px;
    }
    code {
      text-wrap:nowrap!important;
    }
    td code {
      text-wrap: wrap!important;
    }
    `}
</style>

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](/getting-started/account-types#developer-test-accounts) desde la cuenta de desarrollador que está inscrita en la beta.
* Autenticar la cuenta de prueba con la CLI ejecutando el [comando `hs auth` ](/developer-tooling/local-development/hubspot-cli/reference#authenticate-an-account) en tu terminal.

<Steps>
  <Step title="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](#2.-add-an-agent-tool-to-the-project) (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.

    ```shell theme={null}
    hs project create --platform-version 2025.2
    ```

    2. 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](/apps/developer-platform/build-apps/app-configuration#distribution) tu aplicación. A efectos de este tutorial, selecciona el proyecto **Comenzar el proyecto con la plantilla del mercado de aplicaciones**.

    3. 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](/apps/developer-platform/add-features/ui-extensibility/app-cards/create-an-app-card), un [webhook](/apps/developer-platform/add-features/configure-webhooks) y una [acción de workflow](/apps/developer-platform/add-features/custom-workflow-actions). A efectos de este tutorial, estos componentes no son necesarios, pero puede ser útil repasarlos por si quieres experimentar con ellos más adelante.
  </Step>

  <Step title="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](/apps/developer-platform/add-features/agent-tools/reference). Asegúrate de incluir el cliente `AGENTS` en el campo `supportedClients`, como se muestra en el código de ejemplo de abajo.

    ```json theme={null}
    {
      "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, <u>no</u> 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.

    <Warning>
      ### 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.
    </Warning>
  </Step>
</Steps>