자동화는 워크플로에 연결된 트리거입니다. 워크플로는 무엇을 할지를 말하고, 자동화는 언제 새 Run을 시작할지를 말합니다.
자동화는 다음을 사용합니다:
- 워크플로(그것을 소유한 에이전트 포함)
- 소유자(그 자동화 채팅과 연결된 액세스가 사용됨)
- 트리거(예: 일정, 연결된 서비스의 이벤트, 수신 웹훅)
매번 실행되는 것
각 발화는 해당 워크플로와 소유자의 자동화 채팅에서 새 Run을 시작합니다. 발화할 때마다 완전히 새로운 채팅이 만들어지지는 않습니다. 같은 멤버가 같은 워크플로에 대해 소유한 자동화는 그 자동화 채팅을 재사용합니다.
Run은 워크플로의 현재 인스트럭션과 트리거 페이로드를 사용합니다. 채팅이 재사용되므로 이전 Run은 그 스레드 기록에 남습니다. 태스크를 상태 비저장 방식으로 동작시켜야 한다면 워크플로 인스트럭션에 그렇게 명시하고 현재 이벤트 또는 명시적인 시간 범위만 사용하라고 Okou에 지시하세요.
모델은 에이전트나 워크플로가 아니라 자동화 채팅 스레드에서 선택됩니다. 자동화 채팅이 처음 생성될 때 그 모델은 멤버 기본값에서 시작한 다음 워크스페이스 기본값을 사용합니다. 이후 발화는 그 스레드에 선택된 모델을 재사용합니다.
자동화 채팅을 열어 Run, 출력, 표시되는 오류를 검사하세요. 실패한 발화는 거기에 그대로 남으므로 워크플로, 커넥터 액세스 또는 트리거를 수정하고 다시 실행할 수 있습니다.
트리거 참조
워크플로의 자동화 선택기가 현재 워크스페이스가 만들 수 있는 것의 정확한 기준입니다. 일부 이벤트 유형은 워크스페이스 기능 스위치 뒤에서 공개되므로 모든 곳에 표시되지 않을 수 있습니다.
일정
| 유형 | 동작 |
|---|---|
| Scheduled | cron 일정과 IANA 시간대를 사용해 실제 시계 시간에 실행합니다. |
| Interval | Run이 완료된 후 설정된 간격만큼 기다렸다가 다음 Run을 예약합니다. Run은 서로 겹치지 않습니다. |
| Once | 선택한 날짜와 시간에 실행된 후 자체적으로 비활성화됩니다. |
저장하기 전에 자동화에 표시된 시간대를 확인하세요. 실제 시계 시간에는 예약 자동화를, 완료 후 간격이 중요한 폴링에는 간격 자동화를 사용하세요.
Gmail
| 이벤트 | 필터 |
|---|---|
| New message | 보낸 사람, 받는 사람, 참조, 제목, 본문 텍스트의 선택적 매처. 매처가 없으면 모든 새 메시지가 대상이 됩니다. |
| Label applied | Gmail 라벨 이름 하나. |
바쁜 받은 편지함이 예상치 못한 수의 Run을 만들지 않도록 좁은 새 메시지 필터부터 시작하세요.
GitHub
| 이벤트 | 일반적인 필터 |
|---|---|
| Pull request | 리포지토리 하나와 액션 하나: opened, reopened, closed, ready for review, converted to draft, synchronized, added to or removed from the merge queue, labeled 또는 unlabeled. 기본 브랜치, 작성자, PR 번호, 라벨로 좁히세요. closed의 경우 merged를 closed without merging과 구분할 수 있습니다. |
| Workflow run completed | 리포지토리, 워크플로, conclusion, 브랜치, 트리거 이벤트, actor. |
| Workflow job completed | 리포지토리, 워크플로, job, conclusion, 브랜치, 러너 라벨, 러너 그룹. |
| Pull request review submitted | 리포지토리, 리뷰 상태, 기본 브랜치, 헤드 브랜치, 신뢰할 수 있는 작성자. |
| Deployment status created | 리포지토리, 환경, 상태, ref, 생성자, 앱, 프로덕션 환경 플래그. |
| Issue or pull-request comment created | 리포지토리, Issue/PR 범위, 신뢰할 수 있는 작성자, 댓글 접두사. |
별도의 GitHub label applied 이벤트는 없습니다. PR 라벨에 반응하려면 Pull request를 선택하고 Labeled 액션을 선택한 다음 라벨 필터를 추가하세요.
Google Calendar 및 Meet
- Calendar event created, updated 또는 cancelled(선택한 캘린더 ID로 범위 지정)
- Google Meet transcript generated(연결된 멤버가 주최한 회의용)
채팅 및 기타 통합
- Chat run finished는 내 채팅 스레드 하나를 관찰합니다. completed, failed, cancelled 상태로 필터링할 수 있고, 완료된 Run은 최종 답변에 대해 대소문자를 구분하지 않는
*와일드카드로 필터링할 수 있습니다. - Webhook received는 서명된 수신 URL을 만들며 워크스페이스 플랜에 웹훅 자동화가 포함된 경우 사용할 수 있습니다.
- Google Forms response submitted, Notion page/database events, Strapi entry published, Stripe invoice paid는 해당 자동화 기능이 활성화된 워크스페이스에서만 표시됩니다.
이벤트 자동화는 자동화 소유자에게 해당 커넥터 또는 통합이 연결되어 있고 준비되어 있어야 합니다.
자동화 만들기
잘 작동하는 채팅에서. 먼저 태스크를 일회성으로 실행하세요. 원하는 결과가 나오면 이렇게 말하세요:
"Run this every weekday at 8 a.m. Los Angeles time and DM me the result."
Okou가 워크플로, 주기, 대상을 확인하고 워크플로가 아직 없으면 저장한 뒤 자동화를 연결합니다.
명시적으로. 워크스페이스에서 워크플로를 열고 트리거 유형과 필터를 선택해 자동화를 추가하세요. 형태를 미리 알고 있고 드라이런을 원하지 않을 때 유용합니다.
자동화는 삭제하지 않고 개별적으로 활성화·비활성화할 수 있습니다. 휴가 전이나 시끄러운 트리거를 디버깅하는 동안 적절한 방법입니다.
대상
자동화는 결과가 어디로 가는지 알아야 합니다. 워크플로 인스트럭션에 명시하세요:
- Slack 채널 또는 DM — 가장 일반적. 채널에 메시지 또는 스레드로 도착
- Feishu 또는 Microsoft Teams — 그곳을 주로 쓰는 팀을 위한 동일한 방식
- Telegram 또는 문자 메시지 — 개인용, 모바일 우선 알림
- Notion 페이지 또는 데이터베이스 — 브로드캐스트보다 보관해야 하는 것
- Google Doc 또는 Sheet — 추가 또는 덮어쓰기
- GitHub Issue 또는 PR 댓글 — 엔지니어링 워크플로용
- Gmail 초안 — 검토하고 보낼 수 있도록 내 계정에 준비됨
- 호스팅된 페이지 — Hosted sites 참조
- 워크스페이스 파일 — 결과물이 동영상, 이미지 또는 다운로드 가능한 에셋일 때
"Post to #engineering" 또는 *"DM me"*가 *"send it somewhere."*보다 명확합니다.
운영 팁
프로덕션에서 자동화를 실행하며 얻은 팁입니다:
- 처음 세 번의 Run을 관찰하세요. 자동화는 설정하기 쉽지만, Okou가 실제 환경에서 무엇을 만들어내는지 보고 나면 다듬기가 훨씬 쉬워집니다.
- 각 태스크를 작게 유지하세요. 길고 여러 단계의 자동화는 더 취약합니다. 하나가 다섯 개 시스템을 업데이트해야 한다면 둘로 나누는 것을 고려하세요.
- 대상을 고정하세요. 채널은 이름이 바뀌고 사람은 떠납니다. 워크플로 인스트럭션에 대상을 명시하세요. 다음 Run에서 찾지 못하면 Okou가 경고합니다.
- 장기 쿼리는 시간을 한정하세요. 프롬프트가 "최근 30일"을 요구한다면 매 Run마다 다시 명시해 범위를 최신으로 유지하세요.
- 시간대를 확인하세요. 예약 및 일회성 자동화는 명시적 시간대를 저장합니다. 저장 전에 표시된 값을 확인하세요.
- 휴가 전에 일시중지하세요. 특히 나에게 DM을 보내는 자동화는 짧은 DM 14개를 받고 돌아오는 것이 유용하지 않습니다. 자동화를 비활성화했다가 돌아오면 다시 활성화하세요. 워크플로는 그대로 유지됩니다.
비용과 볼륨
자동화 발화는 일반 Run을 시작하며 모델 경로와 사용하는 서비스에 따라 크레딧을 소비할 수 있습니다. 비용을 추정할 때 자동화 채팅과 Billing을 검토하세요.
짧은 간격은 빠르게 늘어납니다. 15분 간격은 각 Run이 다음 간격 전에 끝나면 하루 최대 96회 실행될 수 있습니다. 넓은 이벤트 필터도 그만큼 시끄러울 수 있습니다. 좁게 시작해 처음 몇 번의 발화를 검사한 다음 필터나 주기를 의도적으로 넓히세요.
워크플로나 기록을 삭제하지 않고 새 발화를 멈추고 싶다면 자동화를 비활성화하세요.
다음
- 자동화가 실행하는 절차는 Workflows 참조.
- 각 Run 안에서 일어나는 일은 Chat 참조.
- 워크플로와 자동화 조합 다섯 가지는 Example workflows 참조.