> 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/pia-actions-inlinetools.md).

# Pia Aktionen mit Inline-Tools nutzen

Mit den Pia Aktionen erweitern Sie die Textanweisungen (Prompts) Ihres KI-Agenten **Pia** um funktionale Schnittstellen zur PASCOM Telefonanlage und externen Diensten. Anstatt Aktionen nur rein textuell zu umschreiben, fügen Sie feste interaktive Bausteine direkt in den Prompt ein.

### Inline Tools im Prompt-Editor aufrufen

{% stepper %}
{% step %}

#### Pia-Agenten öffnen

Navigieren Sie im Admin Dashboard zu **Anrufverteilung** > **KI-Agenten**.
{% endstep %}

{% step %}

#### Bereich „Pia Prompt“ auswählen

Wählen Sie Ihren gewünschten Pia-Agenten aus und wechseln Sie in den Bereich **Pia Prompt**.
{% endstep %}

{% step %}

#### Aktion einfügen

Es gibt zwei Wege, um eine Aktion einzufügen:

* **Tastaturbefehl**: Tippen Sie im Textfeld an der gewünschten Stelle einfach ein Slash-Zeichen (`/`) ein. Es öffnet sich das Kontextmenü mit allen verfügbaren Inline Tools.
*

```
<figure><img src="/files/ZoPipl9qC9InH10Jfd6X" alt=""><figcaption></figcaption></figure>
```

* **Schaltfläche**: Klicken Sie oberhalb des Textfelds auf die Schaltfläche **Prompt-Aktion hinzufügen**.
*

```
<figure><img src="/files/LicpVbJcF6nYxWeLYeh1" alt=""><figcaption></figcaption></figure>
```

{% endstep %}
{% endstepper %}

### An Team weiterleiten

Mit dieser Aktion übergeben Sie das Gespräch von Pia nahtlos an eine interne Warteschlange bzw. ein Team.

* **Auswahl**: Wählen Sie `/team` und bestimmen Sie das gewünschte Zielteam, z. B. `/team Support` oder `/team Vertrieb`.
* **Funktionsweise**: Erkennt Pia im Gesprächsverlauf, dass das Anliegen des Anrufers zum definierten Team passt, beendet sie den KI-Dialog und stellt das Telefonat an das Team durch.

{% hint style="warning" %}
**Wichtig: Weiterleitung nur an Teams & Fallback definieren**

Pia leitet **ausschließlich an Teams** weiter, nicht an einzelne Benutzer. So wird sichergestellt, dass Anrufer nicht an besetzten oder abwesenden Nebenstellen hängenbleiben.

Formulieren Sie im Prompt immer eine klare **Fallback-Anweisung**, falls eine Weiterleitung fehlschlägt oder Pia den Anrufer nach mehrmaligem Nachfragen nicht versteht:

```markdown
Wenn du das Anliegen nach zweimaligem Nachfragen nicht eindeutig zuordnen kannst, 
informiere den Anrufer freundlich und leite ihn an /team Zentrale weiter.
```

{% endhint %}

### Labels setzen und auslesen

Labels dienen in PASCOM als strukturierte **Daten-Container**. Sie heften wichtige Informationen direkt an den Anruf, sodass Mitarbeiter in der PASCOM App sofort sehen, worum es geht.

Pia kann Labels auf zwei Arten nutzen:

#### Labels befüllen (Schreiben)

* **Reine Status-Information**: Pia ordnet den Anruf einer Kategorie zu, z. B. Label `Support` oder `Vertrieb`.
* **Mit Zusatzdaten anreichern**: Pia erfragt konkrete Details vom Anrufer und speichert den Textinhalt im Label ab, z. B. Label `Kundennummer: 10482` oder `Problem: PC startet nicht mehr`.

*Beispiel-Anweisung im Prompt:*

```markdown
Frage nach der Rechnungsnummer. Speichere die genannte Nummer im Label /Rechnungsnummer.
Fasse den Grund des Anrufs kurz zusammen und speichere ihn im Label /Anrufgrund.
```

#### Labels auslesen (Lesen)

Pia kann bereits vorhandene Labels aus dem bisherigen Anrufverlauf auswerten.

