자동화는 workflow에 연결된 트리거입니다. 워크플로는 무엇을 할지를 말하고, 자동화는 다른 실행을 언제 시작할지를 말합니다.
자동화는 다음을 사용합니다:
- 워크플로, 현재 절차와 함께
- 소유자, 해당 자동화 채팅과 연결된 접근 권한이 사용됨
- 트리거, 예를 들어 일정, 연결된 서비스의 이벤트, 또는 들어오는 웹훅
매번 실행되는 항목
각 트리거 발생은 해당 워크플로와 소유자의 자동화 채팅에서 새 실행(run) 을 시작합니다. 트리거가 발생할 때마다 완전히 새로운 채팅이 만들어지지는 않습니다. 같은 멤버가 같은 워크플로에 대해 소유한 자동화는 그 자동화 채팅을 재사용합니다.
실행은 워크플로의 현재 지침과 트리거 페이로드를 사용합니다. 채팅이 재사용되므로 이전 실행은 스레드 기록에 남아 있습니다. 작업이 상태를 유지하지 않게 동작해야 한다면, 워크플로 지침에 그렇게 명시하고 현재 이벤트나 명시적인 시간 창만 사용하도록 지시하세요.
모델은 에이전트나 워크플로가 아니라 자동화 채팅 스레드에서 선택됩니다. 자동화 채팅이 처음 생성될 때 모델은 멤버 기본값에서 시작한 다음 워크스페이스 기본값을 따릅니다. 이후의 트리거 발생은 해당 스레드에 대해 선택된 모델을 재사용합니다.
자동화 채팅을 열어 실행, 출력, 표시되는 오류를 확인하세요. 실패한 트리거 발생도 그곳에 계속 표시되므로 워크플로, 커넥터 액세스, 트리거를 수정한 뒤 다시 실행할 수 있습니다.
트리거 참고
워크플로의 자동화 선택기는 현재 워크스페이스에서 만들 수 있는 항목의 기준입니다. 일부 이벤트 유형은 워크스페이스 기능 스위치 뒤에서 제공되므로 모든 곳에 표시되지 않을 수 있습니다.
일정
| 유형 | 동작 |
|---|---|
| Scheduled | cron 일정과 IANA 시간대를 사용하여 실제 시계 시간에 실행됩니다. |
| Interval | 실행이 완료된 후 구성된 간격만큼 기다린 다음 다음 실행을 예약합니다. 실행은 서로 겹치지 않습니다. |
| Once | 선택한 날짜와 시간에 실행된 다음 비활성화됩니다. |
저장하기 전에 자동화에 표시된 시간대를 확인하세요. 실제 시계 기준 타이밍에는 예약된 자동화를, 완료 후 간격이 중요한 폴링에는 간격 자동화를 사용하세요.
Gmail
| 이벤트 | 필터 |
|---|---|
| New message | From, To, Cc, Subject, 본문 텍스트 일치자는 선택 사항입니다. 일치자가 없으면 모든 새 메시지가 대상이 될 수 있습니다. |
| Label applied | Gmail 라벨 이름 하나. |
메일이 많은 받은편지함에서 예상치 못한 수의 실행이 생성되지 않도록, 좁은 새 메시지 필터로 시작하세요.
GitHub
GitHub 이벤트를 사용하려면 Okou의 GitHub App을 GitHub 조직에 설치해야 합니다. 설치되지 않았다면 자동화 설정 화면에 그렇게 표시되며, 조직 관리자는 그곳에서 Install GitHub App 버튼을 받습니다. 그 외의 모든 사용자에게는 관리자에게 요청하라는 안내가 표시됩니다. 한 번 설치하면 아래의 모든 GitHub 트리거를 사용할 수 있습니다.
| 이벤트 | 일반 필터 |
|---|---|
| Pull request | 하나의 저장소와 하나의 작업: opened, reopened, closed, ready for review, converted to draft, synchronized, 병합 큐에 추가 또는 제거됨, labeled 또는 unlabeled. base branch, 작성자, PR 번호, 라벨로 범위를 좁힐 수 있습니다. closed에서는 병합 없이 merged와 closed를 구분할 수 있습니다. |
| Workflow run completed | 저장소, 워크플로, conclusion, branch, triggering event, actor. |
| Workflow job completed | 저장소, 워크플로, job, conclusion, branch, runner label, runner group. |
| Pull request review submitted | 저장소, review state, base branch, head branch, trusted author. |
| Deployment status created | 저장소, environment, state, ref, creator, app, production-environment flag. |
| Issue or pull-request comment created | 저장소, issue/PR 범위, trusted author, comment prefix. |
별도의 GitHub label applied 이벤트는 없습니다. PR 라벨에 반응하려면 Pull request를 선택하고 Labeled 작업을 고른 뒤 라벨 필터를 추가하세요.
Google Calendar and Meet
- 선택한 calendar ID 범위의 Calendar event created, updated, 또는 cancelled
- 연결된 멤버가 진행한 회의의 Google Meet transcript generated
Chat 및 기타 통합
- Chat run finished는 사용자의 채팅 스레드 중 하나를 감시합니다. 완료, 실패, 또는 취소 상태로 필터링할 수 있으며, 완료된 실행의 경우 최종 응답과 대소문자를 구분하지 않는
*와일드카드 일치도 사용할 수 있습니다. - Webhook received는 서명된 인바운드 URL을 생성하며, 워크스페이스 요금제에 웹훅 자동화가 포함된 경우 사용할 수 있습니다.
- Google Forms response submitted, Notion page/database events, Strapi entry published, Stripe invoice paid는 이러한 자동화 기능이 활성화된 워크스페이스에서만 표시됩니다.
이벤트 자동화에는 해당 커넥터 또는 통합이 자동화 소유자에 대해 연결되어 있고 사용할 준비가 되어 있어야 합니다.
자동화 메시지는 발생한 일을 평이한 언어로 설명하며, Chat run finished 트리거로 시작된 실행은 원래 스레드를 가리킵니다.
자동화 만들기
작동하는 채팅에서. 먼저 작업을 단발성으로 실행하세요. 원하는 결과가 나오면 이렇게 말하세요:
"이것을 매주 평일 8 a.m. 로스앤젤레스 시간에 실행하고 결과를 DM으로 보내줘."
Okou는 워크플로, 주기, 대상 위치를 확인하고, 아직 없다면 워크플로를 저장한 뒤 자동화를 연결합니다.
명시적으로. 워크스페이스에서 워크플로를 열고 Add automation을 클릭한 다음 트리거 유형과 필터를 선택하세요. 미리 형태를 알고 있고 드라이런을 원하지 않을 때 유용합니다.
절차는 Workflow에서 가져옵니다. My Okou에서는 실행 시 자동화 소유자의 개인 Instructions, memory, 연결된 계정, 그리고 그 워크스페이스에서의 권한이 사용됩니다. Legacy Agents에서는 소유하는 Agent가 Agent 컨텍스트를 제공합니다. 일정 트리거는 언제 실행할지와 어느 시간대를 사용할지를 묻습니다.
Public Workflow는 방법을 공유할 뿐, 만든 사람의 Automations나 접근 권한은 공유하지 않습니다. 각 멤버는 자신의 Automations를 만들고 관리합니다. 워크플로를 복사했다고 해서 다른 멤버의 트리거, 자격 증명, 또는 자동화 채팅이 함께 이전된다고 가정하지 마세요.
자동화는 개별적으로 활성화 및 비활성화할 수 있으며 삭제되지 않습니다. 휴가를 가기 전이나 소음이 많은 트리거를 디버깅하는 동안 특히 유용한 선택입니다.
대상
자동화는 결과가 어디로 가는지 알아야 합니다. 워크플로 지침에 명시하세요:
- Slack 채널 또는 DM — 가장 일반적이며, 메시지 또는 스레드로 채널에 도착합니다
- Feishu 또는 Microsoft Teams — 그곳에서 일하는 팀을 위한 같은 방식
- Telegram 또는 문자 메시지 — 개인용, 모바일 우선 알림용
- Notion 페이지 또는 데이터베이스 — 방송하기보다 보관해야 하는 항목용
- Google Doc 또는 Sheet — 추가 또는 덮어쓰기
- GitHub issue 또는 PR comment — 엔지니어링 워크플로용
- Gmail draft — 검토 후 전송할 수 있도록 계정에 준비됨
- 호스팅된 페이지 — 호스팅된 사이트 참조
- 워크스페이스 파일 — 결과물이 비디오, 이미지 또는 다운로드 가능한 자산일 때
"#engineering에 게시" 또는 "나에게 DM" 이 "어딘가로 보내" 보다 더 분명합니다.
운영 팁
다음은 프로덕션에서 자동화를 운영하며 얻은 팁입니다:
- 처음 세 번의 실행을 지켜보세요. 자동화는 설정하기 쉽지만, 실제 환경에서 Okou가 무엇을 만드는지 본 뒤 더 쉽게 다듬을 수 있습니다.
- 각 작업을 작게 유지하세요. 길고 다단계인 자동화는 더 쉽게 깨집니다. 하나가 다섯 개 시스템을 모두 업데이트해야 한다면 둘로 나누는 것을 고려하세요.
- 대상 위치를 고정하세요. 채널 이름은 바뀌고 사람들은 떠납니다. 워크플로 지침에 대상 위치를 명시적으로 적어 두세요. Okou는 다음 실행에서 찾을 수 없으면 경고합니다.
- 장기 실행 쿼리는 시간 범위를 지정하세요. 프롬프트가 "지난 30일"을 요청한다면, 매 실행마다 그 범위를 다시 적어 창이 최신 상태로 유지되게 하세요.
- 시간대를 확인하세요. Scheduled 및 일회성 자동화는 명시적인 시간대를 저장합니다. 저장하기 전에 표시된 값을 확인하세요.
- 휴가 전에는 일시 중지하세요. 특히 DM을 보내는 자동화의 경우 — 14개의 짧은 DM으로 돌아오는 것은 도움이 되지 않습니다. 자동화를 비활성화했다가 돌아오면 다시 활성화하세요. 워크플로는 그대로 유지됩니다.
비용과 볼륨
자동화의 트리거 발생은 일반 실행을 시작하며, 사용되는 모델 경로와 서비스에 따라 크레딧을 소모할 수 있습니다. 비용을 추정할 때는 자동화 채팅과 Billing을 확인하세요.
짧은 간격은 빠르게 누적됩니다. 각 실행이 다음 간격이 지나기 전에 끝나면 15분 간격은 하루에 최대 96번까지 실행될 수 있습니다. 광범위한 이벤트 필터도 마찬가지로 소음이 클 수 있습니다. 먼저 좁게 시작하고, 처음 몇 번의 트리거 발생을 검토한 뒤, 의도적으로 필터나 주기를 넓히세요.
새 트리거 발생을 워크플로 또는 기록을 삭제하지 않고 중지하려면 자동화를 비활성화하세요.
