メインコンテンツまでスキップ

起動ガイド

いつ、何をきっかけに動かし、どう止めるかを決めるための選択肢と基準を扱います。

起動のしかたは型で違います。 型そのものの選び方は設計ガイド、サイクルとワークフローの動きの違いはサイクルとワークフローにあります。

画面上の場所がある節では、そこで決めたことをどこで設定・確認するかを終わりに書いてあります。

型ごとに使えるもの​

ワークフローサイクル
手動で始めるできます(プロジェクトの参加者(オーナー・運用担当・メンバー)と組織の運用の役割の人)できません
決めた時刻に始める時間トリガーをプロジェクトに付けます。最初の有効な工程の時刻でも始まります巡回の周期を配置ごとに決めます
外部から始める外部 API で実行を始めます(登録は不要)外部 API で Webhook トリガーを呼びます(先に登録)
メールで始めるプロジェクトの宛先へのメールで実行を始めます(メールの機能が有効な環境)プロジェクトの宛先へのメールで、選んだ配置が動きます(メールの機能が有効な環境)
工程ごとの時刻使えます使えません(周期は配置ごと)

単位が違うことに注意してください。 ワークフローの時間トリガーはプロジェクトに付けますが、サイクルの周期は配置(Agent を工程に置いたもの)ごとです。ワークフローは時間トリガーが無くても構いません(プロジェクトの参加者(オーナー・運用担当・メンバー)と組織の運用の役割の人が手動で始められます)。

自動の起動を作る・有効にするには​

決めた時刻・Webhook・巡回・メールで自動で始まる起動を作る・有効にするには、管理者が機能の許可で「定期実行の作成」を許している必要があります。 許されていない人は、次の操作を断られます: トリガー(時間・Webhook)を作る・有効にする、「メールで起動」を有効にする、工程の時刻(ワークフロー)を入れる・変える、巡回を有効にする・有効な巡回の周期を変える、これらを含む定義をファイルから取り込む・社内のひな形から作る。すでにある起動は止まりません。 止める・外す操作、工程の時刻を同じ値のまま保存する操作、有効なトリガー・「メールで起動」の設定を有効なまま変える操作は、許可が無くてもできます。有効な巡回の周期を変えるのは断られます。

自動で動くものは、プロジェクトの区画の上部の「自動実行」に一覧で並びます。 個人のスケジュール・Claw・Mail と、参加しているプロジェクトのトリガー・先頭の工程の時刻・巡回が、種類・所属・状態・次の起動とともに出ます。工程の時刻は、ワークフローの最初の有効な工程の 1 つだけが並びます(その工程に時刻が無ければ出ません)。有効な時間トリガーがあるプロジェクトでは、その時刻では始まらないので「無効」と出ます。作る・変える・止めるは、名前から開く各画面で行います。「スケジュール」の画面の見出しの横の「すべての自動実行」からも開けます。

画面上の場所 許可は管理コンソールの「接続先と使える範囲」>「機能の許可」の「定期実行の作成」(システム管理者)。一覧はプロジェクトの区画の上部の「自動実行」

ワークフローを始める​

ワークフローは手動が基本です。 決めた時刻に始めたいときだけ、時間トリガーを足してください。

手動で実行できるのは、プロジェクトの参加者(オーナー・運用担当・メンバー)と組織の運用の役割の人です(誰が何を決められるか)。メールで起動を使っていれば、同じ人がメールでも始められます(メールで起動する)。

時間で始める方法は 2 つあります。 1 つは時間トリガーを追加すること、もう 1 つは最初の有効な工程に時刻を持たせることです(後の節)。有効な時間トリガーがあれば、そちらが開始を決めます。

時間トリガーを追加するときに決めるのは次の 2 つです。 定義の変更に承認を要るテナントでは、時間トリガーの追加・変更・削除も承認されたあとから使われます(下書きを確かめて反映する)。

  • いつ動かすか — 毎時・毎日・平日・毎週などから選べます(毎週は曜日を複数選べます)。細かく指定したいときは cron 式も使えます
  • 開始する工程 — どの工程から始めるかを選べます。指定しなければ最初の有効な工程から始まります。並列のレーンがあるときは並列に進んだ後の工程から、条件分岐があるときはそのレーンの中の工程からは始められません

