커넥터는 Okou가 대신 가져다 쓰는 도구일 뿐입니다. Slack, Notion, Gmail, GitHub, Linear, Stripe — 한 번 연결하면 Okou는 더 이상 당신의 일을 말로만 다루지 않고 실제로 수행하기 시작합니다.
예를 들어 Okou에게 *"Notion에 출시 공지 초안을 작성하고 #marketing에 링크를 올려줘."*라고 요청한다고 해봅시다. Notion과 Slack이 연결되어 있다면, 그건 더 이상 가정이 아닙니다. Okou가 Notion을 열고, 페이지를 만들고, 초안을 작성한 다음 Slack에 게시합니다 — 당신이 하듯이, 다만 더 빠르게.
연결 방식
Okou는 작업 중에 커넥터를 요청할 수도 있고, 워크스페이스에서 커넥터를 열어 미리 설정할 수도 있습니다. 여기에는 두 가지 별도 결정이 있습니다:
- **연결(Connect)**은 해당 서비스에 대한 현재 멤버의 계정을 연결하거나 활성화합니다. OAuth와 수동 입력 자격 증명은 커넥터가 명시적으로 달리 말하지 않는 한 해당 멤버에게 속합니다.
- **승인 및 권한 부여(Authorize and grant permissions)**는 Okou가 연결을 사용할 수 있는지와 어떤 명명된 작업이 허용되는지를 제어합니다. My Okou에서는 표시되는 계정 및 권한 흐름을 따르세요. 특수한 Agent 선택은 필요하지 않습니다. Legacy Agents에서는 연결이 필요한 Agent를 승인하세요. 연결이 모든 작업을 허용하는 것은 아닙니다.
인라인 카드가 두 단계를 모두 안내할 수 있습니다. 연결이 완료되면 요청된 작업을 검토하고 접근 기간을 선택하세요. 그러면 Okou가 해당 접근 권한 범위 안에서 작업을 계속할 수 있습니다.
동료의 연결이 당신에게 그들의 계정 접근 권한을 준다고 가정하지 마세요. 서비스가 멤버별 자격 증명을 사용하는 경우, 각 멤버는 자신의 계정을 직접 연결합니다.
최초 연결 체크리스트
- 커넥터를 열고 **검색(Discover)**을 사용해 서비스를 찾으세요(이전 인터페이스에서는 **내장(Built-in)**을 사용할 수 있습니다).
- **연결(Connect)**을 선택하고 제공업체의 로그인 또는 자격 증명 흐름을 완료하세요.
- My Okou: 의도한 계정을 검토하세요. Legacy Agents: 커넥터가 필요한 Agent를 선택하세요.
- 요청된 권한을 검토하고 상황에 맞게 1h 동안 허용, 24h 동안 허용, 7d 동안 허용 또는 항상 허용을 선택하세요.
- 실행이 재개되지 않았다면 원래 채팅으로 돌아가서 다시 시도하세요.
계정이 연결되어 있지만 작업이 여전히 차단된다면, 해당 계정 접근 권한, 승인 상태, 그리고 거부된 특정 권한을 확인하세요. 연결 상태만으로는 요청된 작업이 허용된다는 증거가 되지 않습니다.
Okou가 할 수 있는 일 맛보기
커넥터가 실제 작업으로 이어지는 몇 가지 예시는 다음과 같습니다:
- Notion — 페이지 생성, 데이터베이스 업데이트, 회의 메모 정리, 제안서 초안 작성, 워크스페이스 전체 검색.
- Slack — DM 보내기, 채널에 게시하기, 긴 스레드 요약하기, 오래된 대화 후속 조치.
- Gmail — 받은편지함을 읽고, 오늘 실제로 확인해야 할 내용을 보여주며, 계정에서 답장을 초안으로 준비합니다. Okou가 초안을 작성하고, 당신이 전송합니다.
- GitHub — 이슈 열기, PR에 댓글 달기, 백로그 분류, 릴리스 노트 초안 작성.
- Linear — 티켓 등록, 상태 간 작업 이동, 스프린트 요약 생성.
- Stripe, HubSpot, Calendar, Drive, Sheets, Docs… — 작업이 있는 도구가 어디든, 같은 방식입니다.
도구가 어떻게 작동하는지 설명할 필요는 전혀 없습니다. Okou는 이미 알고 있습니다. 당신은 결과만 설명하면 되고, 나머지 클릭은 Okou가 처리합니다.
Okou가 할 수 있는 일을 직접 정합니다
도구 승인에는 전부 아니면 전무가 없습니다. 각 커넥터마다 Okou가 수행해도 되는 작업을 직접 고르며, 커넥터에서 언제든 그 선택을 더 엄격하게 하거나 더 넓힐 수 있습니다. Legacy Agents에서는 Agent의 승인(Authorization) 설정도 사용하세요.
Legacy Agents 예시:
팀이 범위를 정하는 몇 가지 예시는 다음과 같습니다:
- Gmail — Okou가 받은편지함을 읽고 답장 초안을 작성하도록 하되, 당신을 대신해 어떤 것도 보내지 못하게 합니다.
- Slack — Okou가 채널을 읽고 스레드를 요약하도록 하되, 당신 이름으로 게시하는 것은 차단합니다.
- GitHub — Okou가 이슈를 열고 PR에 댓글을 달 수는 있게 하되, 강제 푸시나 브랜치 삭제 같은 파괴적인 작업은 거부합니다.
- Linear — Okou가 티켓을 만들고 업데이트할 수는 있게 하되, 닫거나 삭제하지는 못하게 합니다.
- Notion — Okou가 페이지를 읽고 댓글을 추가할 수는 있게 하되, 데이터베이스에 대한 파괴적인 업데이트는 차단합니다.
접근은 명명된 커넥터 권한으로 강제됩니다. Okou가 현재 허용되지 않은 권한이 필요하면 별도로 요청합니다. 요청의 명명된 작업, 범위, 기간을 검토하고, 실제로 무엇이 실행되었는지는 Chat 활동으로 확인하세요. My Okou와는 별개로 추가적인 Chat 계정 제어가 제공될 수 있습니다. 한 Chat에서 승인된 권한이 그곳에만 적용된다고 가정하지 마세요. 권한을 참조하세요.
내장 및 사용자 지정
내장 커넥터는 Okou가 관리하며 내장(Built-in) 탭 아래에 표시됩니다. 워크스페이스의 실시간 커넥터 선택기가 권위 있는 목록인 이유는, 커넥터가 추가되거나 구성됨에 따라 사용 가능 여부가 바뀔 수 있기 때문입니다.
서비스가 목록에 없으면 조직 관리자가 사용자 지정 커넥터를 등록할 수 있습니다. 사용자 지정 커넥터는 허용된 HTTPS 대상과 자격 증명이 주입되는 방식을 정의합니다. 그런 다음 멤버는 자신의 자격 증명을 연결하고 작업에 필요한 접근 권한을 부여합니다. Legacy Agents에서는 관련 Agent 승인도 필요합니다.
접근에 대한 참고 사항
자격 증명은 플랫폼에 저장되며 네트워크 경계에서 일치하는 발신 요청에 주입됩니다. 에이전트 코드에 환경 변수로 노출되지 않습니다. 커넥터 권한은 자격 증명과 별개이며, 거부되거나 기간 제한을 둘 수 있습니다.
멤버의 연결을 끊으면 이후 실행에서 해당 자격 증명이 제거됩니다. Legacy Agents에서는 하나의 Agent 승인을 제거해도 승인된 다른 Agent는 변경되지 않습니다. Chat 계정 제어가 제공되는 경우, Chat 허용을 제거하는 것은 저장된 계정을 연결 해제하는 것과 다릅니다.
전체 접근 모델은 권한을 참조하세요.
다음 단계
- 카탈로그 — Okou가 기본으로 지원하는 모든 도구.
- 사용자 지정 커넥터 — 그 밖의 모든 것을 추가하세요.