Wählt ein Anrufer beispielsweise in einem vorgeschalteten IVR-Auswahlmenü die Taste `1` für *Rezeptbestellungen*, wird dem Anruf automatisch das Label `Rezept` zugewiesen. Pia liest dieses Label beim Start des Dialogs aus und begrüßt den Patienten direkt themenspezifisch:

> *„Guten Tag! Ich sehe, Sie möchten ein Rezept bestellen. Für welches Medikament benötigen Sie das Rezept?“*

{% hint style="info" %}
**Labels müssen vorab angelegt sein:**

Pia kann beliebige Daten in Labels schreiben, legt aber keine neuen Label-Typen eigenständig an. Definieren Sie alle gewünschten Labels vorab unter **Anrufverteilung** > **Labels**.
{% endhint %}

### Anruferkontext nutzen

Über den Anruferkontext greift Pia in Echtzeit auf Stammdaten des Anrufers zu. Erkennt die PASCOM Telefonanlage die Rufnummer im zentralen Telefonbuch, stehen Pia sämtliche Kontaktdaten als Variablen zur Verfügung.

#### Verfügbare Kontext-Felder im Überblick

| Feld im Menü           | Quelle & Verhalten                                                                                                  | Einsatzzweck & Beispiel                                                                            |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Anrufernummer**      | Wird direkt vom PASCOM Amt mitgegeben. Ist **immer verfügbar**, selbst wenn der Anrufer nicht im Telefonbuch steht. | Zur Identifikation oder Dokumentation: *„Ich habe Ihre Rufnummer /Anrufernummer erfasst.“*         |
| **Anrufername**        | Stammt aus dem Telefonbuch. Enthält den vollständigen Namen.                                                        | Begrüßung bekannter Kunden: *„Guten Tag, Herr /Anrufername.“*                                      |
| **Vorname / Nachname** | Getrennte Namensfelder aus dem Telefonbuch.                                                                         | Für eine natürliche Anrede: *„Guten Tag Frau /Nachname.“*                                          |
| **Anzeigename**        | Der formatierte Kontaktname im PASCOM System.                                                                       | Übersichtliche Darstellung im Dialogprotokoll.                                                     |
| **Organisation**       | Name des Unternehmens bzw. des Mandanten aus dem Telefonbuch.                                                       | Personalisierte Ansprache von Geschäftskunden: *„Rufen Sie bezüglich der Firma /Organisation an?“* |
| **E-Mail**             | Im Telefonbuch hinterlegte E-Mail-Adresse.                                                                          | Abgleich für Rückmeldungen oder Bestätigungen: *„Sollen wir die Bestätigung an /E-Mail senden?“*   |
| **Notizen**            | Freitext-Bemerkungen zum Kontakt aus dem Telefonbuch.                                                               | Berücksichtigung von Kundenbesonderheiten.                                                         |
| **Eingehende Regel**   | Der Name der angerufenen Inbound-Rufregel in PASCOM, z. B. `Service-Hotline` oder `Zentrale-DE`.                    | Ermöglicht Pia zu erkennen, über welche Leitung der Anruf eingegangen ist.                         |

### Termin vereinbaren (Microsoft 365 Kalender)

Mit der Aktion `/Termin vereinbaren` bucht Pia eigenständig Termine direkt in einem hinterlegten Microsoft 365 Kalender. Pia gleicht freie Zeitslots in Echtzeit ab, schlägt dem Anrufer Optionen vor und trägt den gebuchten Termin verbindlich ein.

#### Voraussetzung