時間トリガーは複数付けられます。 平日の朝と週末の夜で別の工程から始める、といった使い方ができます。1 つずつ有効・無効にできるので、止めたいものだけ止められます。

時間トリガーを削除するときは確認が出ます。 削除すると、そのトリガーによる自動の開始は止まりますが、実行中の実行は止まりません。削除は元に戻せないので、止めるだけなら、一覧のスイッチをオフにします。

画面上の場所 設定 タブ >「トリガーと通知」>「時間トリガーを追加」。「開始する工程」も同じ場所で選びます

サイクルを回す​

サイクルは、配置ごとの周期で動きます。 プロジェクト全体の時間トリガーではありません。

同じ工程に置いた配置どうしでも、周期を別にできます。 「見つける」工程にメール担当とフォーム担当を置いて、片方だけ短い間隔で回すといった形が作れます。周期を変えたいから工程を分ける必要はありません。

1 つずつ止められます。 「巡回を有効にする」をオフにすれば、その配置は周期では動かなくなります(周期の設定は残ります)。ほかの配置は動き続けます。 ただし止まるのは周期による巡回だけで、同じ配置に有効な Webhook トリガーがあるか、メールで起動の配置に選んでいれば、そちらからは動きます。今後の新しい起動をすべて止めたいなら、Webhook トリガーとメールで起動も無効にしてください。すでに受け付けた分は取り消されません。

工程を無効にすると、その工程に置いた配置は、新しい起動を受け付けません。 巡回は止まり、Webhook トリガー・メールで起動・失敗した巡回の再実行は断られます。無効にする前に受け付けた分は、取り消されません。工程を有効に戻すと、巡回を有効にしていた配置は、保存してある周期で巡回に戻ります(プロジェクトの一時停止など、ほかの理由で止まっているときは、それが解けてから)。

段階を分けたなら、起動時刻をずらしてください。 同じ時刻にすると、前の段階の結果がまだ無いうちに動いて空振りすることがあります。ただし時刻をずらしても、前の段階が終わっていることは保証されません(設計ガイド)。

実行しない時間帯と曜日も決められます。 夜間や休日には巡回させたくない、といったときに使います。周期の選び方が「周期」か「毎時」のときに、「実行しない時間帯・曜日」が出ます。時間帯は正時で、開始と終了(再開する時刻)を選びます。曜日は、選んだ曜日には実行しません(全部の曜日は選べません)。周期の欄には「次回: …」と次に動く予定が出るので、意図どおりかを確かめてください。概要の「プロジェクト情報」の「すべて表示」で開く起動の欄にも、次回が出ます。

画面上の場所 編集 > 中央の図で対象の工程に置かれた Agent を選び、右の「工程のAgent」>「起動条件」>「巡回の周期」の「巡回を有効にする」。止めるときは同じ場所でオフにします。実行しない時間帯は、同じ場所の「実行しない時間帯・曜日」

工程ごとの時刻(ワークフロー)​

ワークフローでは、Agent を置く工程に動く時刻を持たせられます。 確認工程は、前の工程が終わると始まります。選ぶのは 2 つです。

  • 前の工程の完了後すぐ — 既定です。前の工程が終わり次第動きます
  • 所定の時刻に — その時刻まで待ってから動きます

決めた時刻まで開始を待たせたいときに使います。 夜間にまとめて処理したい、といった場合です。動き始めたあとの時間は制限しません。

サイクルにはこの設定がありません。 サイクルで時刻を決めるのは、前の節の巡回の周期です。

最初の有効な工程の時刻は、実行の開始時刻になります(有効な時間トリガーが無いとき)。つまり、そこに時刻を置くだけでも、時間で始められます。 有効な時間トリガーがあれば、そちらが開始を決めます。

外部から動かす​

どちらの型も、外部 API から動かせます。 違うのは先に登録が要るかです。

ワークフローは、登録なしで実行を始められます。 外部 API のアクセストークンと Idempotency-Key ヘッダーを付けて実行開始を呼ぶと実行が始まり、記録には「外部API実行」として残ります。同じ Idempotency-Key で再送すると同じ実行が返り、二重に始まりません。 実行状況の取得では、実行の状態と始まり・終わりの時刻に加えて、工程ごとの状態と Agent の出力の要約も返ります(外部 API のドキュメント)。結果の届け先の決め方は設計ガイドにあります。

