> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/setup/acd/ai-agents-pia-setup.md). # KI-Agent Pia einrichten Diese Anleitung beschreibt, wie Sie den interaktiven KI-Agenten Pia in Ihrer PASCOM Telefonanlage einrichten und konfigurieren. Mit dem KI-Agenten **Pia** stellt PASCOM einen interaktiven Sprachassistenten zur Verfügung. Pia kann eingehende Telefonate annehmen, das Anliegen des Anrufers analysieren, benötigte Informationen abfragen und den Anrufer gezielt an das richtige Team weiterleiten. Die Steuerung und das Verhalten des Agenten konfigurieren Sie flexibel über Prompts (Textanweisungen). {% hint style="info" %} **Kostenlose Testphase bis Ende September 2026:** Während der Testphase entstehen für die Nutzung von Pia keinerlei Kosten. Zur Vorbereitung auf den späteren Live-Betrieb zeigt die Benutzeroberfläche bereits Hinweise auf die zukünftige minutenbasierte Abrechnung an. {% endhint %} {% embed url="" %} ## KI-Agent Pia erstellen Sie finden die Verwaltung der KI-Agenten im PASCOM Admin-Dashboard. 1. Navigieren Sie im Menü zu **Anrufverteilung** > **KI-Agenten**. 2. Klicken Sie auf **Hinzufügen**. 3. Wählen Sie den Typ **Pia** aus. ![Pia erstellen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-f0461faaba68d13cfddef778d4bf98ac4a77f305%2Fpia-create.de.png?alt=media) ## Konfiguration der Basisdaten Legen Sie im Bereich **Pia Basisdaten** die grundlegenden Eigenschaften des Agenten fest: * **Bezeichnung**: Vergeben Sie einen eindeutigen Namen für den Agenten (z. B. `Zentrale` oder `Support-Vorqualifizierung`). * **Avatar**: Klicken Sie auf **Avatar ändern**, um dem KI-Agenten ein visuelles Profilbild zuzuweisen. ## Pia Prompt konfigurieren Im Textfeld **Pia Prompt** hinterlegen Sie die Arbeitsanweisungen für den KI-Agenten. Diese Anweisungen bestimmen, wie Pia den Anrufer begrüßt und wie die Gesprächsführung abläuft. Bei jedem neu erstellten Pia-Agenten ist bereits die folgende Standard-Vorlage aktiv: ```markdown # Begrüßung Begrüße den Anrufer freundlich und stelle dich als KI-Assistent vor. Beispiel: "Hallo, Sie sprechen mit Pia, dem automatisierten KI-Assistenten der Firma [Firmenname]. Wie kann ich Ihnen helfen?" # Weiterleitung Ermittle das Anliegen des Anrufers und leite an das passende Team weiter: - Technische Probleme oder Störungen → Team Support - Fragen zu Rechnungen oder Verträgen → Team Verwaltung - Interesse an Produkten oder Preise → Team Vertrieb - Alles andere → Team Zentrale ``` ![Pia Basisdaten](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-02568d3b1e3228054404259d489a1892f337b18f%2Fpia-basedata.de.png?alt=media) ### Inline-Tools und Labels nutzen Sie müssen Weiterleitungen und Abfragen nicht rein textuell beschreiben, sondern können die integrierten Inline-Tools nutzen. Die Inline-Tools öffnen sich indem sie im Prompt-Editor ein Slash-Zeichen (`/`) eingeben. Danach kann man aus den verfügbaren Befehlen auswählen. * **Weiterleitung an Teams**: Wählen Sie `/team` aus und bestimmen Sie das Zielteam (z. B. `/team Support`), um den Anrufer direkt dorthin weiterzuleiten. * **Kundeninformationen erfassen**: Sie können Pia anweisen, wichtige Daten abzufragen und in Labels zu speichern. Beispielsweise: *"Frage nach der Kundennummer und speichere diese im Label Kundennummer."* Das Label muss vorher schon angelegt sein. Wie das funktioniert erfahren Sie in der Anleitung [Labels einrichten](/setup/acd/labels.md). ![Pia Inline Tools](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-1d1b4526c13900886601a1c55ec57f0caa6aa97c%2Fpia-inlinetools.png?alt=media) Alle während des Gesprächs durch Pia gesetzten Labels werden dem Mitarbeiter in der PASCOM App angezeigt. Der Kunde muss seine Daten somit nicht erneut nennen. ## Modell- und Stimmeinstellungen Unter **Modell / Stimme (Provider)** legen Sie fest, welche Sprachlogik und Stimme verwendet werden soll. ### DSGVO und Hosting Aus Datenschutz- und Zertifizierungsgründen (ISO, DSGVO) werden alle Modelle in europäischen Rechenzentren (Microsoft Azure EU) gehostet. Ihre Daten bleiben somit vollständig innerhalb der EU geschützt. ### Modellauswahl (GPT Realtime) Es stehen Ihnen verschiedene Realtime-Modelle zur Verfügung: * **Mini**: Dieses Modell ist für einfache Aufgaben wie das klassische Call-Routing oder standardmäßige IVR-Abläufe vollkommen ausreichend und arbeitet besonders schnell. * **1.5** und **2.0**: Diese größeren Modelle eignen sich für hochgradig komplexe Prompts, verschachtelte Gesprächslogiken und die präzise Extraktion variabler Kundendaten. ### Sprechgeschwindigkeit & Unterbrechbarkeit * **Sprechgeschwindigkeit**: Über den stufenlosen Schieberegler stellen Sie das Sprechtempo der KI-Stimme ein (Standardwert ist `1.0`). * **Unterbrechbarkeit**: Aktivieren Sie den Schalter **Kann der KI-Agent vom Anrufer unterbrochen werden?**, wenn der Anrufer Pia sofort ins Wort fallen darf. Ist dieser deaktiviert, spricht Pia den aktuellen Prompt-Abschnitt immer vollständig zu Ende, bevor auf die Antwort des Anrufers reagiert wird. ![Pia Einstellungen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-b07a7505621c1d37d6ff82c3c65df205b4672ca8%2Fpia-gptmodel.de.png?alt=media) ## Anrufergebnis-Labels einrichten Über die Option **Label zur Speicherung des Anrufergebnisses** können Sie ein Label auswählen, in welchem der Status oder das Ergebnis des KI-Telefonats dokumentiert wird. Dies ermöglicht eine genaue Nachverfolgung der Anrufe im nachgelagerten Routing. Folgende Ergebniswerte und deren Auslöser (**Trigger**) werden vom System gesetzt: | Anrufergebnis-Wert | Auslöser (Trigger) | | --------------------------------------------------- | --------------------------------------------------------------------------------------------- | | **Anrufer wurde an ein internes Ziel transferiert** | Die KI hat den Anrufer erfolgreich an ein definiertes Team oder einen Benutzer durchgestellt. | | **Anrufer hat während der Konversation aufgelegt** | Der Anrufer hat die Verbindung vorzeitig beendet. | | **Gesamt- oder Agenten CU Limit überschritten** | Das Limit für gleichzeitige Gespräche (CUs) wurde erreicht. | | **Tägliches Limit erreicht** | Das tägliche Budgetlimit wurde erreicht. | | **Interner Fehler** | Es trat ein technisches Problem auf (z. B. Netzwerkfehler, Server nicht verfügbar). | Diese Labels werden dann an den Anruf mit angehängt und sind für Benutzer in der PASCOM App sichtbar. Somit kann der Mitarbeiter sofort erkennen, wie und ob Pia den Anrufer bearbeiten konnte. ## Limits und Budgetkontrolle * **Gleichzeitige Gespräche begrenzen**: Aktivieren Sie diesen Schalter, um die maximalen parallelen Leitungen (CUs) für diesen Agenten zu limitieren (z. B. auf maximal 3 Kanäle). Ist der Schalter deaktiviert, nutzt der Agent alle im Paket verfügbaren CUs. Dies schützt Sie vor unerwartet hohen Kosten im späteren Live-Betrieb. ![Pia Einstellungen](https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2Fgit-blob-4b55ea8536824c6e12a7c29c178018e5a65add33%2Fpia-settings.de.png?alt=media) ## Integration im Anrufverteiler (Best Practices) Bauen Sie Pia sinnvoll in Ihre Anrufverteilung ein: 1. **Feste Regeln voranstellen**: Fangen Sie eindeutige Kriterien (wie Feiertage, Geschäftszeiten oder Betriebsruhe) vorab über das klassische Aktionsmodell im Anrufverteiler ab. Lassen Sie Anrufe nicht an Pia durchstellen, wenn Ihr Büro geschlossen ist. 2. **Fallback einrichten**: Da Pia bei Erreichen von CU-Grenzen, Budget-Limits oder bei Netzwerkstörungen Gespräche eventuell nicht annehmen kann, müssen Sie am Ende des Anrufverteilers **immer** eine Fallback-Aktion definieren (z. B. Weiterleitung an das reguläre Office oder die Zentrale). So ist sichergestellt, dass kein Anrufer in einer Sackgasse landet. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.pascom.net/setup/acd/ai-agents-pia-setup.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.