docs/context.de.md

Rama main · réplica de lectura del repositorio original.

---
source_sha: "6ed5be54f7ae"
---

# Context-Dateien { #context-files }

Eine **Context-Datei** ist ein Stück stehendes Wissen, einmal geschrieben und an
viele Agents gebunden: ein Glossar, eine Markenstimme, eine Eskalationsmatrix,
die Liste der Produkte, die Sie wirklich verkaufen.

Wenn Sie schon einmal eine `AGENTS.md` für einen Coding-Agent geschrieben haben:
Das ist dieselbe Idee in derselben Form — eine Markdown-Datei, die sagt, wie hier
gearbeitet wird, neben der Arbeit abgelegt statt in einem einzelnen Prompt. Der
Unterschied liegt darin, wer sie liest: Eine `AGENTS.md` im Repository liest,
welches Werkzeug sie auch immer öffnet; eine Context-Datei hier ist an die Agents
gebunden, die Sie auswählen, wird mit ihnen versioniert und ist von der Person
bearbeitbar, die die Antwort tatsächlich kennt.

Sie ist die Antwort auf ein Problem, das jedes Unternehmen bei seinem dritten
Agent trifft — dieselben drei Absätze, in drei Sätze von Instruktionen kopiert
und dann in einem davon bearbeitet.

Im Agent Builder erstellt **Context → New context file** eine Datei direkt im Fähigkeitspanel, ordnet sie dem aktuellen Entwurf zu und aktiviert Context. Anschließend lässt sich festlegen, wie dieser Agent die Datei nutzt. Das Veröffentlichen bleibt ein eigener Schritt. Zum Erstellen sind Bearbeitungsrechte für den Agenten und Kontextdateien erforderlich.

## Wo sie zwischen Skills und Wissen sitzt { #where-it-sits-between-skills-and-knowledge }

Drei Dinge legen einem Modell Text vor, und die falsche Wahl ist die übliche
Ursache für einen Agent, der entweder ignoriert, was man ihm gesagt hat, oder
überhaupt nichts liest.

|                                              | Sie hält                                                                                | Das Modell sieht es                                                  |
| -------------------------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Context-Datei**                            | Stehende Fakten, klein und stabil — ein Glossar, ein Tonfall-Leitfaden, ein Organigramm | Immer oder auf Anforderung — Sie entscheiden                         |
| **[Skill](skills.md)**                       | Ein Vorgehen für eine Art von Aufgabe — wie eine Rückerstattungsanfrage behandelt wird  | Wenn das Modell entscheidet, dass genau diese Aufgabe gerade ansteht |
| **[Wissens-Collection](file-processing.md)** | Ein Korpus, der zu groß zum Lesen ist — jedes Richtliniendokument, jedes Ticket         | Nur die Chunks, die eine Suche zurückgibt                            |

Die Faustregel: **Wenn es kurz und immer relevant ist, ist es eine Context-Datei.
Wenn es lang ist, ist es Wissen. Wenn es ein Vorgehen ist, ist es ein Skill.**

Die Seite **Context** zeigt auf jeder Karte den Anfang der Datei. `GET
/api/v1/context` liefert ihn als `excerpt`: ein paar begrenzte Zeilen, nie den
ganzen Inhalt.

## Zwei Modi, und der Unterschied sind die Kosten { #two-modes-and-the-difference-is-cost }

Jede angehängte Context-Datei hat einen Modus in den **Context**-Einstellungen des Agents. Dieselbe gemeinsame Datei kann bei einem Agent injiziert, bei einem anderen verlinkt und bei einem dritten deaktiviert sein.

=== "`inject` — immer da"

    Der Text wird wortwörtlich in die Instruktionen des Agents eingefügt. Das
    Modell kennt ihn immer, ohne sich zum Nachschauen zu entscheiden und ohne
    einen Tool-Aufruf.

    Nehmen Sie das für Dinge, die der Agent nie falsch machen darf: wie Ihre
    Produkte heißen, an wen eskaliert wird, wie das Unternehmen zu nennen ist.

    **Er wird bei jedem einzelnen Zug gelesen**, gehört also zu den Kosten jeder
    Nachricht. Halten Sie injizierte Dateien kurz.

=== "`link` — auf Anforderung gelesen"

    Der Text bleibt aus dem Prompt heraus und wird über ein Tool angeboten. Das
    Modell liest ihn nur, wenn es die Datei für relevant hält, und wählt dafür
    anhand des Namens und einer einzeiligen Beschreibung, die Sie schreiben.

    Nehmen Sie das für Nachschlagewerke, die manchmal zählen: eine selten
    gebrauchte Richtlinie, eine regionale Abweichung, eine lange Liste.

    Kostet nichts bei Zügen, die sie nicht brauchen, und gar nichts, wenn das
    Modell nie hineinsieht — was zugleich das Risiko ist.

!!! tip "Schreiben Sie die Beschreibung für ein Modell, nicht für einen Menschen"

    Eine verlinkte Datei wird allein anhand ihres Namens und ihrer Beschreibung
    gewählt. "Rückgaberichtlinie" sagt einem Modell weniger als "wann ein Kunde
    einen Artikel zurückgeben darf, die Fristen und die drei Ausnahmen" — und der
    Unterschied entscheidet, ob die Datei je geöffnet wird.

## Sie an einen Agent binden { #attaching-them-to-an-agent }

