> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/conversation-intelligence/custom-fields-verwalten.md).

# Custom Fields verwalten

Mit Custom Fields legen Sie fest, welche Inhalte die KI aus Ihren Gesprächen erhebt und im Data Hub speichert.

## Was sind Custom Fields?

Custom Fields sind Felder, die Sie als Admin zentral definieren. Nach jedem Gespräch wertet die KI das Transkript aus und extrahiert die Inhalte, die Sie in den Feldern beschrieben haben, zum Beispiel einen Anrufgrund, eine Kundennummer oder ein Thema. Die Ergebnisse speichert Conversation Intelligence strukturiert in einer eigenen Spalte im [Data Hub](broken://pages/7f9a04bc571e5a5289312cdbf5d285101c182321).

Findet die KI in einem Gespräch keinen passenden Wert, bleibt das Feld für diesen Anruf leer. Es werden keine Werte erfunden.

{% hint style="info" %}
Voraussetzung: Sie haben Admin-Rechte, und Conversation Intelligence ist für den Channel aktiviert (siehe [Erste Schritte](broken://pages/b6e5e1c1d43e2eaa392d3f1e252c1951b84cd93a)).
{% endhint %}

## Welche vordefinierten Felder gibt es?

Es gibt vordefinierte Custom Fields, die sofort erhoben werden, sobald Conversation Intelligence aktiviert ist. Dazu gehören unter anderem Vorname, Nachname, Anrede, Anrufgrund, Kundennummer, Referenznummer, E-Mail, Telefonnummer, Unternehmensname, Adresse, Termin Datum, Termin Uhrzeit, Topics und Zusammenfassung.

Vordefinierte Felder lassen sich nicht bearbeiten. Sie können sie aber über das Menü (drei Punkte) in der Zeile des Feldes deaktivieren, falls sie nicht zu Ihrem Use Case passen.

<figure><img src="https://571674400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcPbcWJCrFgi79rVOgXbo%2Fuploads%2FHjjXJQFMhjcpE5Sp33ya%2F03-custom-fields-vordefiniert.png?alt=media&amp;token=b5e8f6f4-8766-4c6f-9286-fd9b2a195076" alt=""><figcaption></figcaption></figure>

## Welche Ausgabeformate gibt es?

Je nachdem, welche Art von Information Sie aus einem Gespräch erheben möchten, wählen Sie eines der folgenden Ausgabeformate:

| Ausgabeformat | Beschreibung                                                                                                                  |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Text**      | Erfasst eine freie, textuelle Antwort, z. B. eine kurze Zusammenfassung oder ein wörtliches Zitat aus dem Gespräch.           |
| **Zahl**      | Erfasst einen numerischen Wert ohne angehängte Einheit, z. B. eine genannte Vertragslaufzeit oder einen Betrag.               |
| **Datum**     | Erfasst ein im Gespräch genanntes Datum, z. B. einen vereinbarten Rückruftermin.                                              |
| **Uhrzeit**   | Erfasst eine im Gespräch genannte Uhrzeit, z. B. den gewünschten Zeitpunkt für einen Rückruf.                                 |
| **Ja/Nein**   | Erfasst eine binäre Einschätzung, z. B. ob ein bestimmtes Anliegen im Gespräch vorkam oder nicht.                             |
| **Auswahl**   | Ordnet das Gespräch einer von vorgegebenen Optionen zu. Die möglichen Optionen legen Sie beim Anlegen des Feldes selbst fest. |

## Wie lege ich ein eigenes Custom Field an?

Neben den vordefinierten Feldern können Sie benutzerdefinierte Custom Fields anlegen, die Sie auf Ihren Use Case, Ihr Geschäftsmodell, Ihre Branche oder Ihr Team zuschneiden.

{% stepper %}
{% step %}

## Feld hinzufügen

Öffnen Sie **Conversation Intelligence → Custom Fields** und klicken Sie auf **Hinzufügen**.
{% endstep %}

{% step %}

## Feld benennen

Benennen Sie das Feld.
{% endstep %}

{% step %}

## Prompt beschreiben

Beschreiben Sie in einem Prompt, wie der Inhalt des Feldes erhoben werden soll.
{% endstep %}

{% step %}

## Ausgabeformat wählen

Wählen Sie das Ausgabeformat. Wenn Sie das Ausgabeformat **Auswahl** wählen, beschreiben Sie zusätzlich die möglichen Optionen.
{% endstep %}

{% step %}

## Feld speichern

Speichern Sie das Feld.
{% endstep %}
{% endstepper %}

Das Feld ist sofort aktiv und wird ab dem nächsten Anruf nach Ihrer Definition befüllt. Bereits geführte Anrufe werden nicht nachträglich ausgewertet. Liefert ein Anruf ein Ergebnis, wird der Wert in einer eigenen Spalte im Data Hub gespeichert.

**Beispiel**

* **Feldname:** Interesse
* **Feld-Prompt:** „Hat die Anruferin oder der Anrufer Interesse an einem bestimmten Feature gezeigt?"
* **Ausgabeformat:** Auswahl, mit den Optionen „Transkription", „Custom Fields", „Webhooks" und „Kein Interesse"

<figure><img src="https://571674400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcPbcWJCrFgi79rVOgXbo%2Fuploads%2FfbhBvaxXcMT9bb015Jow%2F05-custom-field-anlegen-ablauf.png?alt=media&amp;token=86010a37-f020-43a7-8fdc-00cfc20b0129" alt=""><figcaption></figcaption></figure>

## Wie formuliere ich einen guten Feld-Prompt?

Je genauer der Prompt, desto verlässlicher das Ergebnis:

* Nennen Sie das erwartete Format, z. B. „Gib die Kundennummer als reine Zahl aus."
* Geben Sie Beispielwerte an.
* Beschreiben Sie Grenzfälle, z. B. „Wenn keine Kundennummer genannt wird, gib nichts aus."
* Vermeiden Sie vage Formulierungen wie „Warum ruft der Kunde an?". Besser: „Nenne den Grund des Anrufs in maximal fünf Wörtern."

## In welcher Sprache werden Custom Fields ausgegeben?

Die Ergebnisse Ihrer Custom Fields werden in einer Sprache ausgegeben, die Sie in den Einstellungen festlegen. Öffnen Sie dazu **Conversation Intelligence → Einstellungen** und wählen Sie im Bereich **Ausgabesprache** bei **Sprache der Custom Fields** eine feste Sprache oder **Sprache des Transkripts übernehmen**. Bestehende Ergebnisse im Data Hub bleiben in der bisherigen Sprache erhalten.

## Wie bearbeite, deaktiviere oder lösche ich ein Feld?

* **Deaktivieren:** Über das Menü (drei Punkte) in der Zeile des Feldes. Das Feld wird dann nicht mehr erhoben. Deaktivierte Felder können Sie jederzeit wieder aktivieren.
* **Bearbeiten und Löschen:** Nur bei benutzerdefinierten Feldern möglich. Beim Löschen gehen die erhobenen Werte verloren.

## Was muss ich bei eigenen Custom Fields beachten?

{% hint style="warning" %}
Wenn Sie eigene Custom Fields definieren, sind Sie allein dafür verantwortlich, dass diese mit den geltenden rechtlichen Anforderungen vereinbar sind, insbesondere mit datenschutz- und arbeitsrechtlichen Vorgaben. Vermeiden Sie Felder, die Rückschlüsse auf die individuelle Leistung einzelner Mitarbeitender zulassen. Mehr dazu unter [Datenschutz](broken://pages/62f01c1b0cf2210fdb584d01aa603865917c8b43).
{% 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://help.sipgate.de/conversation-intelligence/custom-fields-verwalten.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.
