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

# Créer un outil d'agent

> Suivez ce tutoriel pour créer un outil d'agent, qui est une action de workflow personnalisée adaptée aux agents 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>

Dans HubSpot, vous pouvez créer un agent IA qui effectuera diverses actions en fonction de vos instructions. Par exemple, vous pouvez créer un agent pour vous envoyer tous les matins un e-mail contenant des notes sur les réunions à venir du jour.

Pour exécuter leurs tâches, les agents s'appuient sur les outils des agents. Les outils sont comme des fonctions dans un langage de programmation : ils ont des paramètres que vous transmettez à l'outil, et l'outil renvoie une sortie. Les outils dans HubSpot sont similaires au concept des outils dans MCP (Model Context Protocol). Un outil d'agent regroupera les appels API, les étapes LLM et d'autres éléments de contexte à l'appui pour permettre à l'IA de faire le travail. Les outils sont conçus pour effectuer des tâches spécifiques et bien définies, telles que l'interrogation d'une base de données, l'exécution d'opérations CRUD (Créer, Lecture, Mettre à jour, Supprimer) ou l'utilisation de l'IA générative pour résumer du contenu.

En termes d'onboarding, un outil agent est une version améliorée d'une action de workflow personnalisée, que vous créerez à l'aide du cadre de projet développeur de HubSpot. Ce tutoriel vous guidera sur la création d'un outil d'agent.

## Conditions préalables

Avant de commencer, vous devrez :

* Installez la dernière version bêta de l'ILC HubSpot en exécutant `npm i -g @hubspot/cli@next`.
* Créez un [compte de test de développeur](/docs/getting-started/account-types#developer-test-accounts) à partir du compte de développeur qui s'est inscrit à la bêta.
* Authentifiez le compte de test auprès de l'ILC en exécutant la [commande `hs auth`](/docs/developer-tooling/local-development/hubspot-cli/reference#authenticate-an-account) dans votre terminal.

<Steps>
  <Step title="Créer un projet">
    Si vous commencez de zéro, vous devrez d'abord créer un nouveau projet. Si vous souhaitez utiliser un projet existant, vous pouvez également [passer à la section suivante](#2.-add-an-agent-tool-to-the-project) (version `2025.2` du projet requise).

    Pour créer un nouveau projet :

    1. Dans le terminal, exécutez la commande ci-dessous pour créer un nouveau projet à partir de l'un des modèles de démarrage rapide boilerplate.

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

    2. Suivez les invites du terminal pour configurer le nom et l'emplacement du projet, puis sélectionnez un modèle. Plusieurs options de modèles sont proposées en fonction de la façon dont vous prévoyez de [distribuer](/docs/apps/developer-platform/build-apps/app-configuration#distribution) votre application. Pour les besoins de ce tutoriel, sélectionnez le modèle **Lancer un projet avec une application marketplace**.

    3. Le modèle de projet sera alors téléchargé dans votre répertoire de travail, où vous pourrez consulter son contenu.

    Ce modèle de projet comprend tous les fichiers nécessaires pour charger un projet avec une application qui comprend quelques exemples de fonctionnalités d'application. Ces fonctionnalités incluent une [carte d'application](/docs/apps/developer-platform/add-features/ui-extensibility/app-cards/create-an-app-card) boilerplate, un [webhook](/docs/apps/developer-platform/add-features/configure-webhooks) et une [action de workflow](/docs/apps/developer-platform/add-features/custom-workflow-actions). Pour les besoins de ce tutoriel, ces composants ne sont pas nécessaires, mais il peut être utile de les passer en revue si vous souhaitez les tester plus tard.
  </Step>

  <Step title="Ajouter un outil d'agent au projet">
    En arrière-plan, les outils d'agent sont des actions de workflow personnalisées configurées spécifiquement pour le contexte de l'agent. Pour qu'un agent puisse exécuter l'outil, de la même manière qu'un workflow exécuterait une action, vous devez permettre à l'action d'être disponible pour les agents utilisant le champ `supportedClients`.

    * Dans le répertoire `workflow-actions`, créez un nouveau fichier JSON pour la configuration de l'outil. Le fichier peut porter n'importe quel nom, mais doit se terminer par `-hsmeta.json` (par exemple, `my-agent-tool-hsmeta.json`).
    * Construisez la configuration de l'action à l'aide de la [documentation de référence sur les outils d'agent](/docs/apps/developer-platform/add-features/agent-tools/reference). Assurez-vous d'inclure le client `AGENTS` dans le champ `supportedClients`, comme indiqué dans l'exemple de code ci-dessous.

    ```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"]
      }
    }
    ```

    Lorsque vous créez votre outil, gardez à l'esprit ce qui suit :

    * Lors du développement actif, vous ne devez <u>pas</u> définir vos champs de saisie comme obligatoires, car les champs obligatoires ne peuvent pas être mis à jour ou supprimés une fois chargés.
    * Les demandes adressées à des points de terminaison publics seront faites en tant que demandes `POST`.

    Lorsque vous êtes prêt à télécharger sur votre compte de test, enregistrez vos fichiers, puis lancez `hs project upload`. Si vous avez commencé avec un nouveau projet, vous serez invité à appuyer sur `y` pour créer le projet dans le compte.

    <Warning>
      ### Remarque :

      HubSpot développe toujours activement des fonctionnalités pour permettre de tester les outils des agents. Cette page sera mise à jour avec de plus amples instructions dès que ces fonctionnalités de test seront disponibles.
    </Warning>
  </Step>
</Steps>