サイクルは、先に Webhook トリガーを登録します。 起動する配置(Agent と工程の組み合わせ)を対応付けて登録し、そのトリガーを外部 API から呼び出すと、その配置が動きます。登録するには、その Agent が先にその工程へ置かれている必要があります。

Webhook トリガーを削除するときは確認が出ます。 削除は元に戻せず、作り直すと呼び出し先が変わって、呼び出す側の設定も直すことになります。止めるだけなら、一覧のスイッチをオフにします。

外部 API の呼び出しそのものは、画面からはできません。 画面でできるのは、Webhook トリガーの登録・変更・削除と、呼び出し方(パス・ヘッダ・本文・例)を確かめてコピーすることまでです(ワークフローを画面から動かしたいときは、手動実行を使います)。

サイクルでは、呼び出しがまとまって 1 回の実行になることがあります。 まだ動き始めていない呼び出しがあると、あとから届いた分がそこに合わさることがあります。呼び出しの回数と実行の回数が同じとは考えないでください。 呼び出しで返る ID では、実行状況を取得できません。識別子と再送の扱いは外部 API のドキュメントにあります。

画面上の場所 サイクルは 設定 タブ >「トリガーと通知」>「Webhookトリガーを追加」>「起動する配置」で Agent と工程を選びます。登録したトリガーの行に、呼び出し方(パス・ヘッダ・本文・例)が出ます。ワークフローは 設定 タブ >「トリガーと通知」の「外部APIから開始」に、呼び出し方が出ます

メールで起動する​

メールの機能が有効な環境で使えます。 プロジェクトに宛先を 1 つ用意し、そこへ届いたメールで動かします。

  • ワークフロー — メール 1 通で、最初の有効な工程から 1 回実行を始めます。件名・本文・添付ファイルがワークフローに渡ります
  • サイクル — 先に起動する配置(Agent と工程の組み合わせ)を 1 つ選びます。メール 1 通ごとに、その配置が 1 回動き、件名・本文・添付ファイルがその配置の Agent に渡ります。配置が動いている間に届いた分は、終わってから動きます。選んだ配置をあとで外すと、選び直すまでメールでは動きません

設定はオーナーだけです。 有効にすると宛先ができ、メンバーにも宛先が見えます。止めるときは無効にします(宛先は変わりません)。

送れるのは、このプロジェクトの参加者(オーナー・運用担当・メンバー)と、組織の運用の役割の人が、登録メールアドレスから送ったメールです。 手動で実行できる人と同じです。プロジェクトから外れると(組織の運用の役割も無ければ)、そのアドレスからのメールでは始まりません。メールは送信元の認証(DMARC)に合格している必要があります。

ほかの人からのメールで動かしたいときは、オーナーがそのアドレスを許可します(20 件まで)。アドレス全体を 1 件ずつ登録し、ドメインやワイルドカードでは許可できません。許可したアドレスからのメールは、DMARC に合格したときだけ外部の送信者として扱われます。

件名と本文は、送った人にかかわらず、Agent への指示ではなく外部からのデータとして渡ります。 人の確認は自動では足されないので、ワークフローで要るなら確認工程を置いてください(確認ガイド)。

本文は 20,000 文字まで、添付ファイルは 10 件まで(1 件 10 MiB まで、合わせて 20 MiB まで)です。 実行形式・スクリプト・マクロ付きの Office などのファイルは受け付けません。上限を超えた添付ファイルと受け付けない添付ファイルは外して、メールの処理を続けます(外したことは知らせません)。 受け付けた添付ファイルは、送った人ではなく、プロジェクトの持ち主の「ライブラリ」に保存されて、実行に渡ります。件名は先頭の 998 文字までが渡ります。Message-ID の無いメールと、迷惑メールやウイルスと判定されたメールは受け付けません。同じメール(同じ Message-ID)が重ねて届いても、新しく始まりません。

