> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mit Variablen arbeiten

> Personalisiere jeden Anruf mit Kontaktdaten, Datumsangaben und Details, die sich von Kontakt zu Kontakt unterscheiden

Variablen sind Platzhalter im Prompt deines Agenten, die während eines Anrufs mit echten Werten gefüllt werden. Damit kann dein Agent den richtigen Kontext nutzen, etwa den Vornamen des Kontakts, das aktuelle Datum oder ein eigenes Feld, ohne dass du für jeden Anruf einen anderen Prompt schreiben musst.

Jede [Kontakteigenschaft](/de/platform/contact-properties), die du in telli anlegst, erscheint hier automatisch als Variable, die du im Prompt verwenden kannst.

## Arten von Variablen

telli gruppiert Variablen in drei Kategorien. Du findest sie alle im **Variablen-Panel** in der Seitenleiste des Agent Builders.

| Kategorie                | Was sie enthält                                                                                                      | Beispiel                                             |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| **Kontakteigenschaften** | Informationen zum angerufenen Kontakt, inklusive eingebauter Felder und aller eigenen Eigenschaften, die du anlegst. | *Der Vorname der angerufenen Person*                 |
| **Agent-Variablen**      | Platzhalter, die im Agenten selbst für Werte definiert sind, die nur für diesen Use Case gelten.                     | *Ein Kampagnenname, der am Agenten konfiguriert ist* |
| **System-Variablen**     | Werte, die telli automatisch bereitstellt, etwa das aktuelle Datum oder die Uhrzeit.                                 | *Das heutige Datum zum Zeitpunkt des Anrufs*         |

## Variablen erstellen und nutzen

