--- 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).