同じ 1 通を、プロジェクトの宛先と、製品のほかの宛先(自分の AI にメールで頼む個人の宛先など)に同時に送ると、製品の側では片方の宛先でしか受け付けられません。 もう片方は、同じメールが重ねて届いたものとして扱われ、何も起きません(受付の返信も届きません)。社外の宛先など、製品の外の宛先には関係ありません。どちらの宛先で受け付けられるかは、届き方によって変わります。両方に届けたいときは、別々のメールとして送ってください。

受け付けると、送った人に受付の返信が届きます。 これは実行がうまくいったことを示すものではありません。参加者(オーナー・運用担当・メンバー)と組織の運用の役割の人への返信にはリンクが付きます(ワークフローはその実行記録、サイクルは選んだ配置の Agent で絞った実行履歴)。外部の送信者への返信には、リンクもプロジェクト名も付きません。

メールで起動を無効にしている間、プロジェクトを一時停止している間、サイクルで選んだ配置が外れている間・その配置の工程が無効の間に届いたメールは、断られます。管理者がプロジェクトか、起動する配置の Agent を停止している間、実行する利用者のアカウントが停止されている間に届いたメールも、同じく断られます。 あとから動くことはないので、設定を戻したあとで送り直してください(同時に進められる数に達していたときは、送り直されます=同時に進められる数)。断ったメールは、下の「受け付けなかったメール」で確かめられます。

受け付けなかったメールは、「メールで起動」の欄の「受け付けなかったメール」で確かめられます。 直近 30 日に断ったメールを、新しい順に 5 件まで、日時・理由・送信元のドメインと直し方で出します。同じ理由のメールは、1 時間に 1 件にまとめます(知らせを送る相手は同じアドレスごと、それ以外は同じ送信元のドメインごと)。件名と本文は残らず、送信元はドメインだけが出ます。この一覧が出るのは、オーナー・運用担当と、組織の運用の役割を持つ参加者です(組織の運用の役割を持たないメンバーには出ません)。送信元の認証(DMARC・DKIM・SPF)のどれにも合格しないメール、迷惑メール・ウイルスと判定されたメール、Message-ID の無いメールは、プロジェクトに届く前に落ちるので、ここには出ません。

記録 (証跡) にも「メールでの起動を拒否」として、理由と送信元のドメインが残ります(記録リファレンス)。記録は、メンバーも見られます。

送った人が、送信元の認証(DMARC)に合格した、このプロジェクトの参加者・組織の運用の役割の人・「許可するメールアドレス」に登録したアドレスのときは、受け付けなかったことを知らせるメールをその人に送ります(同じアドレスに同じ理由では 1 時間に 1 通まで)。記録や送信に失敗しても断りには影響せず、知らせは送り直しません。「許可するメールアドレス」に登録したアドレスへの知らせには、プロジェクト名とリンクは付きません。DMARC に合格しないメール、参加者でも「許可するメールアドレス」に登録したアドレスでもない送信元のメール、同じメール(同じ Message-ID)を内容を変えて送り直したメールには、何も返りません。

「受け付けなかったメール」の理由と直し方は、次のとおりです。

一覧の理由直し方
送信ドメイン認証(DMARC)に不合格送信元のドメインに DMARC のレコードを設定するか、DMARC に合格するアドレスから送る
起動できない送信元このプロジェクトの参加者と組織の運用の役割の人の登録メールアドレスか、「許可するメールアドレス」に登録したアドレスから送る
同じアドレスの利用者が複数管理者にアドレスの重複を直すよう依頼する
メールでの起動が無効オーナーがメールで起動を有効にしてから送り直す
本文が上限を超過本文を 20,000 文字までにして送り直す
添付の照合に失敗添付し直して送り直す
起動する配置なし(サイクル)起動する配置を選び直す
同じメールを内容を変更して再送新しいメールとして送る
プロジェクトが停止中・管理者が停止・実行する利用者のアカウントが停止されています再開してから送り直す(管理者が停止したときは管理者が再開)。実行する利用者のアカウントが停止されているときは、管理者に持ち主を変更するよう依頼する
確認担当者が未指定の工程があります有効な確認工程に、今の参加者から確認担当者を指定して送り直す
この実行基盤では開始できませんオーナーに配置を確かめてもらう
並列に進んだ後の工程からは開始できません・条件分岐のレーンの中の工程からは開始できませんオーナーが、最初の有効な工程を並列・条件分岐のレーンの外にする
そのほかの理由(コード)出たコードを、外部 API の実行の開始の誤りの表で引き、その直し方に従う

