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

{% embed url="<https://www.loom.com/share/acbf74d7a87a44b49da4d9f70884de2f>" %}

{% hint style="info" %}
Durch die Nutzung von Pia entstehen zusätzliche Kosten, welche nicht in der Standardlizenz enthalten sind. Informationen und eine Übersicht über die verfügbaren Pakete und Tarife finden Sie in unserer aktuellen Preisliste. [PASCOM Preise](https://www.pascom.net/preise/)
{% endhint %}

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

Eine detaillierte Anleitung zu den Inline-Tools für Pia finden Sie hier: [Pia Aktionen mit Inline-Tools nutzen](https://docs.pascom.net/setup/acd/ai-agents-pia-setup/pia-actions-inlinetools.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)

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

Pia spricht jede gewünschte Sprache. Sie kann per Prompt fest auf eine Sprache eingestellt werden (z. B. Englisch) oder dynamisch während des Telefonats die Sprache wechseln (z. B. wenn der Anrufer auf Englisch antwortet). Daher ist es nicht notwendig, Sprachmodelle in verschiedenen Sprachen zu nutzen.

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. Der Schalter Gleichzeitige Gespräche begrenzen dient als administrativer Schutz vor unerwarteten Kosten bzw. Lastspitzen (z. B. Montagfrüh-Ansturm in Arztpraxen)

![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:

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

{% hint style="warning" %}
**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. Im Bestenfall, berücksichtigen Sie schon beim Prompting der Pia-Anweisungen darauf, dass gewissen Fallback Aktionen durchgeführt werden. (Beispiel: Weiterleitung and Sales Team oder Support Team nicht möglich, dann tue XY)
{% endhint %}


---

# 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 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=<question>&goal=<user_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 `automate deployments from our CI pipeline` 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.
