Marketplace-Richtlinien

Im Selu-Marketplace entdecken und installieren Nutzer Agenten. Bevor du deinen Agenten einreichst, prüfe, ob er die folgenden Anforderungen erfüllt. Agenten, die das Review nicht bestehen, erhalten Feedback und können nach einer Überarbeitung erneut eingereicht werden.

Anforderungen für die Einreichung

1. Vollständige Metadaten

Dein agent.yaml muss alle Pflichtfelder enthalten:

• name: eindeutig, nur Kleinbuchstaben und Bindestriche
• version: gültiges SemVer
• display_name: klar und verständlich
• description: einzeilige Zusammenfassung mit maximal 160 Zeichen
• author: dein Marketplace-Benutzername
• license: gültige SPDX-Lizenzbezeichnung

2. Sprachdateien

Jeder veröffentlichte Agent muss englische Inhalte enthalten. Deutsche Übersetzungen sind für Agentenpakete, anders als bei den Docs, nicht erforderlich, aber für Marketplace-Einträge empfehlenswert.

3. Funktionierende Capabilities

Alle in agent.yaml referenzierten Capabilities müssen entweder:

• als lokale Verzeichnisse mit gültigem manifest.yaml und Dockerfile vorhanden sein, oder
• auf ein veröffentlichtes, öffentlich erreichbares Docker-Image zeigen

4. Sicherheitsprüfung

Capabilities durchlaufen einen automatisierten Sicherheits-Scan:

• Docker-Images müssen als Nicht-Root-Benutzer laufen
• Es dürfen keine Secrets oder API-Schlüssel im Image fest eingebettet sein
• Keine privilegierten Container-Flags
• Netzwerkzugriff muss zum deklarierten Verhalten passen

Gefahr

Agenten, die versuchen, Nutzerdaten abzuziehen, auf das Host-Dateisystem zuzugreifen oder Sicherheitsmechanismen zu umgehen, werden dauerhaft ausgeschlossen.

5. Qualitätsniveau

• Der Agent muss tun, was seine Beschreibung verspricht. Keine irreführenden Aussagen.
• System Prompts müssen klare Grenzen enthalten. Der Agent soll fachfremde Anfragen sauber ablehnen.
• Capabilities müssen Fehler ordentlich behandeln und verständliche Meldungen zurückgeben, nicht rohe Stack Traces.
• Die Antwortlatenz sollte angemessen sein. Capabilities sollten innerhalb ihres deklarierten Timeouts antworten.

Einreichungsprozess

1. Lokal validieren

   selu validate .
   selu test snapshot run .

2. Alle Capabilities bauen und testen

   selu dev .
   # Test manually and with snapshots

3. Einreichen

   selu publish .

   Dieser Befehl verpackt deinen Agenten, pusht Capability-Images in die Selu-Registry und erstellt eine Einreichung für das Review.

4. Review

   Ein Mensch prüft deine Einreichung anhand der obigen Richtlinien. Du erhältst innerhalb von 48 Stunden Feedback per E-Mail und in der CLI.

5. Veröffentlichen

   Nach der Freigabe erscheint dein Agent im Marketplace. Nutzer können ihn dann so installieren:

   selu install your-agent-name

Inhalte im Listing

Wenn Nutzer im Marketplace stöbern, sehen sie:

• Display Name und Beschreibung aus agent.yaml
• Tags, die bei der Auffindbarkeit helfen
• Autor und Lizenz
• Versionsverlauf und Changelog

Tipp

Schreibe deine description wie einen kompakten Einzeiler, der Lust auf mehr macht. Nutzer entscheiden oft allein daran, ob sie auf dein Listing klicken.

Updates und Delisting

• Updates veröffentlichen mit selu publish .. Erhöhe vorher die Version in agent.yaml.
• Einen Agenten delisten mit selu unpublish your-agent-name. Bestehende Installationen funktionieren weiter, aber neue Installationen sind blockiert.

Nächste Schritte

• Release Pipeline: Veröffentlichung mit GitHub Actions automatisieren
• Versionierung: So funktioniert SemVer im Selu-Ökosystem