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

# Ein Agent-Tool erstellen

> Folgen Sie diesem Tutorial, um ein Agent-Tool zu erstellen, bei dem es sich um eine benutzerdefinierte Workflow-Aktion handelt, die auf KI-Agents zugeschnitten ist.

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

In HubSpot haben Sie die Möglichkeit, einen KI-Agent zu erstellen, der verschiedene Aktionen basierend auf Ihren Anweisungen ausführt. Sie können zum Beispiel einen Agent schaffen, der Ihnen jeden Morgen eine E-Mail mit Notizen zu den anstehenden Meetings des Tages schickt.

Um Aufgaben auszuführen, verlassen sich Agents auf Agent-Tools. Tools sind wie Funktionen in einer Programmiersprache und verwenden Parameter, die Sie bestimmen – woraufhin das Tool dann antwortet. Die Tools in HubSpot ähneln dem Konzept der Tools in MCP (Model Context Protocol). Ein Agent-Tool bündelt API-Aufrufe, LLM-Schritte und anderen unterstützenden Kontext, damit KI die Arbeit erledigen kann. Diese Tools sind für bestimmte, klar definierte Aufgaben vorgesehen, wie zum Beispiel das Abfragen einer Datenbank, das Ausführen von CRUD-Operationen (Erstellen, Lesen, Aktualisieren, Löschen) oder die Verwendung generativer KI zur Zusammenfassung von Inhalten.

In Hinblick auf die Implementierung ist ein Agent-Tool eine erweiterte Version einer benutzerdefinierten Workflow-Aktion, die Sie mit dem Entwicklerprojekt-Framework von HubSpot erstellen. Dieses Tutorial zeigt Ihnen, wie man ein Agent-Tool erstellt.

## Voraussetzungen

Bevor Sie loslegen, sind folgende Dinge zu erledigen:

* Installieren Sie die neueste Beta-Version des HubSpot CLI, indem Sie `npm i -g @hubspot/cli@next`ausführen.
* Erstellen Sie einen [Entwickler-Test-Account](/getting-started/account-types#developer-test-accounts) innerhalb des Entwickler-Accounts, der für die Beta-Phase angemeldet ist.
* Authentifizieren Sie den Test-Account mit der CLI, indem Sie den [`hs auth`-Befehl](/developer-tooling/local-development/hubspot-cli/reference#authenticate-an-account) in Ihrem Terminal ausführen.

<Steps>
  <Step title="Ein Projekt erstellen">
    Wenn Sie ganz von vorne anfangen, müssen Sie zuerst ein neues Projekt erstellen. Falls Sie ein vorhandenes Projekt verwenden möchten, können Sie [den nächsten Abschnitt überspringen](#2.-add-an-agent-tool-to-the-project) (Projektversion `2025.2` erforderlich).

    So erstellen Sie ein neues Projekt:

    1. Führen Sie im Terminal den folgenden Befehl aus, um ein neues Projekt aus einer der Boilerplate-Schnellstart-Vorlagen zu erstellen.

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

    2. Befolgen Sie die Terminal-Eingabeaufforderungen, um den Projektnamen und -speicherort zu konfigurieren, und wählen Sie dann eine Vorlage aus. Je nachdem, wie Sie Ihre App [verteilen](/apps/developer-platform/build-apps/app-configuration#distribution) möchten, stehen mehrere Vorlageoptionen zur Verfügung. Wählen Sie für die Zwecke dieses Tutorials die **App-Vorlage „Projekt mit Marketplace starten“** aus.

    3. Die Projektvorlage wird dann in Ihr Arbeitsverzeichnis heruntergeladen, wo Sie sich ihren Inhalt anschauen können.

    Diese Projektvorlage enthält alle nötigen Dateien zum Hochladen eines Projekts mit einer App, die einige Anwendungsbeispielfunktionen enthält. Zu diesen Funktionen gehören u. a. eine [Boilerplate-App-Karte](/apps/developer-platform/add-features/ui-extensibility/app-cards/create-an-app-card), ein [Webhook](/apps/developer-platform/add-features/configure-webhooks) und eine [Workflow-Aktion](/apps/developer-platform/add-features/custom-workflow-actions). Für die Zwecke dieses Tutorials werden diese Komponenten nicht benötigt, aber es kann hilfreich sein, sie sich anzusehen, wenn Sie später mit ihnen experimentieren möchten.
  </Step>

  <Step title="Dem Projekt ein Agent-Tool hinzufügen">
    Eigentlich sind Agent-Tools benutzerdefinierte Workflow-Aktionen, die speziell für den Agent-Kontext konfiguriert sind. Damit ein Agent das Tool ausführen kann, müssen Sie – ganz so wie ein Workflow eine Aktion ausführen würde – die Aktion aktivieren, damit sie in Agents, die das `supportedClients`-Feld verwenden, verfügbar ist.

    * Erstellen Sie dazu im `workflow-actions`-Verzeichnis eine neue JSON-Datei für die Tool-Konfiguration. Die Datei kann einen beliebigen Namen haben, muss aber mit `-hsmeta.json` enden (z. B. `my-agent-tool-hsmeta.json`).
    * Definieren Sie die Aktionskonfiguration mithilfe der [Referenzdokumentation für Agent-Tools](/apps/developer-platform/add-features/agent-tools/reference). Stellen Sie sicher, dass Sie den `AGENTS`-Client im `supportedClients`-Feld angeben, wie im Beispielcode unten gezeigt.

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

    Beachten Sie beim Erstellen Ihres Tools Folgendes:

    * Wenn Sie sich im Entwicklungsprozess befinden, sollten Sie Ihre Eingabefelder <u>nicht</u> als Pflichtfelder festlegen, da diese nach dem Hochladen nicht aktualisiert oder entfernt werden können.
    * Anfragen an öffentliche Endpunkte werden als `POST`-Anfragen gestellt.

    Wenn Sie bereit sind, auf Ihren Test-Account hochzuladen, speichern Sie bitte Ihre Dateien und führen Sie dann `hs project upload` aus. Falls Sie mit einem neuen Projekt begonnen haben, werden Sie aufgefordert, auf `y` zu klicken , um das Projekt im Account zu erstellen.

    <Warning>
      ### Hinweis:

      HubSpot entwickelt weiterhin aktiv Funktionen, die das Testen von Agent-Tools ermöglichen. Diese Seite wird mit weiteren Anweisungen aktualisiert, sobald diese Testfunktionen verfügbar sind.
    </Warning>
  </Step>
</Steps>