aApps entwickeln

Wenn Sie aApps entwickeln oder anpassen möchten, gehen Sie wie folgt vor:

1. Zuerst Funktionen definieren, dann die Benutzeroberfläche gestalten

   1. Definieren Sie zunächst das Problem, die Zielgruppe und das erwartete Ergebnis.

   2. Konzipieren Sie semantische Aktionen (für den Aufruf durch den Agent), bevor Sie die Benutzeroberfläche erstellen.

   3. Erstellen Sie nicht zu früh zu viele Seiten und Schaltflächen, da dies die Komplexität erhöht und die Kombinierbarkeit verringert.

2. Agent-freundliche Schnittstellen gestalten

   1. Verwenden Sie klare, handlungsorientierte Bezeichnungen.

   2. Halten Sie Parameter kurz und einheitlich.

   3. Achten Sie auf Kombinierbarkeit, damit mehrstufige Workflows zuverlässig verkettet werden können.

3. Zuerst einen minimal funktionsfähigen Ablauf erstellen

   Priorisieren Sie zunächst diesen grundlegenden Ablauf:

   Benutzeranfrage → Agent ruft eine aApp auf → aApp liefert ein nutzbares Ergebnis

   Sobald dieser Ablauf stabil ist, können Sie ihn um erweiterte Funktionen wie Abonnements, Automatisierung und eine umfangreichere Benutzeroberfläche ergänzen.

4. Abruf und Beantwortung trennen

   1. Verwenden Sie abruforientierte Funktionen für strukturierte Kandidaten (IDs, Metadaten, maschinenlesbare Ausgaben).

   2. Verwenden Sie antwortorientierte Funktionen für direkte Antworten an Benutzer.

   3. Diese Trennung verbessert Zuverlässigkeit, Nachvollziehbarkeit und Leistung.

5. Ereignisautomatisierung als vollständige Pipeline konzipieren

   Ein Abonnement ist mehr als nur ein Auslöser. Ein robuster Ablauf sollte Folgendes umfassen:

   Auslösebedingung → Kontextanreicherung → Analyse/Verarbeitung → Rückschreiben/Feedback

   So liefert die Automatisierung beständig einen Mehrwert, anstatt lediglich „Ereignisse auszulösen“.

Entwicklerfreundliches Design in remio

1. Trennung der DEV- / PROD-Umgebungen

   1. DEV ist für Entwicklung, Debugging und Tests vorgesehen.

   2. PROD ist für den stabilen täglichen Einsatz vorgesehen.

   3. Code und Daten sind voneinander isoliert, sodass Tests den Produktivbetrieb nicht beeinträchtigen.

2. Visueller Umgebungswechsel

   1. Der DEV/PROD-Status ist in der Navigation sichtbar und lässt sich einfach wechseln.

   2. Dies ermöglicht eine sichere, iterative Entwicklung.

3. Zwei Einstiegspunkte: Skill Market + Skill Studio

   1. Skill Market: verfügbare Skills entdecken, installieren und verwalten.

   2. Skill Studio: Skills klonen, ändern und testweise veröffentlichen.

   3. „Verwenden“ und „Erstellen“ sind klar getrennt, was den Einstieg erleichtert.

4. MCP-Integration: niedrige Einstiegshürde + hohe Flexibilität

   1. Unterstützt einen schnellen Einstieg über OAuth sowie die manuelle Einrichtung (stdio / streamable-http).

   2. Geeignet für einen schnellen Einstieg ebenso wie für anspruchsvolle Integrationsszenarien.

Tipps für Entwickler

• Führen Sie in DEV gründliche Prüfungen durch, bevor Sie zu PROD wechseln.

• Fügen Sie jeweils nur eine externe Abhängigkeit hinzu (z. B. einen MCP-Server), um die Fehlersuche zu erleichtern.

• Verwenden Sie zunächst vorhandene Skills/aApps und passen Sie sie anschließend schrittweise an.

• Ergänzen Sie für jeden automatisierten Ablauf einen Rückfallmechanismus bei Fehlern und sichtbares Benutzerfeedback.