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

# Wissen & Tools: PDFs, Webseiten, Websuche und Übertragen

> Gib deinem Agenten PDFs und Webseiten als Hintergrundwissen, schalte die Websuche ein und übertrage einen Agenten an ein anderes Avaluma-Konto.

Was dein Agent über seine Anweisungen hinaus weiß, legst du im Agent-Editor im
Abschnitt **Hintergrundwissen** fest: hochgeladene PDFs, importierte Webseiten
und die Websuche. Der Editor speichert alles automatisch. Es wirkt ab dem
nächsten Gespräch.

## Dokumente als Wissen (PDF)

Unter **Dokumente (PDF)** lädst du PDFs hoch, deren Text der Agent als
Hintergrundwissen nutzt. Der Volltext aller Dateien wird ans Ende des
System-Prompts angehängt. Der Agent beantwortet Sachfragen auf dieser
Grundlage und behandelt die Inhalte wie eigenes Wissen. Er erwähnt nicht, dass
ihm Dokumente vorliegen, und nennt keine Dateinamen.

**1. Agent benennen**

Hochladen geht erst, wenn es den Agenten gibt. Einem neuen Agenten gibst du
also zuerst einen Namen.

**2. PDFs hochladen**

Lege die PDFs im Abschnitt **Hintergrundwissen** im Feld ab oder klicke
darauf. Du kannst mehrere Dateien auf einmal wählen.

Hochgeladene PDFs und importierte Webseiten stehen gemeinsam in der Liste
**Wissen des Agenten**. Mit **Prompt-Text anzeigen** siehst du den Text, den
der Agent aus einem Eintrag bekommt.

| Regel | Wert |
| - | - |
| **Dateityp** | Nur PDF mit auslesbarem Text. PDFs ohne Textebene, etwa reine Scans, werden abgelehnt. |
| **Dateigröße** | Höchstens 10 MB je Datei. |
| **Gesamtumfang** | Höchstens 100.000 Tokens über alle PDFs und importierten Webseiten zusammen. Jeder Eintrag zeigt seine Tokens, ein Balken den Füllstand. Ein Upload, der das Limit überschreiten würde, wird abgelehnt. |
| **Gleicher Dateiname** | Ersetzt die vorhandene Datei. |
| **Entfernen** | Über das Papierkorb-Symbol neben der Datei. |

> [!NOTE]
>
> Läuft dein Agent auf einem OpenAI-Realtime-Modell, sind Upload und Import
> gesperrt. Diese Modelle nehmen keine Dokumente in den System-Prompt auf.

Beim [Duplizieren](https://docs.avaluma.ai/de/agents/overview.md#agenten-verwalten) eines Agenten werden
die hochgeladenen PDFs mitkopiert.

## Webseite als Wissen importieren

Unter **Webseite als Wissen importieren** liest der Editor den Text einer
Website aus und hängt ihn wie ein PDF als Volltext an den System-Prompt an.

**1. Adresse eingeben**

Trage die Adresse der Website ein, zum Beispiel `beispiel.de`. `https://`
kannst du weglassen.

**2. Umfang festlegen**

Mit **Maximale Unterseiten** legst du fest, wie viele Seiten der Import
höchstens lädt (bis zu 10). Im Feld für den Schwerpunkt nennst du
Begriffe wie `referenzen, projekte`: Seiten, deren Adresse einen davon
enthält, werden zuerst geholt.

**3. Importieren**

Klicke auf **Importieren**. Ein Import kann einige Minuten dauern. Danach
steht die Website in der Liste **Wissen des Agenten**.

| Regel | Wert |
| - | - |
| **Bereinigung** | Mit **Inhalt per KI bereinigen** (Standard: an) entfernt der Import Navigation und Wiederholungen. Fakten bleiben wörtlich erhalten. |
| **Rechtstexte** | Seiten wie Datenschutz und AGB lässt der Import weg, das Impressum nicht. |
| **Gleiche Adresse** | Ein erneuter Import ersetzt den vorhandenen Eintrag. |
| **Gleichzeitig** | Es läuft immer nur ein Import auf einmal. |
| **Kontrolle** | **Prompt-Text anzeigen** zeigt den Text, den der Agent bekommt, **Rohextrakt anzeigen** den Text vor der Bereinigung. |

> [!NOTE]
>
> Der Import liest nur Text, der im HTML der Seite steht. Seiten, die ihren
> Inhalt erst per JavaScript laden oder den Abruf abweisen, liefern keinen
> Text.

## Websuche

Mit der Websuche kann der Agent während des Gesprächs im Internet nach aktuellen
Informationen suchen, etwa nach Öffnungszeiten, Nachrichten oder Preisen, die
nicht in seinem Hintergrundwissen stehen. Du schaltest sie im Abschnitt
**Hintergrundwissen** unter **Websuche** mit dem Haken **Websuche** ein.
Standardmäßig ist sie aus.

Die Websuche funktioniert mit allen Sprachmodellen außer OpenAI Realtime. Beim
Standardmodell `gemma-4-31b-it` und bei Cerebras übernimmt im Hintergrund
GPT-5.4 mini die Suche; eine Suche dauert dann einige Sekunden, bevor der Agent
antwortet.

## Agent übertragen

Du kannst einen Agenten an ein anderes Avaluma-Konto übergeben, etwa wenn du
ihn für einen Kunden eingerichtet hast.

**1. Menü öffnen**

Öffne in der Übersicht **Agenten** das Menü (drei Punkte) des Agenten und
wähle **Übertragen...**.

**2. Empfänger angeben**

Gib die E-Mail-Adresse ein, mit der sich der Empfänger bei Avaluma anmeldet,
und klicke auf **Übertragen**.

Danach gehört der Agent dem Empfänger, und er verschwindet aus deiner Liste.
Agent-ID, Konfiguration und hochgeladene PDFs bleiben unverändert. Links,
Einbettungen und Kiosk-URLs funktionieren deshalb weiter. Zurückholen kann den
Agenten nur der neue Eigentümer, indem er ihn an dich zurücküberträgt.

Die Übertragung wird abgelehnt, wenn

* es kein Avaluma-Konto mit dieser E-Mail-Adresse gibt,
* du die eigene Adresse angibst oder
* der Empfänger das Agent-Limit seines Plans schon erreicht hat (siehe
  [Preise & Abrechnung](https://docs.avaluma.ai/de/billing/plans.md)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.