Slack을 통해 팀은 요청과 의사결정이 이미 이루어지는 곳에서 동일한 공개 워크플로우를 실행할 수 있습니다. Okou를 채널에서 멘션하면 모든 작업이 보이게 되고, 비공개 초안이나 민감한 분석에는 다이렉트 메시지를 사용할 수 있습니다.
워크플로우는 여전히 하나의 Okou 에이전트에 소속됩니다. Slack은 대화가 어디서 이루어지는지만 결정하며, 워크플로우 지침, 연결, 권한 모델은 변경하지 않습니다.
1. Slack 워크스페이스에 Okou 설치
워크스페이스 관리자가 공유 통합을 설정합니다:
- Okou의 채널 또는 작업 공간을 관리하는 페이지를 엽니다.
- Slack을 찾아 Slack에 설치를 선택합니다.
- 원하는 Slack 워크스페이스를 선택합니다.
- 요청된 Slack 권한을 검토하고 승인합니다.
- 설치를 완료하고 Okou로 돌아갑니다.
워크스페이스 관리자가 아닌 경우, 제품에서 관리자에게 Slack 통합 설치 요청 메시지가 표시됩니다. Slack 조직에 따라 Slack 관리자의 앱 승인도 필요할 수 있습니다.
앱은 워크스페이스에 한 번만 설치하면 됩니다. 각 구성원은 자신의 Okou 아이덴티티를 연결하여 메시지와 실행이 올바른 사용자에게 귀속되도록 해야 합니다.
2. 각 구성원 연결
워크스페이스 설치 후:
- Okou에서 Slack 통합을 엽니다.
- 연결을 선택합니다.
- Slack 계정 연결을 완료합니다.
- Slack에서 Okou 앱 홈을 열거나, Slack이 계정 연결을 요청할 경우
/okou connect을 사용합니다.
현재 기본 슬래시 명령어는 /okou입니다.
3. Okou를 채널에 추가
팀이 Okou를 사용하고자 하는 각 채널에 @Okou를 초대하세요. Okou는 추가된 채널에서만 읽고 답변할 수 있습니다.
가장 필요한 최소한의 채널만 사용하세요. 지원 워크플로우에는 #support-triage만, 출시 워크플로우에는 #launch-room만 필요할 수 있습니다.
비공개 작업에는 Okou와 다이렉트 메시지를 시작하세요. 공유 채널에 추가할 필요는 없습니다.
4. 올바른 에이전트 선택
선택한 에이전트에 따라 새 Slack 대화에서 사용할 역할, 공개 워크플로우, 연결, 권한이 결정됩니다.
사용 방법:
/okou switch로 다음 대화에 사용할 에이전트를 선택합니다./okou model로 해당 옵션이 있을 때 모델을 선택합니다.- 시각적 선택기를 선호한다면 Okou 앱 홈 컨트롤을 사용하세요.
에이전트와 모델 선택은 Slack 스레드가 생성될 때 고정됩니다. 변경해도 기존 스레드는 수정되지 않습니다. 다른 에이전트가 필요한 경우 새 최상위 멘션으로 시작하세요.
5. 공유 워크플로우 호출
Okou를 멘션하고 워크플로우 또는 원하는 결과를 지정하세요. 실행에 필요한 입력값과 목적지, 승인 조건도 포함합니다.
명시적 워크플로우 이름 예시:
Okou run qualify-inbound-lead for this message.
브리프와 답변 초안을 생성하세요. 전송하지 마세요.
자연어 요청 예시:
Okou qualify this inbound lead using our shared process.
이 스레드에 브리프를 게시하고 검토용 이메일 초안을 만드세요.
요청이 현재 Slack 대화에 의존한다면, 해당 메시지나 스레드에서 Okou를 멘션하여 관련 컨텍스트가 유지되도록 하세요.
6. 후속 요청은 동일한 스레드에 유지
Okou는 채널 멘션에 스레드로 답변합니다. 관련된 수정이나 후속 요청도 그 스레드에서 이어가세요. 해당 스레드는 자체 컨텍스트를 가진 하나의 대화입니다.
새 최상위 멘션으로 시작해야 할 때:
- 작업이 관련이 없을 때
- 다른 에이전트가 담당해야 할 때
- 현재 스레드의 컨텍스트를 이어가면 안 될 때
- 팀이 별도의 검토 기록을 원할 때
이렇게 하면 채널의 메시지가 읽기 쉬워지고, 서로 다른 작업의 지침이 혼합되는 것을 방지할 수 있습니다.
채널, 스레드, 또는 DM?
| 표면 | 사용 용도 | 예시 |
|---|---|---|
| 채널 멘션 | 팀이 확인 및 검토해야 하는 작업 | 사고 스레드 요약 및 실행 항목 초안 작성 |
| 스레드 후속 | 동일 작업의 수정 및 다음 단계 | 주장 검증, 형식 변경, 승인된 이슈 등록 등 |
| 다이렉트 메시지 | 비공개 초안, 민감한 분석, 개인 작업 | 고객 답변 초안 작성, 비공개 문서 분석 등 |
워크플로우가 공개라고 해서 민감한 입력값을 공개 채널에 올리지 마세요. 워크플로우 공개 여부와 메시지 공개 여부는 다릅니다.
예시: 공유 버그 트리아지 워크플로우
워크스페이스에 공개 Product 에이전트의 공개 triage-bug-report 워크플로우가 있다고 가정합니다.
- 팀원이
#bug-report에 스크린샷과 설명을 올립니다. - 다음과 같이 작성합니다:
@Okou run triage-bug-report on this message. Draft the GitHub issue, but ask before creating it. - Okou가 공유 재현, 심각도, 중복 확인, 이슈 형식 규칙을 적용합니다.
- 팀원이 Slack 스레드에서 초안을 검토합니다.
- 승인 후 Okou가 해당 멤버의 GitHub 권한으로 이슈를 생성하고 링크로 답변합니다.
- 동일한 누락 필드가 반복되면, 워크플로우 소유자가 향후 보고를 위해 공개 지침을 업데이트합니다.
팀은 트리아지 방법과 검토 기록을 공유합니다. 승인자는 여전히 자신의 계정과 권한을 사용합니다.
문제 해결
Okou가 응답하지 않음
- 앱이 올바른 Slack 워크스페이스에 설치되어 있는지 확인하세요.
@Okou가 채널 멤버인지 확인하세요.- Okou 계정을 연결하세요.
- 사용 가능한 명령어 확인을 위해
/okou help를 시도하세요.
Okou가 잘못된 에이전트를 사용함
/okou switch을 실행하여 원하는 에이전트를 선택한 후 새 최상위 멘션을 시작하세요. 기존 스레드는 생성 시 선택된 에이전트를 유지합니다.
워크플로우를 찾을 수 없음
워크플로우가 공개 상태인지, 소유 에이전트가 공개인지, Slack 대화가 해당 에이전트로 라우팅되는지 확인하세요. 팀과 워크플로우 공유하기를 참고하세요.
커넥터 권한이 없음
인증 프롬프트를 열고 계정을 확인한 후 필요한 권한만 부여하세요. 공유 워크플로우는 다른 멤버의 Gmail, GitHub, Notion 등 서비스 접근 권한을 상속하지 않습니다.
결과가 잘못된 위치로 전송됨
요청이나 워크플로우 지침에 목적지를 명시하세요. 예: “이 스레드에 답변”, “DM으로 보내기”, “초안만 생성”. 모든 실행에 동일한 목적지가 필요하다면 공개 워크플로우를 업데이트하세요.
Slack 통합의 전체 동작은 Slack에서 확인하세요. 일정 및 이벤트 기반 Slack 전달은 자동화에서 확인할 수 있습니다.
