Zum Hauptinhalt springen
Eine Voreinstellung speichert Modell, System-Prompt, Parameter und Anbieterregeln für eine Aufgabe unter einem Namen wie @support-triage. Aufrufer senden diesen Namen als model und nur die Eingabe; das Gateway ergänzt den Rest, bevor es einen Anbieter auswählt. Schalte die Anfragefelder um, um zu sehen, welcher Wert gewinnt: Es gelten diese Regeln:
  • Parameter füllen Lücken. Die Standardparameter einer Voreinstellung gelten nur für Felder, die in der Anfrage fehlen. Ein Wert in der Anfrage gewinnt immer.
  • System-Prompts werden gestapelt. Der Prompt der Voreinstellung steht zuerst. Hat die Anfrage einen eigenen System-Prompt oder instructions, folgt dieser nach einer Leerzeile.
  • Anbietereinstellungen in der Anfrage gewinnen. Felder wie provider.order oder provider.max_price in der Anfrage ersetzen den Wert der Voreinstellung für dieses Feld.
  • Zulassungslisten schränken ein, erweitern aber nie. Die Zulassungs- und Ignorierlisten der Voreinstellung für Anbieter werden vor der Anbieterauswahl angewendet und begrenzen daher auch, welche Anbieter ein Fallback nutzen kann. Ein Modell außerhalb der erlaubten Modelle der Voreinstellung schlägt mit einem validation_error fehl, dessen Detail-Schlüsselwort preset_model_not_allowed lautet; es wird nicht umgeleitet.

Eine Voreinstellung erstellen und nutzen

1

Die Voreinstellung erstellen

Öffne Dashboard -> Einstellungen -> Voreinstellungen und erstelle eine Voreinstellung mit einem Slug wie support-triage. Füge nur die Standards hinzu, die alle Aufrufer teilen sollen.Für Skripte rufst du POST /v1/presets mit einem Management-Schlüssel auf.
2

Über ihren Namen aufrufen

3

Prüfen, was angewendet wurde

Öffne die Anfrage unter Gateway -> Nutzung, um zu sehen, welche Standards der Voreinstellung angewendet wurden und welcher Anbieter sie bedient hat.

Was eine Voreinstellung enthalten kann

Halte aufruferspezifische Logik in deiner Anwendung und nutze getrennte Voreinstellungen, wenn Workflows unterschiedliche Prompts, Routing oder Caching brauchen.

Eine Voreinstellung benennen

Sende eine Voreinstellung über das Feld model oder, wenn sie eine Prompt-Vorlage hat, über prompt.id. Ein separates Feld preset gibt es nicht. Zum Veröffentlichen einer öffentlichen Voreinstellung brauchst du ein aktiviertes öffentliches Profil und einen Benutzernamen. Benutzernamen sind in ganz Phaseo eindeutig; Slugs müssen nur pro Herausgeber eindeutig sein. Slugs werden in Kleinbuchstaben umgewandelt und dürfen Buchstaben, Ziffern, -, _, . und : enthalten.

Versionieren und zurückrollen

Speichern ändert einen privaten Entwurf. Neue Version veröffentlichen macht aus dem Entwurf eine unveränderliche, nummerierte Version und behält alle früheren. Lege fest, wie Versionsbezeichnungen aussehen: Richte ein benanntes Label wie production auf eine Version, und schiebe es auf eine frühere Version zurück, um zurückzurollen. Siehe Versionen und Labels. In Skripten veröffentlichst du mit POST /v1/presets/{id}/versions und verschiebst Labels mit PUT /v1/presets/{id}/labels/{label}, jeweils mit einem Management-Schlüssel. Eine CLI-Anmeldung oder eine App, die Mit Phaseo anmelden nutzt, kann Voreinstellungen lesen, aber nicht ändern.

Eine Marketplace-Voreinstellung forken

Eine Kopie einer Marketplace-Voreinstellung bleibt an die Version gebunden, die du kopiert hast. Veröffentlicht der Herausgeber ein Update, zeigt deine Kopie einen Hinweis. Das Anwenden ändert nur deinen Entwurf, sodass nichts in die Produktion gelangt, bevor du selbst veröffentlichst. Phaseo speichert die Quelle und die vollständige Abstammung jedes Forks, sodass eine Marketplace-Seite direkte Forks getrennt von allen Nachkommen anzeigen kann. Wie du Bewertungen zu den Antworten einer Voreinstellung sammelst, steht unter Feedback zu Voreinstellungen erfassen.
Zuletzt geändert am 7. November 2026