<Tabs>
  <Tab title="Eigene Kontakteigenschaft erstellen">
    Wenn die eingebauten Kontaktfelder nicht abdecken, was du brauchst, kannst du eigene Kontakteigenschaften anlegen und wie jede andere Variable nutzen.

    <Steps>
      <Step title="Neue Kontakteigenschaft in den Einstellungen anlegen">
        Geh zu **Kontakten → Kontakteigenschaften** und lege eine neue Eigenschaft an. Gib ihr einen klaren Namen und wähle den richtigen Typ (Text, Zahl, Ja/Nein, Datum usw.).

        <video loop muted playsinline style={{ width: '100%', cursor: 'pointer' }} onMouseEnter={(e) => e.currentTarget.play()} onMouseLeave={(e) => { e.currentTarget.pause(); e.currentTarget.currentTime = 0; }}>
          <source src="https://mintcdn.com/telli/oSe6yooA3Hku5xB9/onboarding-media/working_with_variables/Variables_03_CreateCustomVar.mp4?fit=max&auto=format&n=oSe6yooA3Hku5xB9&q=85&s=ed534701ec90f283e1a369c9836db0a1" type="video/mp4" data-path="onboarding-media/working_with_variables/Variables_03_CreateCustomVar.mp4" />
        </video>
      </Step>

      <Step title="Die neue Eigenschaft im Prompt verwenden">
        Zurück im Agent Builder öffnest du das Variablen-Panel und findest deine neue Eigenschaft unter **Kontakteigenschaften**. Füge sie an der gewünschten Stelle in den Prompt ein.

        <video loop muted playsinline style={{ width: '100%', cursor: 'pointer' }} onMouseEnter={(e) => e.currentTarget.play()} onMouseLeave={(e) => { e.currentTarget.pause(); e.currentTarget.currentTime = 0; }}>
          <source src="https://mintcdn.com/telli/oSe6yooA3Hku5xB9/onboarding-media/working_with_variables/Variables_04_InsertCustom.mp4?fit=max&auto=format&n=oSe6yooA3Hku5xB9&q=85&s=92a1111aec79786d08169bb56f0f8de5" type="video/mp4" data-path="onboarding-media/working_with_variables/Variables_04_InsertCustom.mp4" />
        </video>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Variable in den Prompt einfügen">
    <Steps>
      <Step title="Variablen-Panel öffnen">
        Wechsle im Agent Builder zum Tab **Variablen** in der rechten Seitenleiste. Dort siehst du alle Variablen, die deinem Agenten zur Verfügung stehen, nach Kategorie gruppiert.

        <Note>
          Die Kontakteigenschaften, die du gerade angelegt hast, kannst du jetzt als Variablen in deinem Prompt nutzen.
        </Note>

        <video loop muted playsinline style={{ width: '100%', cursor: 'pointer' }} onMouseEnter={(e) => e.currentTarget.play()} onMouseLeave={(e) => { e.currentTarget.pause(); e.currentTarget.currentTime = 0; }}>
          <source src="https://mintcdn.com/telli/oSe6yooA3Hku5xB9/onboarding-media/working_with_variables/Variables_01_Menu.mp4?fit=max&auto=format&n=oSe6yooA3Hku5xB9&q=85&s=790f9b81a8f5f520236af371bd9e4a15" type="video/mp4" data-path="onboarding-media/working_with_variables/Variables_01_Menu.mp4" />
        </video>
      </Step>

      <Step title="Variable an der richtigen Stelle einfügen">
        Setze den Cursor im Prompt an die Stelle, an der der Wert erscheinen soll, und klicke dann auf eine Variable im Panel. Sie wird als deutlich markierter Chip eingefügt, damit du sie leicht erkennst. Ein grüner Punkt neben der Variable im Variablen-Panel bedeutet, dass sie irgendwo im Prompt eingebaut ist.

        <Note>
          Füge eine Variable ein, indem du sie im **Variablen-Panel** auswählst, oder tippe `{{` im Prompt und wähle die Variable aus dem Dropdown aus.
        </Note>

        <video loop muted playsinline style={{ width: '100%', cursor: 'pointer' }} onMouseEnter={(e) => e.currentTarget.play()} onMouseLeave={(e) => { e.currentTarget.pause(); e.currentTarget.currentTime = 0; }}>
          <source src="https://mintcdn.com/telli/oSe6yooA3Hku5xB9/onboarding-media/working_with_variables/Variables_02_InsertVar.mp4?fit=max&auto=format&n=oSe6yooA3Hku5xB9&q=85&s=3d0d55a6f630768f6712e171b0029eee" type="video/mp4" data-path="onboarding-media/working_with_variables/Variables_02_InsertVar.mp4" />
        </video>
      </Step>

      <Step title="Alternativ: Variable direkt über Charlie einfügen">
        Bitte [Charlie](/de/erste-schritte/agenten-editor-charlie), die Variable für dich einzufügen. Beschreibe in natürlicher Sprache, wo sie auftauchen soll, und Charlie fügt sie in den Prompt ein.

        <video loop muted playsinline style={{ width: '100%', cursor: 'pointer' }} onMouseEnter={(e) => e.currentTarget.play()} onMouseLeave={(e) => { e.currentTarget.pause(); e.currentTarget.currentTime = 0; }}>
          <source src="https://mintcdn.com/telli/oSe6yooA3Hku5xB9/onboarding-media/working_with_variables/Variables_05_InsertWithCharlie.mp4?fit=max&auto=format&n=oSe6yooA3Hku5xB9&q=85&s=25dce49a5609e636f33359633a2de7c5" type="video/mp4" data-path="onboarding-media/working_with_variables/Variables_05_InsertWithCharlie.mp4" />
        </video>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Tipps

* Nutze klare, beschreibende Namen für eigene Kontakteigenschaften, damit du sie später leicht wiederfindest.
* Teste mit einem echten Kontakt, um sicherzugehen, dass die Werte wie erwartet eingesetzt werden.
* Du kannst Kontakteigenschaften per CSV-Upload in großen Mengen importieren.
* Schau dir unser Cookbook zu **Variablen** an

<Card title="Variablen" icon="brackets-curly" href="/de/cookbooks/variables/overview">
  Lerne, wie du mit Variablen die Prompts deines Agenten dynamisch anpasst.
</Card>

## Nächste Schritte

<Card title="Agenten testen" icon="phone" href="/de/erste-schritte/agenten-testen">
  Mache einen Testanruf, um zu sehen, wie dein Agent die eingerichteten Variablen nutzt.
</Card>