Vor der Nutzung muss ein Administrator unter **Einstellungen** > **Connector** einen **Microsoft 365 Kalender** Connector eingerichtet und per Microsoft 365 Konto authentifiziert haben. Dieser Connector wird automatisch für Pia bereitgestellt. *(Die Anleitung zur Einrichtung des Microsoft 365 Kalenders finden Sie hier.* [Kalender aus Microsoft 365](https://docs.pascom.net/integrations/connector/calendar-microsoft-365.md)*)*

#### Kalendereinstellungen konfigurieren

{% stepper %}
{% step %}

#### Kalenderelement einfügen

Fügen Sie über `/Termin vereinbaren` das Kalenderelement in Ihren Prompt ein.
{% endstep %}

{% step %}

#### Einstellungsdialog öffnen

Klicken Sie auf das eingefügte Element, um den Einstellungsdialog zu öffnen.

<figure><img src="https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2F2ncw87thvLeE7xFvU1dr%2FPia%20Kalender%20Nutzung.png?alt=media&amp;token=45fe33ae-9df7-458e-a155-213adc070cd0" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Kalenderkonfiguration für Pia im Überblick

<figure><img src="https://1983379169-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLe82Z891Z9TUVDeTD5WX%2Fuploads%2FC76giBw3Pqb84PPdGJLt%2FPia%20Kalender%20konfigurieren.png?alt=media&amp;token=aaaff249-0699-483e-a84b-c74e3603b427" alt=""><figcaption></figcaption></figure>

| Parameter                   | Beschreibung                                                                                                                                | Empfohlener Wert / Beispiel          |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| **Kalender**                | Auswahl des Microsoft 365 Zielkalenders, z. B. persönlicher Kalender oder geteilter Team-Kalender.                                          | `Support Kalender` oder `Dr. Müller` |
| **Termindauer**             | Feste Dauer des zu buchenden Terminslots.                                                                                                   | `30 Minuten`                         |
| **Pufferzeit**              | Pause zwischen zwei aufeinanderfolgenden Terminen, um Überschneidungen zu vermeiden.                                                        | `15 Minuten`                         |
| **Anzahl Terminvorschläge** | Wie viele freie Termine Pia dem Anrufer maximal gleichzeitig zur Auswahl nennt.                                                             | `3 Vorschläge`                       |
| **Mindestvorlaufzeit**      | Wie viele Stunden/Tage zwischen dem Anruf und dem frühestmöglichen Termin liegen müssen, um unvorbereitete Spontanbuchungen zu verhindern.  | `2 Stunden` oder `24 Stunden`        |
| **Max. Buchungshorizont**   | Wie weit in die Zukunft Termine vergeben werden dürfen.                                                                                     | `14 Tage`                            |
| **Verfügbarkeitszeiten**    | Zeitfenster, in denen Buchungen grundsätzlich zulässig sind, z. B. nur während der Öffnungszeiten.                                          | `Geschäftszeiten`                    |
| **Abwesenheitskalender**    | Bestimmt, welcher Unterkalender auf Urlaub, Feiertage oder Schließzeiten geprüft wird, damit an diesen Tagen keine Termine vergeben werden. | `Urlaub / Abwesenheit`               |

{% hint style="info" %}
**Unterkalender als Abwesenheitskalender nutzen:**

In Microsoft 365 können Sie neben dem Hauptkalender separate Unterkalender führen, z. B. *Arbeit*, *Urlaub* oder *Fortbildung*. Über das Feld **Abwesenheitskalender** wählen Sie gezielt den Kalender aus, der blockierte Tage definiert. Pia schlägt an Tagen mit eingetragenen Abwesenheiten keine Termine vor.
{% endhint %}

### Praxisbeispiel: Vollständiger Prompt mit Inline Tools

Hier sehen Sie, wie die verschiedenen Inline Tools in einem echten Praxis-Prompt zusammenwirken:

{% code title="pia-praxis-prompt.md" overflow="wrap" %}

```markdown
# Rolle und Begrüßung
Du bist Pia, die digitale Assistentin der Muster GmbH.
Wenn der Anrufer bekannt ist, begrüße ihn mit: 
"Guten Tag Herr/Frau /anruferkontext:Anzeigename. Wie kann ich Ihnen helfen?"
Ist der Anrufer unbekannt, verwende:
"Guten Tag, Sie sprechen mit Pia von der Muster GmbH. Wie kann ich Ihnen helfen?"

# Anliegen qualifizieren
- Bei technischen Problemen: Erfrage das genaue Fehlerbild, speichere es im Label /label:Fehlerbeschreibung und leite den Anrufer an /team:Support weiter.
- Bei Interesse an einer Beratung: Schlage dem Anrufer freie Beratungstermine vor über /Termin vereinbaren.
- Bei Fragen zu Rechnungen: Frage nach der Rechnungsnummer, speichere sie im Label /label:Rechnungsnummer und leite an /team:Buchhaltung weiter.

# Fallback
Verstehst du den Anrufer nach zweimaligem Nachfragen nicht oder wünscht er ausdrücklich einen Mitarbeiter, sage:
"Ich verbinde Sie direkt mit unserer Zentrale." und leite an /team:Zentrale weiter.
```

{% endcode %}


---

# 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/pia-actions-inlinetools.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.
