Notion Custom Agents: Schreibe den Kontextbrief, bevor du die Aufgabe automatisierst
Notion Custom Agents können mehr Arbeitskontext lesen, Integrationen nutzen und je nach Arbeit Credits verbrauchen. Ein kurzer Kontextbrief hilft Teams, vage, teure oder riskante Agentenläufe zu vermeiden.
8. Mai 2026
Notion Custom Agents werden leistungsfähiger. Notion beschreibt, dass sie mehr Workspace-Kontext nutzen, mit Integrationen arbeiten, Skills verwenden, AI Autofill unterstützen und Credits je nach gelesenen Inhalten, Häufigkeit, Modell und Aktionen verbrauchen können.
Highlight Reel
Speichere den Agentenbrief, den dein Team wiederverwenden kann
Wandle nützliche KI-Anweisungen, Quellenhinweise und Entscheidungen in sauberen wiederverwendbaren Kontext um.
Damit ist die Anfrage an einen Agenten weniger ein Chat-Satz und mehr ein Arbeitsbriefing.
Bevor du eine Aufgabe mit einem Notion Custom Agent automatisierst, schreibe zuerst den Kontextbrief.
Kurzantwort
Ein guter Notion-Custom-Agent-Kontextbrief beantwortet fünf Fragen:
| Briefing-Teil | Frage |
|---|---|
| Aufgabe | Was soll der Agent tun? |
| Freigegebene Quellen | Welche Seiten, Datenbanken, Slack-/Teams-Kontexte oder Dokumente darf er nutzen? |
| Ignorieren | Welche Inhalte soll er nicht lesen oder nicht verwenden? |
| Ausgabeformat | Soll er eine Zusammenfassung, Tabelle, Aufgabe, Notiz oder einen Entwurf erzeugen? |
| Prüfung | Was muss ein Mensch prüfen, bevor das Ergebnis zählt? |
Das Ziel ist nicht ein längerer Prompt. Das Ziel ist eine klarere Aufgabe.
Warum Kontextkosten wichtig sind
Die Notion-Dokumentation zu Custom-Agent-Pricing sagt, dass Agenten Credits je nach Arbeit verbrauchen können. Mehr Lesen, mehr Suchen, mehr Aktionen, häufigere Läufe und fortgeschrittenere Modelle können mehr Credits benötigen.
Das ist ein Produktdetail. Es zeigt aber auch eine einfache Workflow-Regel:
Unaufgeräumter Kontext ist nicht kostenlos.Wenn ein Agent zu viel Workspace-Inhalt durchsucht, die falsche Datenbank liest oder eine vage Anfrage ausführt, riskierst du nicht nur eine schlechtere Antwort. Du verbrauchst möglicherweise auch Credits für Arbeit, die nie sauber eingegrenzt war.
Die Lösung ist nicht, dem Agenten zu wenig Kontext zu geben. Die Lösung ist, ihm den richtigen Kontext zu geben.
Vorlage für den Custom-Agent-Kontextbrief
Nutze diese Struktur, bevor du einen Custom Agent erstellst oder ausführst.
# Notion Custom Agent Kontextbrief
## Aufgabe
Was soll der Agent tun?
## Freigegebene Quellen
- Datenbank:
- Seite:
- Slack / Teams Kontext:
- Meetingnotizen:
## Ignorieren
- Veraltete Dokumente:
- Private Gespräche:
- Entwürfe, die noch nicht verwendet werden sollen:
## Ausgabeformat
- Zusammenfassung:
- Tabelle:
- Aufgabe:
- Entscheidungsnotiz:
## Prüfschritt
- Wer prüft:
- Was geprüft werden muss:
- Was der Agent nicht veröffentlichen oder ändern darf:Der Brief kann in Notion, einer Projektdokumentation oder einer gespeicherten Highlight Reel Seite leben. Wichtig ist, dass er wiederverwendbar ist.
Was du nach dem Agentenlauf speichern solltest
Speichere nach einem Custom-Agent-Lauf mehr als nur die finale Antwort.
| Speichern | Warum |
|---|---|
| Aufgabe | Spätere Teammitglieder müssen wissen, was gefragt wurde. |
| Quellen | Das Ergebnis hängt davon ab, was der Agent gelesen hat. |
| Ausgabe | Antwort, Aufgabe, Update oder Entwurf. |
| Menschliche Änderung | Unterschied zwischen Agentenergebnis und freigegebener Arbeit. |
| Follow-up | Der nächste Lauf soll denselben Kontext nicht neu finden müssen. |
Wenn der Agent Aufgaben erstellt, Seiten aktualisiert, Datenbankfelder füllt oder Slack-Kontext zusammenfasst, halte die Entscheidungsspur fest. Sonst sieht der Workspace aktualisiert aus, aber die Begründung verschwindet.
Wann du den Agenten noch nicht starten solltest
Pausiere, wenn:
- die Quelldatenbank unordentlich ist
- alte Dokumente aktuellen Regeln widersprechen
- das Ergebnis kundenrelevant wird
- der Agent private Channels berühren könnte
- niemand für die Prüfung verantwortlich ist
- die Aufgabe zu vage ist, um den Arbeitsumfang abzuschätzen
Das ist nicht gegen Automatisierung. So wird Automatisierung wiederholbar.
Was sich für das Team ändert
Ein Kontextbrief ist nicht nur ein Prompt-Hilfsmittel. Er verändert, wie das Team die Agentenarbeit später prüfen kann.
Ohne Brief sieht das Ergebnis oft wie eine fertige Notion-Seite aus, aber niemand weiß genau, welche Datenbanken, Slack-Kontexte oder veralteten Seiten der Agent benutzt hat. Mit Brief kann ein Reviewer schnell prüfen, ob der Agent innerhalb des erlaubten Bereichs geblieben ist.
Für wiederkehrende Aufgaben lohnt sich besonders ein kleiner Standard:
| Wiederkehrende Aufgabe | Was im Brief stabil bleiben sollte |
|---|---|
| Meeting-Follow-up erstellen | freigegebene Notizen, Zielgruppe, Ausgabeformat |
| Datenbankzeilen zusammenfassen | Datenbank, Filter, ausgeschlossene Felder |
| Projektstatus vorbereiten | relevante Seiten, Zeitraum, offene Risiken |
| Slack-Kontext auswerten | erlaubte Channels, private Inhalte, Review-Gate |
So wird der Brief zu einem wiederverwendbaren Arbeitsrahmen. Der Agent kann schneller starten, aber das Team muss weniger raten.
Wo Highlight Reel passt
Highlight Reel ist nützlich, wenn der Quellenkontext aus KI-Gesprächen, Meetings oder unübersichtlicher Recherche stammt.
Vor dem Agentenlauf kannst du eine saubere Kontextseite speichern:
- Entscheidungszusammenfassung
- Quellenlinks
- akzeptierte Annahmen
- verworfene Wege
- nächste Aktion
Nach dem Agentenlauf kannst du Ergebnis und menschliche Entscheidung speichern:
- was der Agent produziert hat
- was akzeptiert oder geändert wurde
- was im nächsten Lauf wiederverwendet werden soll
So wird ein Agentenlauf zu einem dauerhaften Workflow-Artefakt, nicht nur zu einer weiteren Zeile in der Workspace-Aktivität.
Häufige Fragen
Gilt das nur für Notion?
Nein. Notion ist der Anlass, weil Custom Agents den Workflow sichtbar machen. Das gleiche Kontextbrief-Muster passt zu Slack-Agenten, Microsoft-Agenten, MCP-Tools und internen Automatisierungen.
Sollte der Kontextbrief in Notion liegen?
Das kann er. Der Brief sollte dort leben, wo dein Team Arbeit natürlich prüft. Wenn der Ursprung eine KI-Unterhaltung war, kann eine saubere Highlight Reel Seite besser sein als ein Rohchat.
Senkt ein besserer Brief Notion Credits?
Er kann helfen, unnötige Arbeit zu vermeiden. Die tatsächliche Credit-Nutzung hängt aber von Agenten-Setup, Modell, Aktionen, Häufigkeit und Inhaltsmenge ab. Behandle den Brief als Eingrenzung, nicht als Kostengarantie.
Was ist der kleinste nützliche Brief?
Aufgabe, freigegebene Quellen, ausgeschlossene Quellen, Ausgabeformat und Prüfer.