Korzystanie ze współdzielonych workflow w Slacku

Slack umożliwia zespołowi uruchamianie tych samych publicznych workflow tam, gdzie już pojawiają się zgłoszenia i decyzje. Wspomnij o Okou na kanale, aby praca była widoczna, lub użyj wiadomości prywatnej do roboczych wersji i wrażliwych analiz.

Workflow nadal należy do jednego agenta Okou. Slack decyduje, gdzie toczy się rozmowa; nie zmienia to instrukcji workflow, połączeń ani modelu uprawnień.

1. Zainstaluj Okou dla workspace Slacka

Administrator workspace konfiguruje wspólną integrację:

1. Otwórz stronę zarządzania kanałami lub powierzchniami roboczymi Okou.
2. Znajdź Slack i wybierz Install to Slack.
3. Wybierz docelowy workspace Slacka.
4. Przejrzyj i zatwierdź wymagane uprawnienia Slacka.
5. Dokończ instalację i wróć do Okou.

Jeśli nie jesteś administratorem workspace, produkt wyświetli komunikat Ask your admin to install the Slack integration. Twoja organizacja Slack może także wymagać zatwierdzenia aplikacji przez administratora Slacka.

Aplikację instaluje się raz dla workspace. Każdy członek łączy potem własną tożsamość Okou, aby wiadomości i uruchomienia były przypisane do właściwej osoby.

2. Połącz każdego członka

Po instalacji workspace:

1. Otwórz integrację Slacka w Okou.
2. Wybierz Connect.
3. Dokończ połączenie konta Slack.
4. W Slacku otwórz stronę główną aplikacji Okou lub użyj /okou connect, jeśli Slack poprosi o powiązanie konta.

Aktualne główne polecenie slash to /okou.

3. Dodaj Okou do kanału

Zaproś @Okou do każdego kanału, w którym zespół chce korzystać z Okou. Okou może czytać i odpowiadać tylko w kanałach, do których zostało dodane.

Używaj najmniejszego przydatnego zestawu kanałów. Workflow wsparcia może wymagać tylko #support-triage; workflow wdrożeniowy może wymagać tylko #launch-room.

Do pracy prywatnej otwórz wiadomość bezpośrednią z Okou zamiast dodawać je do wspólnego kanału.

4. Wybierz odpowiedniego agenta

Wybrany agent określa, które role, publiczne workflow, połączenia i uprawnienia są dostępne dla nowej rozmowy Slack.

Użyj:

• /okou switch, aby wybrać agenta do następnej rozmowy;
• /okou model, aby wybrać model, jeśli ta opcja jest dostępna;
• strony głównej aplikacji Okou, jeśli wolisz wybór wizualny.

Wybór agenta i modelu jest wiążący w momencie utworzenia wątku Slack. Zmiana tych ustawień nie modyfikuje istniejącego wątku. Rozpocznij nowe główne wspomnienie, jeśli potrzebujesz innego agenta do niezwiązanej pracy.

5. Wywołaj współdzielony workflow

Wspomnij o Okou i podaj nazwę workflow lub oczekiwany rezultat. Dołącz dane wejściowe oraz miejsce docelowe lub ograniczenie zatwierdzenia, jeśli są wymagane.

Wyraźna nazwa workflow:

Okou run qualify-inbound-lead for this message.
Stwórz brief i wersję roboczą odpowiedzi. Nie wysyłaj jej.

Prośba w języku naturalnym:

Okou zakwalifikuj tego leada przychodzącego według naszego wspólnego procesu.
Opublikuj brief w tym wątku i utwórz wersję roboczą e-maila do przeglądu.

Jeśli prośba zależy od bieżącej rozmowy Slack, wspomnij o Okou z tej wiadomości lub wątku, aby zachować odpowiedni kontekst.

6. Kontynuuj w tym samym wątku

Okou odpowiada na wspomnienie na kanale w wątku. Tam kontynuuj poprawki i kolejne prośby. Ten wątek to jedna rozmowa z własnym kontekstem.

Rozpocznij nowe główne wspomnienie, gdy:

• zadanie jest niezwiązane;
• inny agent powinien je przejąć;
• bieżący wątek zawiera kontekst, który nie powinien być przenoszony dalej;
• zespół chce osobną ścieżkę przeglądu.

To utrzymuje czytelność kanału i zapobiega mieszaniu instrukcji z różnych zadań.

Kanał, wątek czy DM?

Nie umieszczaj poufnych danych wejściowych na publicznym kanale tylko dlatego, że workflow jest publiczny. Widoczność workflow i widoczność wiadomości to różne rzeczy.

Przykład: współdzielony workflow triage błędów

Załóżmy, że workspace ma publiczny workflow triage-bug-report na publicznym agencie Product.

1. Członek zespołu publikuje zrzut ekranu i opis w #bug-report.
2. Pisze: @Okou run triage-bug-report on this message. Draft the GitHub issue, but ask before creating it.
3. Okou stosuje wspólne zasady odtwarzania, określania ważności, sprawdzania duplikatów i formatowania zgłoszeń.
4. Członek zespołu przegląda wersję roboczą w wątku Slack.
5. Po zatwierdzeniu Okou tworzy zgłoszenie, używając autoryzowanego dostępu GitHub tej osoby, i odpowiada linkiem.
6. Jeśli to samo brakujące pole pojawia się wielokrotnie, właściciel workflow aktualizuje publiczną instrukcję dla przyszłych zgłoszeń.

Zespół współdzieli metodę triage i ścieżkę przeglądu. Osoba zatwierdzająca akcję nadal używa własnej tożsamości i przyznanych uprawnień.

Rozwiązywanie problemów

Okou nie odpowiada

• Sprawdź, czy aplikacja jest zainstalowana w odpowiednim workspace Slacka.
• Sprawdź, czy @Okou jest członkiem kanału.
• Połącz swoje konto Okou.
• Spróbuj /okou help, aby sprawdzić dostępne polecenia.

Okou używa niewłaściwego agenta

Uruchom /okou switch, wybierz właściwego agenta, a następnie rozpocznij nowe główne wspomnienie. Istniejący wątek zachowuje agenta wybranego przy jego utworzeniu.

Workflow nie został znaleziony

Sprawdź, czy workflow jest Public, jego agent jest publiczny, a rozmowa Slack jest kierowana do tego agenta. Zobacz Udostępnianie workflow zespołowi.

Brakuje uprawnienia connectora

Otwórz monit autoryzacji, potwierdź konto i przyznaj tylko wymagane uprawnienie. Współdzielone workflow nie dziedziczą dostępu do Gmaila, GitHub, Notion ani innych usług innych członków.

Wynik trafił w niewłaściwe miejsce

Podaj miejsce docelowe w prośbie lub instrukcji workflow, np. „odpowiedz w tym wątku”, „wyślij DM” lub „utwórz tylko wersję roboczą”. Zaktualizuj publiczny workflow, jeśli miejsce docelowe powinno być zawsze takie samo.

Pełne informacje o integracji Slack znajdziesz w Slack. O harmonogramach i dostarczaniu przez Slack na zdarzenia przeczytaj w Automatyzacje.