Tworzenie aApps

Jeśli planujesz tworzyć lub dostosowywać aApps, postępuj w następujący sposób:

1. Najpierw zdefiniuj możliwości, a następnie zaprojektuj interfejs

   1. Zacznij od zdefiniowania problemu, użytkowników docelowych i oczekiwanego wyniku.

   2. Zaprojektuj działania semantyczne (wywoływane przez Agent) przed utworzeniem interfejsu.

   3. Unikaj zbyt wczesnego rozbudowywania stron i przycisków, ponieważ zwiększa to złożoność i ogranicza możliwość łączenia elementów.

2. Twórz interfejsy przyjazne dla Agent

   1. Stosuj jasne nazwy zorientowane na działanie.

   2. Parametry powinny być zwięzłe i spójne.

   3. Projektuj z myślą o łączeniu elementów, aby wieloetapowe przepływy pracy można było niezawodnie wiązać w całość.

3. Najpierw utwórz minimalną działającą pętlę

   Najpierw nadaj priorytet tej podstawowej pętli:

   Żądanie użytkownika → Agent wywołuje aApp → aApp zwraca użyteczny wynik

   Gdy ta pętla będzie stabilna, rozszerz ją o zaawansowane możliwości, takie jak subskrypcje, automatyzacja i bogatszy interfejs.

4. Oddziel wyszukiwanie od udzielania odpowiedzi

   1. Używaj możliwości zorientowanych na wyszukiwanie gdy potrzebujesz uporządkowanych kandydatów (identyfikatorów, metadanych, wyników przetwarzalnych maszynowo).

   2. Używaj możliwości zorientowanych na odpowiedzi gdy potrzebujesz bezpośrednich odpowiedzi dla użytkownika.

   3. Ten podział zwiększa niezawodność, interpretowalność i wydajność.

5. Zaprojektuj automatyzację zdarzeń jako kompletny potok

   Subskrypcja to nie tylko wyzwalacz. Niezawodny przepływ powinien obejmować:

   Warunek wyzwalający → Wzbogacenie kontekstu → Analiza/przetwarzanie → Zapis zwrotny/informacja zwrotna

   Dzięki temu automatyzacja stale zapewnia wartość, zamiast jedynie „uruchamiać zdarzenia”.

Projekt remio przyjazny dla programistów

1. Izolacja środowisk DEV / PROD

   1. DEV służy do programowania, debugowania i testowania.

   2. PROD służy do stabilnego codziennego użytkowania.

   3. Kod i dane są odizolowane, dzięki czemu testy nie wpływają na działanie środowiska produkcyjnego.

2. Wizualne przełączanie środowisk

   1. Status DEV/PROD jest widoczny w nawigacji i można go łatwo przełączać.

   2. Umożliwia to bezpieczne, iteracyjne programowanie.

3. Dwa punkty wejścia: Skill Market + Skill Studio

   1. Skill Market: odkrywaj, instaluj i zarządzaj dostępnymi Skills.

   2. Skill Studio: klonuj, modyfikuj i publikuj Skills testowo.

   3. Funkcje „używania” i „tworzenia” są wyraźnie rozdzielone, co obniża koszt wdrożenia.

4. Integracja MCP: niski próg wejścia + duża elastyczność

   1. Obsługuje szybkie wdrożenie oparte na OAuth oraz konfigurację ręczną (stdio / streamable-http).

   2. Sprawdza się zarówno przy szybkim wdrożeniu, jak i w zaawansowanych scenariuszach integracji.

Wskazówki dla programistów

• Przeprowadź dokładną walidację w DEV przed przejściem do PROD.

• Wprowadzaj po jednej zależności zewnętrznej naraz (np. jeden serwer MCP), aby ułatwić rozwiązywanie problemów.

• Najpierw wykorzystaj istniejące Skills/aApps, a następnie stopniowo je dostosowuj.

• Do każdego zautomatyzowanego przepływu dodaj mechanizm awaryjny na wypadek błędu oraz widoczną informację zwrotną dla użytkownika.