ワークフローの記録では、トリガーの列に「メールで起動」と出ます。実行記録の依頼には「送信した人:」と出て、外部の送信者には「外部([EXT])」が付きます。サイクルでメールで動いた巡回は、トリガーの列に「巡回」と出て、オーナー・運用担当・メンバーが送ったときの依頼は「設定した人:」と出ます。

画面上の場所 設定 タブ >「トリガーと通知」>「メールで起動」(サイクルは、起動する配置も同じ場所で選びます)。外部の送信元は同じ欄の「登録送信元(From)」の「許可するメールアドレス」。受け付けなかったメールは同じ欄の「受け付けなかったメール」

同時に進められる数(ワークフロー)​

ワークフローには、同時に進められる実行の数に上限があります。 上限と、何を数えるかは設定値リファレンスにあります。

上限に達しているときに新しく始めようとすると、次のようになります。

  • 手動 — 断られます
  • 外部 API — 断られます(応答は外部 API のドキュメント)
  • メール — その場では始まりません。メールの受け付けが時間をおいて送り直すので、その間に空きができれば始まります
  • 決めた時刻(時間トリガーと、最初の有効な工程の時刻) — その回は見送られ、あとから取り戻されません。 実行履歴にも残りません

確認が滞ると、新しい依頼が始まらなくなります。 期限と担当者の決め方は確認ガイドにあります。外部 API から始めるなら、断られた依頼を呼び出す側で持っておき、あとで送り直す仕組みが要ります。

時刻の指定とタイムゾーン​

時刻の指定には、選ぶだけで済む形が用意されています。 毎時・毎日・平日・毎週・周期(○分ごと)から選べます。cron 式を書く必要はありません。

細かく指定したいときは、カスタム (cron) を選びます。 式の書き方と、指定できる刻みの制約は設定値リファレンスにあります。

タイムゾーンは必ず選びます。 保存する前に、意図したタイムゾーンかを確かめてください。海外拠点の業務時間に合わせたいときは、ここで指定します。

ワークフローの時間トリガーには、次にいつ動くかが表示されます。 プロジェクトを止めているときと、その時間トリガーを無効にしているときは出ません。前回の時刻も出ます。これはその時間トリガーで実行を始められた時刻で、止めていたときや、同時に進められる数に達していて見送った回では進みません。

決めた時刻に始められなかったときは、その時間トリガーの行に「◯から開始できていません(理由)」と出ます。 有効な時間トリガーが無く、最初の有効な工程の時刻で始めているときは、「先頭の工程の時刻」の行に出ます。理由は「確認担当者が未指定の工程があります」「並列に進んだ後の工程からは開始できません」「入力ファイルが不足しています」などです。次に始められると消えます。 同時に進められる数に達していた回と、プロジェクトを一時停止していた回、管理者が停止していた回は、ここには出ません(意図した見送りのため)。記録 (証跡) には「時間トリガーで開始できず」として残ります。

画面上の場所 時刻を決める画面はいずれも同じ形で、プリセットと「タイムゾーン」を選びます。時間トリガー=設定 タブ >「トリガーと通知」/工程の時刻=編集 > 中央の図で工程を選び、右の「工程の設定」>「起動条件」/巡回の周期=編集 > 中央の図で Agent を選び、右の「工程のAgent」>「起動条件」>「巡回の周期」

止める・再開する​

止め方は、何を止めたいかで違います。 管理者がプロジェクトを停止したときは「管理者が停止」と出て、再開できるのは管理者だけです。

  • 新しく始まる実行をすべて止める — プロジェクトを一時停止します。手動・決めた時刻・外部 API・巡回・Webhook・メールのどれでも、新しい実行は始まりません。進行中のワークフローの実行は、次の Agent を起動せずに待ちます(今動いている Agent は止まらず、確認待ちの確認依頼もそのまま残ります)。再開すれば、また始まり、待っていた実行は続きから進みます
  • 動いているワークフローの実行を止める — その実行を中断します。後の工程には進まず、確認待ちの確認依頼は取り消されます。すでに動いている Agent には停止が送られます(その結果は使われません)
  • サイクルの一部の配置だけ止める — サイクルを回す
  • 決めた時刻の開始だけ止める(ワークフロー) — 時間トリガーを無効にし、最初の有効な工程の時刻も外します(工程ごとの時刻)

