オートメーションとは、ワークフローに付けられたトリガーです。ワークフローは「何をするか」を定め、オートメーションは「いつ別の実行を開始するか」を定めます。
オートメーションは次を使用します:
- ワークフロー — 現在の手順付き
- 所有者 — そのオートメーションのチャットと接続済みアクセスが使われる
- トリガー — スケジュール、接続済みサービスからのイベント、または受信 Webhook など
毎回実行される内容
各発火は、そのワークフローと所有者のオートメーションチャット内で新しい run を開始します。発火のたびにまったく新しいチャットが作成されるわけではありません。同じメンバーが同じワークフローに対して持つオートメーションは、そのオートメーションチャットを再利用します。
run は、ワークフローの現在の指示とトリガーのペイロードを使用します。チャットは再利用されるため、以前の run はそのスレッド履歴に残ります。タスクをステートレスに動作させる必要がある場合は、ワークフローの指示にそう記載し、現在のイベントまたは明示的な時間範囲のみを使うよう指示してください。
モデルはエージェントやワークフローではなく、オートメーションチャットのスレッドで選択されます。オートメーションチャットが最初に作成されるとき、そのモデルはメンバーの既定値から始まり、次にワークスペースの既定値になります。その後の発火では、そのスレッドで選択されたモデルが再利用されます。
オートメーションチャットを開くと、その run、出力、表示可能なエラーを確認できます。失敗した発火もそこに残るため、ワークフロー、コネクタのアクセス、またはトリガーを修正して再実行できます。
トリガー リファレンス
ワークフロー上のオートメーション ピッカーは、現在のワークスペースで作成可能な内容の基準です。一部のイベント型はワークスペースの機能スイッチの背後で提供されているため、どこでも表示されるとは限りません。
スケジュール
| 種類 | 動作 |
|---|---|
| Scheduled | cron スケジュールと IANA タイムゾーンを使用して、実際の時刻に基づいて実行されます。 |
| Interval | 実行が完了した後、設定された間隔だけ待機してから次の実行をスケジュールします。実行同士が重複することはありません。 |
| Once | 選択した日時に実行され、その後は自動的に無効になります。 |
保存する前に、オートメーションに表示されているタイムゾーンを確認してください。壁時計時刻ベースの実行には Scheduled オートメーションを、完了後の間隔が重要なポーリングには Interval オートメーションを使ってください。
Gmail
| イベント | フィルター |
|---|---|
| New message | From、To、Cc、Subject、本文テキストの各マッチャーを任意で指定できます。マッチャーがなければ、新着メッセージはすべて対象になります。 |
| Label applied | Gmail ラベル名を 1 つ。 |
忙しい受信トレイで予期しない数の run が発生しないよう、まずは範囲の狭い新着メッセージ フィルターから始めてください。
GitHub
GitHub のイベントには、Okou の GitHub App を GitHub organization にインストールする必要があります。インストールされていない場合は、オートメーション設定画面にその旨が表示されます。organization 管理者にはそこに Install GitHub App ボタンが表示され、それ以外の人には管理者に依頼するよう案内されます。1 回インストールすれば、以下の GitHub トリガーがすべて利用可能になります。
| イベント | 共通フィルター |
|---|---|
| Pull request | リポジトリ 1 つとアクション 1 つ: opened、reopened、closed、ready for review、converted to draft、synchronized、merge queue に追加または削除、labeled、unlabeled。ベースブランチ、作成者、PR 番号、ラベルで絞り込めます。closed では、マージせずに merged と closed を区別できます。 |
| Workflow run completed | リポジトリ、ワークフロー、結論、ブランチ、トリガーイベント、実行者。 |
| Workflow job completed | リポジトリ、ワークフロー、ジョブ、結論、ブランチ、runner ラベル、runner グループ。 |
| Pull request review submitted | リポジトリ、レビュー状態、ベースブランチ、ヘッドブランチ、信頼済み作成者。 |
| Deployment status created | リポジトリ、環境、状態、ref、作成者、アプリ、production 環境フラグ。 |
| Issue or pull-request comment created | リポジトリ、issue/PR の範囲、信頼済み作成者、コメント接頭辞。 |
別個の GitHub label applied イベントはありません。PR のラベルに反応するには、Pull request を選び、Labeled アクションを選択し、label フィルターを追加します。
Google Calendar と Meet
- Calendar event created、updated、または cancelled — 選択した calendar ID にスコープされます
- Google Meet transcript generated — 接続済みメンバーが主催した会議向け
Chat とその他の統合
- Chat run finished は、あなたのチャット スレッドのいずれかを監視します。完了、失敗、またはキャンセル済みのステータスで絞り込みでき、完了した run については、最終返信に対して大文字小文字を区別しない
*ワイルドカード一致を使用できます。 - Webhook received は署名付きの受信 URL を作成し、ワークスペース プランに webhook オートメーションが含まれている場合に利用できます。
- Google Forms response submitted、Notion page/database events、Strapi entry published、および Stripe invoice paid は、これらのオートメーション機能が有効なワークスペースにのみ表示されます。
イベント オートメーションには、関連するコネクタまたは統合が接続済みで、オートメーション所有者に対して使用可能であることも必要です。
オートメーション メッセージは何が起きたかを平易な言葉で説明し、chat run finished トリガーで開始された run は元のスレッドに戻ります。
オートメーションの作成
動作するチャットから。 まずは 1 回限りでタスクを実行します。期待どおりの結果になったら、次のように伝えます:
「これを毎週平日、ロサンゼルス時間の8 a.m. に実行して、結果を DM してください。」
Okou はワークフロー、実行頻度、送信先を確認し、まだ存在しない場合はワークフローを保存して、オートメーションを追加します。
明示的に。 ワークスペースでワークフローを開き、Add automation をクリックして、トリガーの種類とそのフィルターを選びます。事前に形が分かっていて、ドライランをしたくない場合に有用です。
手順はワークフローから取得されます。My Okou では、実行はそのワークスペースにおけるオートメーション所有者の個人用の指示（Instructions）、メモリー、接続済みアカウント、権限を使用します。Legacy Agents では、所有エージェントがエージェント コンテキストを提供します。スケジュール トリガーは、いつ実行するかと、どのタイムゾーンで実行するかを尋ねます。
公開ワークフローは手順を共有しますが、作成者の自動化やアクセスまでは共有しません。各メンバーは自分の自動化を作成・管理します。ワークフローをコピーしても、他のメンバーのトリガー、認証情報、またはオートメーションチャットが引き継がれるとは想定しないでください。
オートメーションは個別に 有効化・無効化 でき、削除する必要はありません。休暇前や、うるさいトリガーをデバッグしている間に取るべき適切な対応です。
送信先
オートメーションは結果の送信先を知る必要があります。ワークフローの指示に明記してください:
- Slack チャンネルまたは DM — 最も一般的。メッセージまたはスレッドとしてチャンネルに届きます
- Feishu または Microsoft Teams — そこを拠点にしているチーム向けの同様の使い方
- Telegram またはテキストメッセージ — 個人向け、モバイルファーストの通知用
- Notion のページまたはデータベース — ブロードキャストではなくアーカイブしたいもの向け
- Google ドキュメントまたはスプレッドシート — 追記または上書き
- GitHub issue または PR コメント — エンジニアリング ワークフロー向け
- Gmail の下書き — 確認して送信するためにあなたのアカウントに下書きとして作成されます
- ホスト済みページ — ホスティングされたサイト を参照
- ワークスペース ファイル — 成果物が動画、画像、またはダウンロード可能なアセットの場合
「#engineering に投稿」 または 「DM してください」 のほうが、「どこかに送って」 よりも明確です。
運用のヒント
これらは本番でオートメーションを運用して得られた知見です:
- 最初の 3 回の run を確認する。 オートメーションの設定は簡単ですが、実際に Okou があなたの環境で何を生成するかを見てからのほうが、より簡単に調整できます。
- 各タスクを小さく保つ。 長くて多段階のオートメーションは壊れやすくなります。1 つで 5 つのシステムを更新しなければならないなら、2 つに分けることを検討してください。
- 送信先を固定する。 チャンネルの名前は変わり、人は退職します。ワークフローの指示で送信先を明示的に指定してください。次回 run 時に見つからなければ、Okou は警告します。
- 長時間実行クエリは時間範囲を明確にする。 プロンプトが「過去 30 日」と指示する場合、その範囲が常に最新になるよう、毎回の run で言い直してください。
- タイムゾーンを確認する。 Scheduled および Once のオートメーションは、明示的なタイムゾーンを保存します。保存前に表示されている値を確認してください。
- 休暇前に一時停止する。 特に DM を送るオートメーションでは重要です。14 件もの短い DM が届いても、戻ってきたときには役に立ちません。オートメーションを無効化し、戻ったら再度有効化してください。ワークフロー自体はそのまま維持されます。
コストと件数
オートメーションの発火は通常の run を開始し、使用するモデルルートやサービスに応じてクレジットを消費する場合があります。コストを見積もる際は、オートメーションチャットと Billing を確認してください。
短い間隔はすぐに件数が増えます。15 分の interval は、各 run が次の interval が経過する前に完了すれば、1 日に最大 96 回実行される可能性があります。広いイベント フィルターも同様にノイズが多くなりがちです。最初は狭く始め、最初の数回の発火を確認してから、意図的にフィルターや cadence を広げてください。
ワークフローや履歴を削除せずに新しい発火を止めたいときは、オートメーションを無効化してください。
