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

# Verwendung von Integrationen

> Dieser Guide zeigt dir, wie du Integrationen innerhalb von Agenten verwenden kannst. Wir verwenden das Beispiel der Google Kalender-Integration, aber die Schritte und Gedanken gelten für jede andere Langdock- oder benutzerdefinierte Integration.

## Agenten-Konfigurator

Erstelle im Agenten-Konfigurator einen Agenten, der in der Lage sein soll, die Integration zu nutzen. Du kannst die Anleitung zum [Erstellen eines Agenten](/de/using-langdock/guides/agents/agent-creation) verwenden, um mehr über das Erstellen großartiger Agenten zu erfahren.

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_1-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=bea4232d0d1e54c55cae6538986681bd" alt="/images/new_integrations_1.png+_existingInIndexedDbMintlify" width="3132" height="2320" data-path="images/new_integrations_1-de.png" />

### Aktionen hinzufügen

Im Agenten-Konfigurator kannst du jetzt Aktionen der in deinem Workspace aktivierten Integrationen hinzufügen.\\

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_2-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=889b186d09b29ecd561198e95c820d2c" alt="/images/new_integrations_2.png+_existingInIndexedDbMintlify" width="3130" height="2322" data-path="images/new_integrations_2-de.png" />

Suche und wähle die Aktion deiner Wahl aus und füge sie deinem Agenten hinzu, indem du entweder eine individuelle Verbindung oder eine vorausgewählte Verbindung wählst.

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_3-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=d16f040dbe5f7e1f5fe5450c6f08bf17" alt="/images/new_integrations_3.png+_existingInIndexedDbMintlify" width="3144" height="2324" data-path="images/new_integrations_3-de.png" />

**Individuelle Verbindungen** ermöglichen es dir, dein eigenes Konto (in diesem Fall deinen Google Kalender) zu verbinden und den Agenten mit deinen Zugriffsrechten, Ressourcen und Einschränkungen agieren zu lassen. Dies erfordert eine OAuth-Authentifizierung entweder beim ersten Auslösen einer Aktion oder über das Integrationsmenü. Wähle während der OAuth-Authentifizierung das Konto aus, das der Agent verwenden soll, und erlaube den von Langdock angeforderten Zugriff.

**Vorausgewählte Verbindungen** können von allen Nutzern dieses Agenten bei Verwendung dieser Aktion ausgewählt werden. Daher muss hier auf die Zugriffsregeln geachtet werden.

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_4-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=ed58eeb8e560d94cbf869d1bdf4b9f03" alt="/images/new_integrations_4.png+_existingInIndexedDbMintlify" width="3130" height="2322" data-path="images/new_integrations_4-de.png" />

Nach dem Hinzufügen der Aktion kannst du auswählen, ob die Ausführung deiner Bestätigung bedarf oder automatisch ausgelöst werden kann. Bei aktivierter Bestätigung zeigt dir der Agent vor der Ausführung immer die Aktion und ihre Eingabeparameter an.

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_5-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=fec4b5adfc6d32a8e758e58fa6017582" alt="/images/new_integrations_5.png+_existingInIndexedDbMintlify" width="3128" height="2322" data-path="images/new_integrations_5-de.png" />

### Aktionen benutzen

Jetzt kannst du Integrationen in deinem Agenten verwenden. Der Agent löst automatisch Aktionen basierend auf dem Kontext der Unterhaltung aus. Wenn ein Agent viele Aktionen hat, sucht er zuerst nach den für deine Anfrage relevanten Aktionen, statt alle auf einmal zu berücksichtigen. Das siehst du als kurzen „Tools werden gesucht“-Schritt im Chat. Wenn eine Aktion eine Bestätigung erfordert, wird dir die entsprechende Anfrage mit Eingabeparametern angezeigt. Durch Klicken auf „Bestätigen“ wird die Aktion ausgelöst.

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_6-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=681dfb440a5d0034ffe6b89343b714c9" alt="/images/new_integrations_6.png+_existingInIndexedDbMintlify" width="3130" height="2324" data-path="images/new_integrations_6-de.png" />

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_7-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=764e68067a7055125973faecc5eb37f9" alt="/images/new_integrations_7.png+_existingInIndexedDbMintlify" width="3128" height="2324" data-path="images/new_integrations_7-de.png" />

## Empfehlungen zur Nutzerfreundlichkeit

### Hinzufügen von Aktionen zu einem Agenten

Sei großzügig, wenn du einem Agenten Aktionen hinzufügst. Einige Integrationen verfügen über Aktionen zum Sammeln von Kontextinformationen, wie beispielsweise „Get deal context“ von HubSpot, das interne IDs für Pipelines und Stages abruft. Dies ermöglicht eine reibungslosere Verwendung von Aktionen wie „Create deal“ oder „Update deal“, da du den Agenten bitten kannst, alle vorhandenen Pipelines abzurufen und in natürlicher Sprache anzugeben, welche davon verwendet werden soll, anstatt die IDs in deinen HubSpot-Einstellungen nachzuschlagen.

<img src="https://mintcdn.com/langdock-34/8bLbHvNpK3QOS1yw/images/new_integrations_8-de.png?fit=max&auto=format&n=8bLbHvNpK3QOS1yw&q=85&s=dec1747cb9feb3f18aa004f9bfefb58a" alt="/images/new_integrations_8.png+_existingInIndexedDbMintlify" width="2968" height="2154" data-path="images/new_integrations_8-de.png" />

### Bestätigungspflichtige Aktionen

Standardmäßig müssen alle Aktionen bestätigt werden. Wir empfehlen folgende Konfiguration je nach Art der Aktion:

**Keine Bestätigung erforderlich:** Aktionen zum Sammeln, Herunterladen, Suchen oder Lesen von Informationen. Dies ermöglicht eine schnellere Informationsbeschaffung bei minimalem Risiko.

**Bestätigung empfohlen:** Aktionen zum Erstellen, Aktualisieren oder Löschen von Objekten. So kannst du die vom Modell generierten Parameter vor der Ausführung überprüfen.

## FAQ

<AccordionGroup>
  <Accordion title="Wann sollte ich Integrationen nutzen?">
    Nutze Integrationen, wenn Langdock auf Informationen in externen Tools zugreifen oder dort Aktionen ausführen soll. Integrationen eignen sich, um Unternehmensdaten abzurufen, Aktionen auszulösen, Einträge zu aktualisieren oder Agenten und Workflows mit deinem Tool-Stack zu verbinden.
  </Accordion>

  <Accordion title="Was sollte ich prüfen, wenn eine Integration nicht wie erwartet funktioniert?">
    Prüfe die Verbindung, die Berechtigungen, die OAuth-Scopes, die aktivierten Aktionen und ob das verbundene Konto im externen Tool Zugriff auf die angefragte Ressource hat. Wenn die Integration bei einem User funktioniert und bei einem anderen nicht, vergleiche deren Berechtigungen.
  </Accordion>
</AccordionGroup>