管理者が Agent を止めたときは、その Agent を置いた工程も動きません。 その Agent の配置の巡回は止まり、ワークフローではその Agent の工程が起動せずに保留になります。その配置にメールが届いても断られます(「管理者が停止」)。管理者が Agent を再開すると、動いているプロジェクトの巡回は戻り、保留の工程は続きから進みます。

ワークフロー履歴の「再開する」は、これとは別のものです。 却下か失敗で閉じた実行を、選んだ工程から続ける操作です(確認ガイド)。プロジェクトの一時停止を解くのは、プロジェクトの画面の上部の「再開」です。

プロジェクトを使わなくなったときは、削除します。 削除できるのはオーナーです。工程と Agent の配置は削除され、元に戻せません。動いている実行と判断を待っている確認依頼は取り消され、巡回とトリガーは止まり、プロジェクトの連携先との接続は解除されます。実行記録と監査の記録は残ります。 保全中のプロジェクトと、管理者が停止しているプロジェクトは削除できません。持ち主がいなくなるときは、削除せずに持ち主を変更することもできます(実行は、プロジェクトの持ち主の名前で動く)。

画面上の場所 プロジェクトの画面の上部の「一時停止」(再開は同じ場所の「再開」。オーナー・運用担当と組織の運用の役割の人に出ます。管理者が停止したプロジェクトは、どの役割も再開できません)。実行の中断は「ワークフロー履歴」タブ > 動いている実行の「中断する」(オーナー・運用担当と組織の運用の役割の人に出ます。メンバーには、自分が始めた実行にだけ出ます)。削除はプロジェクトの画面の上部の「プロジェクトの操作」>「プロジェクトを削除する」(オーナーに出ます)

取り違えやすいところ​

ここまでの節をまたいで、区別しておく点をまとめます。

  • 作れば動き始めると思う。 AI(α版)に作らせても、ほかのプロジェクトからコピーしても、時間トリガーは無効の状態で来ます。AI に作らせたサイクルで周期が提案されていれば、プロジェクトは一時停止の状態で来ます(再開すると巡回が始まります。「定期実行の作成」を許されていない人が作ったときは、巡回は無効で来て、再開しても始まりません)。コピーでは開始する工程が未指定に戻り(=最初の有効な工程から始まります)、ワークフローの工程ごとの時刻と、サイクルの巡回の周期・Webhook トリガー、メールで起動の設定は引き継がれません。有効にする前に、どこから始まるかを確かめてください
  • サイクルを手動で動かそうとする。 サイクルに手動実行はありません。配置ごとの周期、Webhook、またはメールで動きます。すぐ試したいなら、周期を短くして有効にしてください
  • プロジェクトの時間トリガーと、工程の時刻を混同する。 時間トリガーはいつ実行を始めるか、工程の時刻はその工程がいつ動くかです。サイクルには時間トリガーがありません(周期は配置ごと)
  • 外部から動かす方法が型で別物だと思う。 どちらも外部 API から動かします。 違うのは、ワークフローは登録なしで実行を始められるのに対し、サイクルは先に Webhook トリガーを登録することです。外部 API の呼び出しは画面からはできません
  • メンバーは見るだけだと思う。 メンバーも、手動・外部 API・メールで実行を始められ、自分が始めた実行は中断できます。 ほかの人が始めた実行の中断と、再開・締め切り・確認担当者の付け替え・一時停止は、オーナー・運用担当と組織の運用の役割の人です
  • 決めた時刻には必ず始まると思う。 同時に進められる数に達していると、その回は見送られ、取り戻されません(ワークフロー)
  • 一時停止すれば、動いている実行も止まると思う。 止まるのは、新しく始まる実行と、進行中のワークフローの次の Agent の起動です。 今動いている Agent は止まりません。止めたいときは、その実行を中断します(動いている Agent に停止が送られます)

次に読むもの​