Endpunkte verstehen

Aus Sicht des aufrufenden Systems verhält sich ein Endpunkt wie eine gängige Chat-Schnittstelle: Wer schon eine Anbindung an ein Sprachmodell gebaut hat, kann sie in der Regel unverändert weiterverwenden und nur die Basisadresse und den Schlüssel austauschen.

Der Aufruf geht an eine Adresse der Form

POST https://<plattform-adresse>/v1/endpoints/<arbeitsbereich>/<kurzname>/chat/completions
Authorization: Bearer <schlüssel>

Was ein Endpunkt steuert

Bereich	Bedeutung
Kurzname	Teil der Adresse. Eindeutig im Arbeitsbereich, nach der ersten Veröffentlichung unveränderlich.
Name und Beschreibung	Nur zur Orientierung in der Verwaltung
Verhalten	Welcher Grundablauf verwendet wird
Zusätzliche Anweisung	Ein Textblock, der über den Grundablauf gelegt wird
Wissensbindungen	Welche Ordner der Endpunkt durchsuchen darf
Werkzeugbindungen	Welche Funktionen aufgerufen werden dürfen
Modell und Parameter	Optional abweichend vom Standard des Arbeitsbereichs; gilt erst nach dem Veröffentlichen
Grenzen	Anfragen pro Minute und Wochenbudget
Zugang	Schlüsselart, erlaubte Herkünfte, Adressfreigaben
Einstufung	Risikoklasse, Rechtsgrundlage, Datenkategorien, Veröffentlichungsstatus
Zustand	Entwurf → aktiv → stillgelegt. Nur ein aktiver Endpunkt antwortet.

Der Kurzname ist nach der Veröffentlichung fest. Er steckt in der Adresse, die Ihre aufrufenden Systeme fest eingetragen haben. Überlegen Sie ihn sich deshalb vorher — ein späterer Wechsel bedeutet einen neuen Endpunkt.

Wann sich ein Endpunkt lohnt

Ja, wenn:

• Ein System außerhalb der Oberfläche antworten soll — Webseite, Intranet, Fachanwendung.
• Der Kreis der Fragenden über die Mitglieder Ihres Arbeitsbereichs hinausgeht.
• Sie Verbrauch und Kosten für einen bestimmten Anwendungsfall getrennt sehen wollen.

Nein, wenn:

• Es nur darum geht, dass Beschäftigte etwas Bestimmtes fragen können. Dafür ist ein Assistent das richtige Mittel — mit weniger Aufwand und ohne Außenfläche. Siehe Assistenten verwalten.

Getrennte Auswertung

Verbrauch, Kosten und Fehler werden je Endpunkt ausgewiesen. Das ist der praktische Grund, für unterschiedliche Anwendungsfälle getrennte Endpunkte anzulegen statt eines großen: Sie sehen, was welcher Zweck kostet, und können einen einzelnen abschalten, ohne die anderen zu treffen.

Die Liste der Endpunkte führt die Spalte Letzte Verwendung: wann zuletzt ein Schlüssel dieses Endpunkts einen Aufruf gemacht hat. Noch nie heißt, dass über seine Schlüssel noch kein Aufruf kam. Ein Endpunkt, der nur als Weiterleitungsziel eines verteilenden Endpunkts dient, zeigt dort ebenfalls Noch nie, weil die Aufrufe über die Schlüssel des Verteilers laufen — siehe Qualität und Routing.

Wer Endpunkte sieht

Bearbeiten, veröffentlichen und Schlüssel verwalten dürfen ab Werk Eigentümer und Administratoren. Mitglieder dürfen Endpunkte lesen: Im Menü erscheinen sie für Mitglieder nicht, über einen direkten Link öffnet sich der Editor aber mit dem Hinweis Nur Lesezugriff. Lesbar sind dabei auch die zusätzliche Anweisung, die Herkunfts- und Adressfreigaben und die Anfänge der Schlüssel — siehe Rollen und Rechte.

Der Lebenszyklus

Entwurf  →  veröffentlicht (aktiv)  →  stillgelegt

Im Entwurfszustand antwortet der Endpunkt nicht. Ein Aufruf erhält eine Fehlermeldung, dass der Endpunkt nicht aktiv ist. Dasselbe gilt nach der Stilllegung.

Das ist Ihr Sicherheitsnetz: Sie können in Ruhe konfigurieren, ohne dass etwas nach außen antwortet.