# Verwalteter KI-Agent

**Managed AI Agent** ist eine autonome Schleife *nachdem* die Arbeit bekannt ist — normalerweise [On Call End](https://docs.voicelogica.ai/de/workflows/on-call-end/). Es ist nicht [KI-Antwort an Anrufer](https://docs.voicelogica.ai/de/workflow-nodes/ai-response/). Er wird nicht auf der Leitung sprechen.

  <ShotPlaceholder
    src="/assets/workflow-nodes/managed-agent.png"
    name="wn-ma"
    alt="Verwalteter KI-Agent — Aufgabe"
    capture="Managed AI Agent node on Task. 1600×900. No emails."
  />

## Warum dieser Knoten

Das Ticket einreichen, das CRM aktualisieren, die Folgeaufgabe schreiben — eine kurze Tool-Schleife mit Kostengrenze. Ein HTTP-Aufruf ist immer noch [Mit externem Service verbinden](https://docs.voicelogica.ai/de/workflow-nodes/api/). Eine Vervollständigung ist [KI-Antwortgenerierung](https://docs.voicelogica.ai/de/workflow-nodes/ai-generation/).

## Was Sie konfigurieren

- **Task** (required) — Was die Schleife abschließen muss. Vorgefüllt, damit eine neue Karte nicht leer ist.
- **Built-in tools / API tools / MCP** — Was sie aufrufen darf. Die Runtime erwartet mindestens ein Tool.
- **Models** — Primär (vorgefüllt). Optionale Eskalation beim selben Anbieter.
- **Limits** — Max. Iterationen (Standard 15, 0 = keine Iterationsgrenze) und max. Kosten (USD, max. 0,5). **Stuck detection** bricht ab, wenn dasselbe Tool+Args zweimal ausgelöst wird.
- **Knowledge** — Optionale Dateien + Rerank. Gleiche Idee wie beim Agent-Wissensanhang.

**Dry run** ist auf dem Knoten — verwenden Sie es während des Tests. Ports: **Task completed**, **Task failed**.

## Erste Einrichtung — nach Auflegen ein Ticket erstellen

1. Verbinden Sie das CRM unter [Integrations](https://docs.voicelogica.ai/de/integrations/), wenn die Schleife dort schreiben wird.

2. [On Call End](https://docs.voicelogica.ai/de/workflows/on-call-end/) → **Managed AI Agent**. Task: Ticket aus der Anrufzusammenfassung öffnen. Fügen Sie das HubSpot- (oder API-) Tool hinzu, das es benötigt.

     <ShotPlaceholder
       src="/assets/workflow-nodes/managed-agent-filled.png"
       name="managed-agent-filled"
       alt="Ausgefüllter verwalteter KI-Agent"
       capture="Workflow builder → Managed AI Agent selected. Task filled and at least one tool added. 1600×900. Redact numbers/emails/PINs."
     />

3. Lassen Sie Limits beim Seed. **Save & go live**, anhängen, einen Anruf auflegen. Überprüfen Sie das CRM — wenn nichts gelandet ist, wurde kein Tool hinzugefügt, HubSpot ist getrennt oder Dry run ist aktiviert.

## So sieht "fehlerhaft" aus

- **Needs setup** — leere Task.
- Schleife stoppt früh — Kosten-/Iterationsgrenze oder Stuck Detection.
- Stille während des Anrufs — dieser Knoten ist während des Anrufs aktiv.

## Fehlerbehebung

**Warum nicht einfach API + E-Mail verketten?**

Tun Sie das, wenn die Schritte festgelegt sind. Verwenden Sie diesen Knoten, wenn die *Menge* der Schreibvorgänge davon abhängt, was im Anruf passiert ist, und Sie eine begrenzte Schleife akzeptieren.

## Nächste Schritte

[On Call End](https://docs.voicelogica.ai/de/workflows/on-call-end/).  
[HubSpot-Knoten](https://docs.voicelogica.ai/de/workflow-nodes/hubspot/) — ein einzelner deterministischer Schreibvorgang.  
[KI-Antwortgenerierung](https://docs.voicelogica.ai/de/workflow-nodes/ai-generation/).