Context-Dateien gehören einer Organisation, nicht einem Agent. Sie schreiben eine,
und beliebig viele Agents binden sich daran.

Schalten Sie am Agent die Capability **Context** ein und binden Sie dann die
Dateien, die er haben soll. Die Datei danach zu bearbeiten ändert, was jeder
gebundene Agent **bei seinem nächsten Run** weiß — ohne Neuveröffentlichung, bei
keinem davon.

Das ist der ganze Sinn und zugleich das, womit man vorsichtig sein muss: Eine
Änderung an einer injizierten Datei ist eine Änderung an jedem Agent, der sie
trägt. Behandeln Sie sie als den gemeinsamen, tragenden Text, der sie ist.

Im Builder hat jede ausgewählte Datei einen Schalter **In diesem Agent verwenden** und eine Modusauswahl. Diese Einstellungen gehören zum Agent-Entwurf und gelten nach der Veröffentlichung. Der Bibliothekseditor ändert nur gemeinsamen Inhalt und Beschreibung; das Format folgt dem Dateinamen. Bestehende Agent-Versionen ohne individuelle Einstellungen behalten ihren bisherigen Modus und ihre Verfügbarkeit.

Die Capability steuert außerdem das Lese-Tool. Das Lese-Tool
**abzuschalten** heißt, dass nur injizierte Dateien das Modell erreichen und
nichts auf Anforderung gelesen wird — eine vernünftige Wahl, wenn Sie die Eingaben
eines Agents vollständig vorhersehbar haben wollen.

Man kann auch bei der Datei anfangen: **Zu einem Agenten hinzufügen** auf ihrer
Karte fügt sie dem Entwurf des Agenten hinzu, mit eingeschalteter
Kontext-Capability, und die Karte sagt, welche Agents sie schon tragen. Eine
Wissensdatenbank hat dieselbe Aktion auf ihrer eigenen Seite.

## Änderungen, die der Assistent vorschlägt { #changes-the-assistant-proposes }

**Mit dem Assistenten verbessern** im Editor einer Datei bittet den
[Authoring-Assistenten](authoring.md#context-files) um einen besseren Inhalt,
geschrieben aus den Runs der Agents, die die Datei lesen. Was er vorschlägt,
wird nicht angewendet: Es wartet über der Liste auf der Context-Seite, mit
Begründung, den Runs, auf denen es beruht, und den Agents, an die die Datei
gebunden ist.

Es anzuwenden ist dasselbe, wie die Datei von Hand zu bearbeiten - sofort
wirksam für jeden Agent, dessen veröffentlichte Version die Datei liest -,
deshalb kommt **Mit Evals prüfen** zuerst, an einem dieser Agents. Neben
**Anwenden** sagt die Änderung, was das Anwenden bewirkt: jeder Agent und jede
Umgebung, für die sie wirksam wird, die Eval-Suites, die es in die Warteschlange
stellt, und die Wächter, die sie erst bei der nächsten Promotion des Agents
prüfen. Eine Datei, die jemand nach dem Vorschlag bearbeitet hat, lehnt die
Änderung ab; die Bearbeitung wird nie überschrieben.

Den Assistenten erneut zu fragen schreibt die wartende Änderung um, statt eine
zweite hinzuzufügen. Eine Entscheidung nennt die Version der Änderung, die Sie
gelesen haben, sodass von zwei gleichzeitigen nur eine zählt, und eine Seite,
die vor dem Umschreiben geöffnet wurde, wird mit „The proposal changed since you
opened it“ abgelehnt, bis Sie die neue Version prüfen. Eine Änderung, die sagt,
was die Datei schon sagt, wird gar nicht erst vorgeschlagen.

Jede Bearbeitung einer Datei - angewendet oder von Hand - und ihr Löschen
stellen die Eval-Suites, die laufen, wenn sich eine Abhängigkeit ändert, für
jeden Agent in die Warteschlange, der sie liest, und das Anwenden einer Änderung
benachrichtigt die Besitzer dieser Agents.

## Zugriff { #access }

Eine Context-Datei hat einen Owner und eine Sichtbarkeit wie jede andere
Ressource hier, und `context:view` regelt das Lesen des Katalogs. Eine Datei, die
jemandem nicht gewährt wurde, ist eine Datei, die er nicht binden kann, und das
entscheiden [dieselben drei Schichten](permissions.md) wie überall sonst.

Was wirklich geheim ist, gehört nicht in eine — eine Context-Datei ist Text, den
ein Agent auf die richtige Frage hin laut vorliest. Zugangsdaten gehören in
[den Vault](secrets.md).

## Fazit { #recap }

- Eine Context-Datei ist **einmal geschriebenes stehendes Wissen, an viele Agents
  gebunden**.
- **`inject`** steht immer im Prompt und kostet bei jedem Zug; **`link`** wird auf
  Anforderung gelesen und kostet nichts, bis es so weit ist.
- Eine verlinkte Datei wird über ihre **Beschreibung** gewählt, schreiben Sie
  diese also für das Modell.
- Eine Datei zu bearbeiten aktualisiert **jeden gebundenen Agent bei seinem
  nächsten Run**, ohne dass etwas neu veröffentlicht wird.
- Kurz und immer relevant → Context. Lang → [Wissen](file-processing.md).
  Ein Vorgehen → [ein Skill](skills.md).