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