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

設計ガイド

プロジェクトを 1 つ作るということは、業務の進め方を 1 つ決めることです。このガイドでは、業務として何を決め、それをどう工程に分け、それぞれの工程に何を任せるかを決めるための選択肢と基準を扱います。

工程や Agent が何なのかはプロジェクトと工程にあります。先に読んでおくと、ここでの判断が速くなります。

画面上の場所がある節では、そこで決めたことをどこで設定・確認するかを終わりに書いてあります。工程と Agent の設定は、プロジェクトの画面の上部にある 編集 から開く画面で行います(オーナーだけに出ます)。この画面は、左に「編集ツール」(工程や Agent の追加)と一覧(Agent/工程)、中央に全体の図(「編集キャンバス」)、右に選んだものの設定(「プロパティ」)が並びます。以下の「画面上の場所」で「編集 > …」と書いてあるのは、この画面のことです。中央の図は「表示の大きさ」で縮められ、空いている所をマウスで押したまま動かすと、見る場所を動かせます。

業務として決めること​

型・工程・Agent を決める前に、業務として 4 つを決めます。

  • どこまで任せるか。 手がかりは 3 つです。間違えたときに戻せるか——戻せない操作(外部への書き込みなど)の前には、確認工程を置くか、実行ルールで禁じます(確認ガイド)。連携先を使う前に人に確かめさせるなら、連携先に「接続時の確認」を設定します(連携ガイド)。判断の基準を文章にできるか——Agent に判断させる基準は、ゴールや Skill に書きます。文章にできない判断は人に残します。必要な情報に手が届くか——要る情報とつなぐ先を洗い出し、使えるかを作り始める前に確かめます(連携ガイド)
  • 何ができたら終わりか。 業務としての終わりを先に決め、各 Agent のゴール(後の節)と、確認担当者が進めるかを決める基準に落とします。実行の結果の読み方は記録と指標にあります
  • どこでプロジェクトを分けるか。 見せてよい相手、使う認証、許す操作、混ぜたくないプロジェクトの記憶のどれかが違う業務は、プロジェクトを分けます。ただし、同じ組織のプロジェクトは、分けても、その組織で組織の運用の役割を持つ人からは定義と状態が見えます(実行の出力とファイルは見えません)。何がプロジェクトごとに決まるかはプロジェクトと工程にあります
  • 結果をどこへ届けるか。 人が受け取るなら、ワークフローの最後に確認工程を置きます(確認ガイド)。業務のシステムに戻すなら、書き先を連携先に加え、何をどこへどう書くかを Agent のゴールに書きます。外部 API で始める場合も同じです(起動ガイド)

申請処理なら、「内容を確かめる」は任せ、「登録して返す」の前で人が承認します。終わりは「記載と添付がそろい、要件に合うことが確かめられ、登録されて申請者に結果が返っている」です。申請を受け付けるシステムが部署ごとに違うなら、プロジェクトを分けます。

型を選ぶ​

最初に決めるのは型です。後から変えられません。

サイクルワークフロー
終わり方開始も終了もなく、続く開始から終了へ、工程を順に進む
動き方配置ごとに、それぞれの周期で動く1 件の実行が工程を順に進む
始め方配置ごとの周期、Webhook、またはメール手動、時間、API、またはメール

基準は「終わりがあるか」です。

1 件ごとに始まって終わるなら、ワークフローです。始まりと終わりがあるので、1 件ごとに結果を追えます。確認工程で実行そのものを確実に止められるのも、ワークフローだけです(サイクルは対象ごとに保留します)。

終わりがなく、動き続けるならサイクルです。配置がそれぞれの周期で動き、全体の始まりも終わりもありません。

どちらが向くかは、入口の「向く仕事の例」も合わせて見てください。

型によって、このあとの節のうち効くものが変わります。工程を順に進める前提の設定(うまくいかなかったときの動き)はワークフローだけのものです。

画面上の場所 プロジェクトを作るとき > 種別

工程に分ける​

工程の分け方は、型によって考え方から違います。

ワークフローサイクル
向く仕事1 件を受けて、決まった順に処理して仕上げる対象を自分で探し続け、必要な仕事をする
進み方工程の並びが順序。前の工程が終わってから次へ進む配置がそれぞれの周期で独立に動く。並びは順序にならない
段階のつなぎ方基盤が受け渡す共通の記録に残した状態で、次が拾う
人の判断1 件の実行そのものを、確認工程で確実に止める対象ごとに保留する。ほかの巡回は続く

「自分で作る」では、種別・名前・タグを入れて作ります。 工程と Agent は、作成後のエディタで設定します。

工程を指定せずにプロジェクトを作ると、ワークフローでは 実行 → 人の確認 → 実行、サイクルでは 実行 → 実行 が用意されます。サイクルに確認工程は置けないためです。AI(α版)に下書きを作らせた場合や、ほかのプロジェクトからコピーした場合は、その内容の工程になります。

工程の名前に、製品側の決まりはありません。 業務に合う名前を付けてください。名前によって進み方が変わることはありませんが、工程名は Agent に渡される文脈と記録に使われます。工程の数には上限があります(設定値リファレンス)。

仕事の量で工程数を決める基準はありません。 これは型に関係なく同じです。1 回の実行で安定して終わらないときは、ゴールで 1 回に扱う対象を絞るか、Agent や配置を分けます。工程を増やすことが解決になるとは限りません。

ワークフローで分けるとき​

ワークフローは、1 件の仕事を受けて仕上げる型です。工程の並びが処理の順序になり、前の工程が終わってから次へ進みます。条件分岐の工程では選ばれたレーンだけを通り(何もせずに合流が選ばれたときはレーンを通らず)、確認で選ぶ次の工程の候補では途中の工程を飛ばして先の工程へ進めます。

たとえば、届いた申請を 1 件ずつ処理して返すワークフローを考えます。

  1. 内容を確かめる — 申請の記載と添付がそろっているか見る
  2. 人が承認する — 担当者が内容を見て、進めるか差し戻すかを決める
  3. 登録して返す — 承認されたものを登録し、申請者に結果を返す

1 件が 1 → 2 → 3 と進み、終わります。 2 で差し戻されれば 1 に戻り、やり直しになります。

分けるのは、進行を区切りたいところです。 この例では「人が承認する」の前後が区切りになります。区切ると、その切れ目に次のことを置けます。

  • 人の判断を挟む → 確認工程を置きます。実行はそこでいったん止まり、そのあとは担当者の決定か、期限を過ぎたときの設定に従って進みます(確認ガイド)
  • 差し戻しの戻り先にする → やり直しをどこから始めるかを、工程の単位で指定します(確認ガイド)
  • 進む先を人に選ばせる → 確認工程に「次の工程の候補」を置くと、担当者が後ろの工程から次の工程を選んで進めます(確認ガイド)
  • 時刻を待たせる → 工程に時刻を持たせられます。指定しなければ前の工程が終わり次第すぐ動きます(起動ガイド)
  • うまくいかなかったときの動きを変える → 工程ごとに選べます(後の節)
  • 一時的に実行対象から外す → 工程は 1 つずつ有効・無効にできます。無効な工程は止まるのではなく、飛ばして次へ進みます(サイクルでは、無効な工程に置いた配置は、新しく起動しません。起動ガイド)

担当を分けるときは、結果を受け渡すかで決めます。 1 つの工程に複数の Agent を置けますが、同じ工程の Agent どうしでは出力を受け渡しません。前の Agent の結果を受けて続きをさせたいなら、工程を分けます。互いの結果を使わない仕事なら、1 つの工程にまとめられます。失敗したときの動きも変わります(やり直しの回数は、工程に置いた Agent ごとに数えます)。何体置くかは後の節で扱います。

1 件の流れを途中で分けることもできます(条件で 1 本を選ぶのは、後の条件分岐)。工程の後ろから「ここから並列に進む」と、そこから 2〜11 本のレーンに分かれて同時に進み、全レーンが終わってから合流します。申請処理なら、「内容を確かめる」のあとで「記載を確かめる」と「添付を確かめる」を別のレーンで進め、両方がそろってから「人が承認する」へ進める、といった形です。

  • 並列は 1 か所だけです。 レーンの中でさらに並列には分かれられません
  • レーンの中の工程は、上から順に進みます。 レーンどうしは互いを待ちません。レーンの中で確認を待つときも、止まるのはそのレーンだけで、ほかのレーンは進み、合流で待ちます
  • 並列に進む前の工程は「同時に実行」にできません
  • 差し戻しの戻り先と、後の節で選ぶ次の工程は、同じレーンの工程から選びます。 レーンの外では、並列の前どうし、合流のあとどうしで選びます

サイクルで分けるとき​

サイクルは、対象を自分で探し続ける型です。Agent はそれぞれの契機で独立に起動し、ほかの工程が終わるのを待ちません。だから 1 つが止まっても、残りは動き続けます。対象が無ければ、その回は何もせずに終え、次の周期でまた探します。

段階が 1 つでも構いません。 決まった間隔で見に行き、必要があれば手を打つ——それだけなら段階を分ける必要はありません。工程を指定せずに作ると 2 つ用意されますが、使わない工程は消して 1 つにできます。

サイクルの工程は、担当の分類です。 図に円で並びますが、番号も矢印もつかず、並べ替えもありません。順に進めたいなら、それはワークフローの型です。

たとえば、届いた問い合わせに一次対応するサイクルを考えます。

  • 見つける — 新しく届いた問い合わせを探す
  • 振り分ける — 内容を見て、定型で返せるものと人が見るものに分ける
  • 下書きを作る — 定型のものに返信の下書きを用意する
  • 確かめる — 送る前に、下書きが内容に合っているか見る

問い合わせは次々届くので、終わりがありません。 それぞれの段階が自分の間隔で回り続けます。

分けるのは、対象の扱いが変わるところです。 この例では、段階ごとに拾うものが違います。「見つける」は未処理のもの、「振り分ける」は見つけ終わったもの、「下書きを作る」は定型と判断されたもの——というように、前の段階が残した状態で次の対象が決まります。 そこが段階の境目です。

段階を分けたら、それぞれの起動時刻をずらします。 全部を同じ時刻にすると、前の段階の結果がまだ無いうちに動いて空振りすることがあります。時刻をずらすと、動く機会に前後がつきます(起動ガイド)。ただし前の段階が終わっていることは保証されません。何を拾うかは時刻ではなく、記録先の目印で決めます(次の節)。周期は工程ではなく、工程に置いた配置ごとに決まります。

同じ段階を担う Agent は、周期が違っても 1 つの工程にまとめられます。 何体置くか、同じ Agent をどう扱うかは後の節で扱います。

サイクルで段階をつなぐとき​

サイクルの段階は待ち合わせないので、受け渡しは共通の記録で表します。 次の 2 つを組み合わせます。

  • 共通の記録先 — 連携先に「共通の記録先にする」を付けます(連携ガイド)
  • 読み書きの決まり — 対象の選び方と更新のしかたを、各 Agent のゴールや Skill に定めます

「共通の記録先にする」を付けただけでは、読み書きは起きません。 前の段落で決めた記録先に、段階ごとに目印を付け替えていく形にします。前の節の問い合わせ対応なら、こうなります。

  • 見つける の Agent — 拾った問い合わせに「確認中」の目印を付ける
  • 振り分ける の Agent — 「確認中」のものだけを見て、「定型」か「人が見る」に付け替える
  • 下書きを作る の Agent — 「定型」のものだけを扱い、終えたら「下書き済み」に付け替える
  • 確かめる の Agent — 「下書き済み」のものだけを見て、問題がなければ「確認済み」に付け替える

それぞれの Agent のゴールに「何を拾うか」と「終えたらどう付け替えるか」を書きます。 目印は記録先で扱える形にします(表の列でも、ラベルでも構いません)。こうすると、記録先が段階の間の受け渡し役になります。

同じ Agent が繰り返し動くときも、同じ作りで表します。 基盤は「もう済ませた対象の一覧」を持ちません。 ですから「まだ確認していないもの」「しばらく見ていないもの」のように前回との差で対象を選ぶゴールだけでは、毎回同じ対象を拾うことがあります。済んだ対象に目印を残し、その目印が付いたものを次の周期では扱わない——というように、前回との差も記録先で表してください。

人の判断も、同じ作りで表します。 Agent のゴールに「人に判断してもらう」という選択肢を持たせ、そのときは別の印を残させます。その印が付いた対象を扱わないよう、ほかの Agent のゴールに書いておけば、その対象だけを人の判断待ちにできます。ほかの対象の巡回は止まりません。人が外で判断して印を変えれば、また流れ始めます。

ワークフローとの違いはここです。ワークフローは 1 件の実行そのものを確実に止め、サイクルは対象ごとに保留します。 確実に止めたいのが実行全体なら、ワークフローを選んでください。指示で作る保留は基盤が保証するものではないので、外さないことが絶対の条件なら、連携先や API 側の仕組みを使ってください。

サイクルに確認工程は置けない

サイクルでは確認工程を追加できません。人の判断は、上に書いた目印の付け替えで挟みます。連携先を使う前の人の確認(接続の確認)は、サイクルでも使えます(連携ガイド)。

画面上の場所 編集 > 左の「編集ツール」>「工程を追加」(ワークフローでは続けて「通常工程」を選びます)。ワークフローでは、中央の図の工程の間の「+」>「Agent が実行」でも足せます。1 つ 1 つの設定は中央の図で工程を選ぶと右に出ます。ワークフローでは中央の図で並べ替えられます(サイクルに並べ替えはありません)。共通の記録先は 設定 タブ >「連携先(MCP, A2A)」> 対象の連携先 >「共通の記録先」の切り替え。並列は、中央の図で工程を右クリック >「ここから並列に進む」。レーンの追加・「並列をやめる」は、図の並列の枠にあります。工程をほかのレーンへ移すのは、右の「工程の設定」(確認工程では「確認の設定」)>「起動条件」>「所属レーン」。次の工程に渡す値と資料の役割は、ワークフローの「Agent が実行」の工程を選ぶと右に出る「次の工程に渡す値と資料の役割」(「次の工程に渡す値」「資料の役割」)

外部の自動化と条件分岐の工程(ワークフロー)​

外部の自動化の工程は、Agent を通さずに、決めた宛先へ 1 回送ります。 社内の別のシステムの受付を起こす、といった使い方です。Agent は置けません。工程には、確認・時刻・次の工程の候補・「同時に実行」・差し戻し先も付けられません。

宛先は、管理者が管理コンソールに登録した宛先から選びます(URL は見えません)。宛先が無い・無効になっていると、保存も開始もできません。DLP 連携がオンの間も、外部の自動化の工程は保存・開始できません。

送る中身は「本文の形(JSON)」に、JSON のオブジェクトで書きます(16 KB まで・入れ子は 16 段まで)。文字列の値の中に、前の工程の出力(全文は 20,000 字まで)・その要約・実行の ID・この工程の ID と名前・プロジェクトの ID と名前・開始の入力の件名と本文・冪等の鍵(再試行では同じ値)を差し込めます。使えない差し込みがあると保存できません。時間切れは 1〜300 秒です(既定は 60 秒)。

結果の扱い: 宛先が受け付けたら(HTTP の状態が 2xx)次の工程へ進みます。外の処理が終わったかどうかは確かめません。受け付けなかったとき・時間切れ・つながらないときは工程の失敗です。このうち、5xx・408・429・時間切れ・つながらないは、プロジェクトの再試行の設定に従って送り直し、使い切ると実行が失敗で終わります。

確かめ方: 実行記録に、宛先の名前・HTTP の状態・かかった時間・送信した本文のダイジェスト(SHA-256)が残り、記録 (証跡) に「外部の自動化の呼び出し」が残ります。相手の返した本文は残りません。保存の前には、「設定を検証」の修正する点で宛先の未選択・無効が分かります。

コピーしたとき: 公開プロジェクトのコピーのように、元のプロジェクトに参加していない人がコピーすると、外部の自動化の工程は来ますが、宛先と送る中身は引き継がれません。設定し直してください。元のプロジェクトに参加している人(オーナー・運用担当・メンバー)のコピーでは引き継がれます。

条件分岐の工程は、前の工程の結果を読んで、進むレーンを決めます。 条件分岐の下には、その工程のレーン(各レーンに工程を 1 つ以上置きます。工程は全部で 12 までなので、レーンは 11 本までです)が並びます。条件ごとに、当てはまったときの進む先を、レーンか「何もせずに合流」(どのレーンも通らずに合流の後ろへ進む)から選びます。レーンが選ばれたときは、そのレーンの工程だけを上から順に実行して、合流の後ろの工程へ進み、ほかのレーンの工程は実行しません(実行記録には「分岐の対象外」と出ます)。Agent は使わず、時刻も決められません。確認・時刻・次の工程の候補・結果の扱い・差し戻し先・「同時に実行」も付けられません。

分け方は「条件」で決めます(8 件まで)。1 つの条件は、判定対象(結果の文・結果のJSON・成果物・工程の実行・質問で判定)と規則(値と比較方法)と進むレーン(レーンか「何もせずに合流」)の組です。たとえば、結果の文に語を含む・JSON の項目が値と同じ(以上・以下)・成果物がある(種類・名前・数)・処理時間が何分以上・この工程に戻された回数・書き込み操作があった・Agent が「変更は要らなかった」と報告した、です。「質問で判定」は、yes か no で答えられる問いを書くと、判定だけをするモデルが前の工程の出力の先頭を読んで答え、yes なら当たりとします(成果物の中身は渡しません。この環境で使えないときは選べません)。

上の条件が優先で、上から順に確かめ、最初に当てはまった条件の進む先(レーンか何もせずに合流)へ進みます。どの条件にも当てはまらないときは、「どの条件にも当てはまらないとき」で、何もせずに合流(既定)・レーンへ進む・人に選択してもらうから決めます。

人に聞く形: 「人に選択してもらう」では、確認依頼が作られ、担当者に進むレーンか「何もせずに合流」を選んでもらいます(候補は、有効な工程のあるレーンと「何もせずに合流」)。期限が来ても自動では決めません。

レーンの工程は、条件分岐のすぐ後ろに、レーンごとに続けて置きます。 レーンの中に条件分岐は置けません。条件分岐とそのレーンは、並列のレーンの外に置きます。並列に進む前の工程には条件分岐もそのレーンの工程も置けず、合流のすぐ後ろには条件分岐のレーンの工程を置けません(条件分岐そのものは置けます)。レーンの工程を差し戻し先や次の工程に選べるのは、同じレーンの工程からだけです(レーンの工程からは、レーンの外の工程も選べます)。レーンの中の工程からは、実行を始められません。

レーンの工程は、ほかのレーンの出力を受け取りません。 合流の後ろの工程も、通らなかったレーンの出力は受け取りません。

試す: 編集画面の「試す」で、前の工程の出力の例と成果物の名前を入れて「当ててみる」を押すと、どの条件に当てはまり、どのレーンへ進むか(何もせずに合流・人に選択してもらうも)が分かります(保存はしません。処理時間・戻された回数・書き込み・報告の規則は、試すときには当たりません)。実行記録には、どの条件で決めたか(または人に確認したか)が残り、記録 (証跡) に「条件分岐の判定」「条件分岐で人に確認」が残ります。

画面上の場所 編集 > 左の「編集ツール」>「工程を追加」>「外部の自動化」「条件分岐」。外部の自動化は、その工程を選んで右の「外部の自動化の設定」。条件分岐は、右の「レーン」「条件」「どの条件にも当てはまらないとき」「試す」。レーンは、中央の図の条件分岐の横の「+ レーン」で足し、レーンの「(レーン名)に工程を追加」で工程を足します(レーンを足す・外すは広い画面のエディタで)

Agent に何を持たせるか​

入力が必須なのは、名前とゴール(指示)の 2 つだけです。 ガードレール・Playbook・Skill は、必要なものだけ足します。

最初にゴールを決める​

ゴールには、何を対象に、何をして、どの状態まで仕上げるかを書きます。ここが Agent の中心です。

ただし、ゴールを書くだけで外部の情報に手が届くようになるわけではありません。 とくにサイクルでは、仕事をどこから見つけるかをゴールに書き、必要なサービスをプロジェクトの連携先に加えます(連携ガイド)。前の節の問い合わせ対応なら、「連携先から未処理の問い合わせを探す」ところまでゴールに書きます。

外部に書き込む Agent には、書く前に、すでに書いてあるかを確かめることも書きます。 同じ Agent がもう一度動くことがあるためです(ワークフローは後の節、サイクルは前の節)。申請処理の「登録して返す」なら、「同じ申請がすでに登録されていれば、登録し直さない」と書きます。

管理コンソールの「ガードレール設定」で「個人情報のマスキング」を有効にしていれば、工程の指示も、会話と同じく、個人情報を伏せてから Agent に渡します。 前の工程の出力、受け取ったメールの件名・本文や Webhook の本文が入ります。ただし、人が書いた指示(Agent のゴール、確認者のコメント、差し戻しの理由)に出てくる名前やアドレスは、仕事の対象として書いたものとして伏せません。 同じ文字列が前の工程の出力などに出てきても伏せません。管理コンソールで「機微語」に登録された語は、それでも伏せます。

必要なものだけ足す​

  • 避けてほしい振る舞いがあるなら、ガードレール。 問い合わせ対応なら「返信を自分で送信しない」「金額や契約の条件には触れない」など。「これはしない」をゴールに混ぜると、やることの説明が読みにくくなります。ただしガードレールは Agent への指示です。書いただけでは操作を確実に止められません。 確実に止めたい操作は実行ルールで決めます(実行ルールガイド)
  • 繰り返し使う一連の段取りがあるなら、Playbook。 「下書きを作る」Agent に「過去の似た問い合わせを探す → 回答の型を選ぶ → 下書きを書く → 根拠として参照した記事を添える」のように、毎回同じ段取りを踏ませたいとき。各ステップの目的・ガイダンス・成功条件を書いておくと、Agent がそれに沿って進めます。ただし書いた手順がそのまま繰り返されるわけではありません。 Agent は依頼の内容に応じて手順を調整します。ワークフローで順序を守らせたいときは、Playbook ではなく工程を分けて表現してください
  • 個別の作業のやり方を持たせるなら、Skill。 たとえば「問い合わせをどう分類するか」を Skill にします。自社の製品名と分類の対応表、判断に迷ったときの優先順位、過去に誤分類した例——といった組織ごとに決まっているやり方を書いておくと、「振り分ける」Agent がそれに従います。ゴールに毎回書く代わりに切り出しておけば、複数の Agent で同じ基準を使えます。ほかに「返信の書式」「エスカレーションの判断基準」なども Skill 向きです。Skill は外部サービスへの権限を与えるものではありません(つなぐ先は連携先で決めます)。サイクルでは、Agent が何を仕事として見つけるかがゴールと Skill と連携先で決まります

ほかに説明や入力ファイルも足せます。入力ファイルは自分のライブラリから選び、その Agent を置いたすべての所で使われます。プロジェクトのメンバーで共有するファイルを工程ごとに渡すなら、プロジェクトのライブラリを使います(後の節)。項目の一覧は設定値リファレンスにあります。

Agent はプロジェクトをまたいで共有されます

Agent の設定を変えると、その Agent を使っているすべてのプロジェクトに及びます。 1 つのプロジェクトのために少し変えたつもりでも、ほかのプロジェクトの動きも変わります。プロジェクトごとに違う動きをさせたいなら、Agent を分けてください。

担当を引き継ぐなら、後任が持ち主の Agent を用意して置き換えます(Agent の持ち主とプロジェクトのオーナーの違いは誰が何を決められるか)。Agent の持ち主が退会・無効になったときは、システム管理者が管理コンソールの「持ち主の引き継ぎ」で持ち主を変更できます。

自分の Agent のカードには、その Agent を置いているプロジェクトが「配置されている場所」として出ます(どこにも置いていなければ「未配置」)。直す前に、どこに及ぶかを確かめてください。

画面上の場所 編集 > 中央の図で対象の工程に置かれた Agent を選び、右の「工程のAgent」>「基本設定」>「Agent を編集」>「ゴール (指示)」。「Agent を編集」は、その Agent の所有者にだけ出ます

Agent を工程に置く​

Agent を工程に置いたもの 1 つ 1 つが配置です。実行は配置の単位で動きます。

1 つの工程に何体置くか​

1 体で任せきれるなら、1 体のままで構いません。 複数置くと、型ごとに次のことができます。

ワークフローで複数置くと、同じ工程で別々の仕事を任せられます。 既定では配置順に 1 体ずつ動きます。工程を「同時に実行」にすると同時に動きます。互いの結果を待たない仕事に向きます。どちらでも、同じ工程の Agent どうしでは出力を受け渡しません。どの Agent も、前の工程の出力を受けて自分の仕事をします。申請処理の「内容を確かめる」工程なら、記載漏れを探す Agent と、申請の要件に照らして確かめる Agent を並べられます。置いたすべての Agent が終わると次の工程へ進み、次の工程には全員の出力が渡ります。ある Agent の結果を受けて別の Agent に続きをさせたいなら、工程を分けてください(次の節)。

「同時に実行」の工程で、結果が「ルールにより実行不可」「失敗 (Agent の報告)」になった Agent は、その Agent ごとに「結果の扱い」に従います(後の節)。確認を求めるなら、その Agent ごとに確認依頼が作られ、ほかの Agent は動き続けます。全員の結果がそろうまで次の工程へは進みません。Agent によって進む先が分かれたときは、どこへ進めるかを選ぶ確認依頼が作られます。この工程の確認依頼で差し戻すと、ほかの Agent を待たずに戻り先からやり直します。そのとき動いていたほかの Agent の結果や、同じ回のほかの確認依頼の決定は、記録には残りますが、先へ進むのには使われません。

サイクルで複数置くと、同じ段階を、対象や探し方の違う巡回に分けられます。 それぞれの配置が互いを待たずに動きます。問い合わせ対応の「見つける」工程なら、メールから未対応のものを探す Agent と、フォームから未対応のものを探す Agent を並べられます。ただし複数置いただけでは、対象の分担も重複の防止も決まりません。 どちらがどれを扱うかは、共通の記録先と各 Agent のゴールで決めます(前の節)。

ワークフローで何が引き継がれるか​

ワークフローで自動的に引き継がれるのは、前の工程の Agent 全員の出力と、それぞれが作ったファイルです。 ファイルは、ライブラリに保存されたものが次の工程の Agent の入力ファイルとして渡ります。前の工程に Agent が複数いれば、出力は Agent ごとに並んで渡ります。出力は Agent の最後の回答で、1 つにつき 20,000 字まで渡ります(いくつか受け取るときは、合わせて 40,000 字まで)。超えた分は切れ、切れたことと全体の字数が添えられるので、それより長い結果はファイルに書かせます。前の工程の出力は、指示ではなくデータとして渡ります。 起動ごとに変わる区切りで囲み、データとして扱うよう添えて渡すので、前の工程が外部の内容をまとめていても、それが次の工程への指示として扱われないようにしています。

名前を付けた値と、役割を付けた資料も渡せます。 「Agent が実行」の工程に「次の工程に渡す値と資料の役割」を決めると、その工程の Agent に、決めた名前の値(文)と、成果物のどのファイルがどの役割の資料かを返してもらい、次の工程の Agent に名前と役割を付けて渡します。前の工程の出力と一緒に渡るので、届く先は前の工程の出力と同じです。値は 5 つ・役割は 3 つまで(名前は 40 字・説明は 200 字まで)、1 つの値は 1,000 字までで、超えた分は切れます。Agent が返さなかった値と、成果物に見つからない資料は、推し量って埋めずに、届かなかったことを次の工程に伝えます。値は条件分岐の判定と、実行の成否には使われません。 サイクルにはありません。

注意する点が 3 つあります。

  • 同じ工程の Agent どうしでは引き継がれません。 1 つの工程に 2 体並べても、2 体目に 1 体目の出力や新しく作ったファイルは届きません。どちらにも、前の工程のぶんが届きます。ただし配置順に動かすときは、前の工程から受け取ったファイルを 1 体目が書き換えると、同じファイルなので、2 体目は書き換えた後のものを読みます。「同時に実行」の工程やレーンにも同じファイルが渡るので、同じファイルを同時に書き換えさせないでください
  • 引き継がれるのは、直前に Agent が動いた工程のぶんだけです。 確認工程は飛ばして、その前の工程のぶんが届きます。2 つ以上前の工程のぶんは、自動では引き継がれません。レーンでは、レーンの最初の工程に、並列に進む前で最後に Agent が動いた工程のぶんが届きます。合流のあとの最初の Agent の工程には、各レーンの最後のぶん(出力とファイル)が届きます。いくつかの出力が届くときは、それぞれにレーン名と工程名が付きます(出力が 1 つだけのときと、ファイルには付きません)
  • それまでのやりとりは引き継がれません。 Agent が調べた途中の内容は渡りません

ですから、後の工程の Agent が 2 つ以上前の工程の成果を見る必要があるなら、共通の記録先に保存させてください(連携ガイド)。プロジェクトのライブラリでもできます。各工程の Agent が書くファイルをライブラリと同期させ、読む Agent の配置にも同じファイルを同期させます(下の節)。前の工程の出力とファイルだけを手掛かりに続きを始められるなら、そのまま並べて構いません。

サイクルには、この自動の引き継ぎがありません。 段階のつなぎ方は前の節のとおり、共通の記録先で表します。

同じ Agent を複数の工程に置くとき​

同じ Agent を複数の工程に置けます。 Agent は使い回す設定なので、置いた数だけ配置ができます。

  • ワークフローで同じ Agent を続く工程に置いても、工程ごとに動きます。 後の工程では、ほかの工程と同じく、前の工程の出力と、作ってライブラリに保存したファイルを受け取ります(プロジェクトと工程)
  • サイクルで同じ Agent を 2 つの周期で動かすなら、工程を分けます。 1 つの工程に同じ Agent を 2 回置くことはできません

サイクルの周期は、Agent ではなく配置が持ちます。設定は起動ガイドで扱います。

プロジェクトのライブラリのファイルを渡す​

工程に置いた Agent には、プロジェクトのライブラリのファイルを渡せます。 プロジェクトのライブラリは、プロジェクトの「ライブラリ」タブにある、メンバーで共有するファイルの置き場です。Agent の設定の入力ファイル(自分のライブラリから選び、その Agent を置いたすべての所で使われる)とは別に、配置ごとに決めます。

  • 登録する — 「ライブラリ」タブで、ファイルをアップロードするか、「自分のライブラリから」選ぶか、実行記録の成果物を「ライブラリに登録」します。自分のライブラリから選んだものは、その時点の写しが登録されます。同じ名前のファイルは登録できないので、すでにあるファイルには、行の「バージョンの管理」を開いて「新しいバージョンをアップロード」します。新しいバージョンにできるのは、元のファイルと同じ種類(拡張子)のファイルだけです。アップロードでは、一度に 20 件まで選べます。実行記録の成果物は、同じ名前のファイルがあれば「「(ファイル名)」の新しいバージョンとして登録」で足せます(記録ガイド)。内容が同じならバージョンは増えません
  • バージョンをたどる — 行の「バージョンの管理」で、いつ・誰が(どの実行が)書いたバージョンかを見られ、バージョンごとにダウンロードできます。実行が書いたバージョンからは「実行記録を表示」で、その実行記録へ移れます。「このバージョンを最新にする」で、前のバージョンの内容を新しい最新のバージョンとして保存できます(今の最新のバージョンも履歴に残ります)
  • 削除する — 登録を解除して、取得できなくします。バージョンの内容は残りますが、画面からは開けなくなります

渡すファイルは、置いた Agent の「参照・ツール」タブの「ライブラリと同期するファイル」で選び、作業場所での名前を付けます。 起動のたびに、最新のバージョンがその名前で Agent の作業場所に置かれます。Agent がその名前のファイルを書き換えると、ライブラリの同じファイルの新しいバージョンとして保存されます。 次の起動では、そのバージョンが渡ります。実行記録の成果物の「毎回この名前でライブラリに保存」でも、同じ対応づけを 1 回で作れます(オーナーだけ。編集の下書きを通さず、その場で保存されます)。Agent のゴールに「結果は(作業場所での名前)に保存する」と書くと確実です。ワークフローでもサイクルでも同じです。

  • 名前はファイル名だけで、フォルダは指定できません。先頭が「.」の名前や、.log・.tmp・.swp・.pyc などの名前は、実行の成果物として拾われないので使えません
  • 選んだファイルは下書きに入り、「変更を反映」で保存されます
  • 起動の時点でライブラリから削除されていたファイルは渡りません。削除したファイルが選ばれたままだと、「設定を検証」の修正する点になります

登録・新しいバージョン・前のバージョンに戻すは、メンバーもできます。 削除と、同期するファイルを決めるのはオーナーだけです。ただし、ファイルの登録(アップロード)と新しいバージョンの追加は、管理者が機能の許可で「ファイルの添付」を許していない人にはできません。メンバーが新しいバージョンを足すと、次の起動から、そのバージョンが Agent に渡ります。誰がどのバージョンを書いたかは、「バージョンの管理」と記録 (証跡) の CSV で追えます(記録リファレンス)。

画面上の場所 編集 > 左の一覧の「Agent」から中央の図へ置く。または中央の図で工程を選び、右の「工程の設定」>「Agentを追加」(ワークフローでは「基本設定」タブの中)。外すときは、同じ一覧の ×(「工程から削除」)か、置いた Agent を選んだときの右の欄の下にある「工程から削除」。同時に動かすときは、中央の図で工程を選び、右の「工程の設定」>「起動条件」>「同時に実行」(Agent を 2 体以上置くと切り替えられます)。読む会社の記憶は、置いた Agent を選んだときの右の「工程のAgent」>「基本設定」>「会社の記憶」。選んだ値は下書きに入り、「変更を反映」で保存されます。渡すファイルは、置いた Agent を選んだときの右の「工程のAgent」>「参照・ツール」>「ライブラリと同期するファイル」。ファイルの登録とバージョンは、プロジェクトの「ライブラリ」タブ

うまくいかなかったときどうするか(ワークフロー)​

工程には、想定どおりに終わらなかったときの動きを 2 つ設定できます。どちらも工程ごとに選べます。どちらもワークフローで効くものです。 サイクルは工程を順に進めないので、この 2 つは使いません。

「ルールにより実行できない場合」は、「確認を求める (確認待ち)」「失敗として閉じる」「指定した工程へ進む」から選びます。基盤が実行そのものを禁じたときです。

  • 確認を求める (確認待ち) — その場で処理を止め、確認依頼を作ってオーナーに渡します(この工程には確認担当者を指名する欄が無いので、その時点のオーナー全員が担当者になります。ただし、確認工程から「Agent が実行」に切り替えた工程で、確認工程のときに指名した担当者が今もメンバーなら、その人が担当者になります)。実行は確認待ちになり、担当者の決定か、期限を過ぎたときの設定に従って進みます(確認ガイド)
  • 失敗として閉じる — 実行そのものを終了します。確認依頼は作られず、後続の Agent や工程は動きません
  • 指定した工程へ進む — 確認依頼を作らず、「次の工程」に選んだ後ろの工程へ進みます。間の工程は実行されません(実行記録には「分岐の対象外」と出ます)。配置順に動かす工程では、同じ工程のまだ動いていない Agent は動きません。「同時に実行」の工程では、ほかの Agent はもう動いているので止めず、結果がそろってから次の工程を決めます。選んだ工程には、その工程へ進むきっかけになった Agent の出力とファイルは渡りません。選んだ工程を実行の始まる前に無効にしていたときは、「確認を求める」と同じになります

既定は確認を求めるほうです。設定を見直せば通るようになる見込みがあるなら確認、そうでなければ閉じる、が目安です。実行ルール自体は実行ルールガイドで扱います。

「Agent の報告による失敗のとき」は、「確認を求める」「そのまま進める」「指定した工程へ進む」から選びます。Agent が自分で「完遂できなかった」と報告したか、最後の結果でそう示した場合です。実行時間の上限でまとめに入ったあとに完遂できなかったときは、これに当たらず、基盤側の時間切れとして扱います(下の段落)。

  • 確認を求める — 上と同じで、確認依頼を作ってオーナーに渡します。実行は確認待ちになります
  • そのまま進める — 確認依頼を作らず、同じ工程に次の Agent がいればその Agent へ、いなければ次の工程へ進みます(「同時に実行」の工程では、ほかの Agent の結果がそろってから次の工程へ進みます)
  • 指定した工程へ進む — 上と同じです

こちらも既定は確認を求めるほうです。

接続の確認で止めたとき(結果は「失敗 (Agent の報告)」、理由は「接続の確認のため停止」)は、この設定に従わず、接続の確認の確認依頼を作ります。却下されたときと、待ちの上限を過ぎたときに、この設定に従います(連携ガイド)。

「そのまま進める」を選ぶのは、後の工程の Agent が、この Agent の出力を使わないときです。その出力を受けて続きをするなら、止めて確認するほうが安全です。なお、対象が無くて実行が起動しなかったときは、この設定に関係なく次へ進みます。

どちらの場合も、自動でやり直すことはありません。 もう一度動かすと外部に二重に書き込んでしまうおそれがあるためです。やり直すかどうかは、状況を確かめて人が決めます。

一方、基盤側の失敗(実行環境の異常や時間切れ。実行時間の上限でまとめに入り、完遂できなかったときを含みます)は自動でやり直します。 回数の上限はプロジェクトごとに決め、工程に置いた Agent ごとに、その工程に入るたびに数えます(差し戻しでもう一度その工程に来たときは、数え直します)。上限を超えると、その実行は失敗として終わります(値の範囲は設定値リファレンス)。やり直したときは、実行記録に「試行 2 回目」と出ます。 やり直しは止まったところから続くのではなく、その工程の Agent がもう一度最初から動きます。

立て直すときは、新しく実行を始めるか、確認待ちなら差し戻しで途中の工程からやり直すか、却下・失敗で閉じた実行なら選んだ工程から再開するか(確認ガイド)を決めます。 その前に確かめることは記録ガイド、すでにした操作の扱いは確認ガイドにあります。

画面上の場所 編集 > 中央の図で対象の工程を選び、右の「工程の設定」>「起動条件」>「結果の扱い」。やり直しの回数は 設定 タブ >「実行ルール」>「実行」>「工程ごとの再試行回数 (失敗・時間切れ)」

公開と再利用​

Playbook、Skill、Agent、プロジェクトは、それぞれ公開できます。再利用のしかたは違います。

公開されたものの使い方作者があとで直したとき
Skillそのまま使える「最新のバージョンに追随」なら及びます(公開に管理者の承認が要るテナントでは、承認されてから)。バージョンを固定していれば及びません
Playbook自分用にコピーしてから使うコピーには及びません
Agent工程に置くと自分用にコピーされるコピーには及びません

公開 Agent は、工程に置いた時点で自分用にコピーされます。 置いたあとは自分のものなので編集できますが、作者がその後に直した内容は入ってきません。取り込みたいときは置き直します。

Playbook は、Agent に付ける選択肢に自分の Playbook しか出ません。公開されたものを使うには、先に自分用にコピーします。

Skill だけは、公開されたものをそのまま使い、作者の更新も入ってきます。 ほかの 2 つとは性質が違うので注意してください。作者が直すと新しいバージョンになり、Agent で「最新のバージョンに追随」にしていれば次の実行から新しいバージョンを使います。テナントで公開に管理者の承認が要るときは、新しいバージョンは管理者が承認するまで使われず、それまでは前のバージョンのままです。入ってきてほしくないときは、Agent で使うバージョンを固定します。ほかの人の Skill で固定できるのは、その Skill が公開されていた間に公開されたバージョンだけです。

テナントによっては、Skill と Playbook の公開に管理者の承認が要ります。 システム管理者が、管理コンソールの「公開の申請」で Skill と Playbook それぞれに決めます(既定は承認なし)。承認が要るあいだは、「公開する」の代わりに「公開を申請」になり(申請の理由は任意)、管理者が管理コンソールで承認するまで、ほかの利用者には見えません(承認できる管理者はロールリファレンス)。

  • 申請中は「公開の承認待ち」と出ます。取り下げるときは「申請を取り下げる」を押します
  • 差し戻されると「管理者による差し戻し」と理由が出ます。内容を直して「再申請」を押します
  • 公開中の Playbook を直したときも、公開の承認が要るテナントでは、直した内容が承認待ちになり、承認されるまでは、承認済みの内容が公開されたままです
  • 公開中の Skill を直すと、新しいバージョンが「新しいバージョンの承認待ち」になり、承認されるまでは今のバージョンのまま公開されます
  • 承認が要るようになる前に公開したものは、公開のままです。管理者が公開を停止することもあります

プロジェクトを公開すると、ほかの利用者がその工程と Agent をコピーして使えるようになります。実行記録と共通の記録先は公開されません。

プロジェクトを作るときに、今あるプロジェクトから始めることもできます。 「どのように作りますか」で「既存のプロジェクトから作る」を選び、自分が参加しているプロジェクト(オーナー・運用担当・メンバーのどれでも)か公開プロジェクトを 1 つ選ぶと、それをコピーした新しいプロジェクトができて、その画面に移ります。コピーした人がオーナーになります。管理者が停止したプロジェクトや、管理者が停止した Agent を使っているプロジェクトは、コピーできません(「管理者が停止しているため、この操作はできません。再開は管理者に依頼してください」と出ます)。工程や Agent は、作ったあとに編集で直します。コピーのされ方は、プロジェクトの画面と一覧のカードの「複製する」(オーナーだけに出ます)と同じです。定義の変更に承認を要るテナントでは、コピーした最初の定義は承認待ちになり、承認されるまで実行できません。作成方法には、このほか「自分で作る」「社内のひな形から作る」「ファイルから取り込む」「相談して作る」「誘導で作る」があります。

コピーしたプロジェクトでは、次のものを確かめてください。

  • 連携先 — 一覧は引き継がれます(「共通の記録先」の指定と「接続時の確認」の設定も)。接続(認証)は引き継がれないので、コピーしたプロジェクトで接続し直します
  • Playbook・Skill・入力ファイル — ほかの人の Agent が使う Playbook と Skill は、自分のライブラリに複製されて付きます(自分の Skill と、公開されていて有効な Skill は、そのまま使います)。公開に管理者の承認が要る種類(Skill・Playbook)では、他の人の、公開されていないものは複製されずに外れ、外れた Agent の名前が知らされます。入力ファイルは、自分のライブラリに無いものだけが外れます
  • このプロジェクトでの追加の指示 — 配置ごとの「このプロジェクトでの追加の指示」はコピーされます
  • 確認の設定・工程の時刻・失敗時の設定 — コピーされません。工程そのものと差し戻し先は引き継がれます(「同時に実行」とレーンも)。条件分岐の工程のレーンと条件は引き継がれ、レーンの工程は写した工程に付け替えられます(写せない工程はレーンから外れ、空になったレーンとそこへ進む条件は外れます)。外部の自動化の工程の設定は、元のプロジェクトに参加している人(オーナー・運用担当・メンバー)がコピーしたときだけ引き継がれます
  • 起動設定 — 時間トリガーはコピーされますが無効の状態で来ます。サイクルの巡回の周期はコピーされません。メールで起動の設定(宛先・許可するメールアドレス・サイクルで起動する配置)もコピーされません。コピーしたプロジェクトで有効にすると、そのプロジェクトの宛先ができます
  • 所属組織・会社の記憶の選択 — コピーされません。所属組織は、要るならコピーしたプロジェクトで付けます。会社の記憶は Agent ごとに選び直します
  • プロジェクトのライブラリ — ファイルはコピーされません。配置の「ライブラリと同期するファイル」は引き継がれず、外れた状態で来ます。コピーしたプロジェクトのライブラリにファイルを登録して、選び直します
  • 期限超過時の連絡先(既定) — コピーされません

自分のプロジェクトを複製しても、Agent は分かれません。 自分の Agent は、複製したプロジェクトにも同じものが置かれます。複製したほうで Agent を直すと、元のプロジェクトも変わります。

定義を書き出す・取り込む・社内のひな形にする​

プロジェクトの定義(工程・Agent・トリガー・連携先)は、ファイルにして別の環境へ持っていくことも、社内のひな形として公開することもできます。どちらも、プロジェクトを作るときの「どのように作りますか」から始めます。

書き出せるのはオーナーだけです。 設定 タブの「定義を書き出す」で「書き出す」を押すと、確定している定義が JSON のファイル(<プロジェクト名>.definition.json)に保存されます。承認が要るテナントでも、書き出されるのは承認された定義です。書き出したことは記録に残ります。接続・秘密・確認担当者・期限超過の連絡先・報告先のアドレス・実行の記録・ライブラリのファイル・環境変数の値・周期でないトリガーは含まれません。 Agent のゴールやガードレールなど、自分で書いた文はそのまま入るので、ファイルは渡す相手を選んで扱ってください。

取り込むのは、プロジェクトを作れる人なら誰でもできます。 作るときに「ファイルから取り込む」を選び、別の環境で書き出したファイルを選ぶと、工程・Agent・予定が一覧に出ます。確かめて「取り込む」を押します。取り込んだプロジェクトは一時停止で作られ、予定(時間トリガー)は無効です。 承認が要るテナントでは、最初の定義が承認されるまで実行できません。ファイルが読めないとき、形の版が合わないとき、定義が大きすぎるときは取り込めません(作りかけのプロジェクトは消えます)。トリガー・工程の時刻・有効な巡回を含む定義は、「定期実行の作成」を許されていない人には取り込めません。

取り込んだとき、この環境に無い物は持ち込まれず、プロジェクトの画面の上の「取り込んだ定義で設定が必要な項目」に並びます。

見出し出る物実行
次の項目を再度設定するまで、実行を開始できません。この環境に無い連携先、Agent が使う Playbook・Skill設定し直すまで始まらない。一時停止から再開できないので、メールや時間トリガーなどで始めようとしても動かない。巡回の再実行も断られる
必要に応じて再度設定する項目連携先への接続、確認担当者の選択、持ち込んでいない起動やライブラリの対応づけ、入力ファイル、環境変数の値、条件分岐の進むレーン、外部の自動化の宛先の選び直し など止めない
この環境では使用できないため外した設定この環境で動作しない Agent、質問で判定する分岐の行、サイクル型の定義の時間トリガー など、この環境で使えない設定止めない

1 行目は、オーナーが「連携先の設定を開く」「エディタを開く」から設定し直すと消えます。2・3 行目は、確かめたらオーナーが「確認済みにする」で消せます。

社内のひな形は、決めた欄だけを使う人に入れてもらう型です。 公開するのはオーナーだけです。設定 タブの「社内のひな形にする」で、「使用する人が入力する欄」(宛先・連携先・入力のファイル・予定)、「使用する人への説明」(2000 字まで)、「公開の範囲」(自分の組織/社内の全員)を決めて「ひな形として公開する」を押します。公開した時点の確定の定義の写しが公開され、あとでプロジェクトを直しても、「ひな形を更新する」を押すまでひな形は変わりません。「公開をやめる」で一覧から外れます(作ったプロジェクトは残ります)。自分の組織に公開するには、所属する組織が要ります(無いときは「社内の全員」にします)。

使うのは、役割に関係なく誰でもできます。 作るときに「社内のひな形から作る」を選び、一覧(自分が公開したもの・自分の組織向け・社内の全員向け)からひな形を選んで、決められた欄だけを入れます。接続は作ったあとに、自分で連携先に接続します。選んだ宛先が無効になっていると作れません。作ったプロジェクトは、取り込みと同じく一時停止で作られ、「取り込んだ定義で設定が必要な項目」が出ることがあります。トリガー・工程の時刻・有効な巡回を含むひな形からは、「定期実行の作成」を許されていない人は作れません。

画面上の場所 作るとき>「どのように作りますか」>「ファイルから取り込む」「社内のひな形から作る」/設定 タブ>「定義を書き出す」「社内のひな形にする」/プロジェクトの画面の上>「取り込んだ定義で設定が必要な項目」

下書きを確かめて反映する​

工程と配置の変更は、配置の「会社の記憶」と「ライブラリと同期するファイル」も含めて、下書きとして溜まります。反映するまでプロジェクトは変わりません。 反映した設定が効くのは次の実行からで、動いている実行には影響しません。

テナントで定義の変更に承認を要る設定がオンのときは、反映した変更は、承認されるまで使われません。 「変更を反映」で保存した変更は「承認待ち」の版になり、実行は、承認されるまで稼働中の版のままで動きます。承認するのは、変更を保存した人と別の、プロジェクトのオーナーか組織の管理者で、承認も差し戻し(理由は必須)も、プロジェクトの画面の承認待ちの表示か受信トレイから行います。差し戻されても、稼働中の版は変わりません。オーナーは、承認待ちの変更を取り消せます。作ったばかりのプロジェクト(コピーや取り込みを含む)は、最初の定義が承認されるまで実行できません。 承認を待たずにすぐ変わるのは、名前・説明・タグ・共有と通知です。承認が要るのは、工程・配置・トリガー・連携先と、型・基本ルール・実行の制限などの定義です。

下書きはそのブラウザに残ります。次に開いたときに続きから編集できますが、別のブラウザや端末には引き継がれません。

反映する前に設定を検証できます。検証は下書きを含めて確認し、保存も外部サービスの実行もしません。検証で問題が出なかったからといって実行が成功するとは限りません。接続の認証と実行時の権限は、実行のときに確かめられます。

検証の結果は、編集画面に出ている「修正する点」と同じ判定です。 有効な工程を種類ごとに見ます。Agent を置く工程では、Agent が置かれているかとその Agent にゴールが書かれているか、「ライブラリと同期するファイル」に、ライブラリから削除したファイルが残っていないか。確認工程では、担当者がいるか(ワークフロー)。外部の自動化の工程では、宛先を選んでいて、その宛先が有効か。条件分岐の工程では、レーンと条件があるか、レーンの工程が条件分岐のすぐ後ろにレーンごとに並んでいるか、どの条件からも、また「どの条件にも当てはまらないとき」からも進まないレーンが無いか(「人に選択してもらう」のときは見ません)。サイクルではさらに配置に巡回の周期があるかも見ます。周期を意図して止めているぶんは、修正する点になりません。

修正する点とは別に、「確認事項」が出ることがあります。 反映は妨げません。外部の連携先を使うのに、確認工程が無く、連携先の「接続時の確認」も「確認しない」のとき(Agent は人の確認なしに外部へ働きかけます)、Webhook やメールで外から起動されるのに、確認工程が無いとき(Agent は人の確認なしに最後まで進みます)と、サイクルで巡回の間隔が「1回の実行の長さ」より短いとき(前の巡回が終わる前に次が始まることがあります)です。意図したものか確かめてください。このほか、DLP 連携がオンのときに外部の自動化の工程があると、その工程が使えない旨の「確認事項」も出ます。

反映は変更ごとに行われます。一部が反映できなかった場合、失敗した分は下書きに残り、最初の失敗の理由が出ます。直してからもう一度反映してください。工程の追加・削除・並べ替えや、Agent の追加・配置・取り外しが失敗して後ろの同じ種類の変更を止めたときは、「この変更を破棄」でその 1 件だけを下書きから外せます(元に戻せません)。

1 つ注意があります。Agent の設定は下書きに入りません。 Agent を編集して保存すると、その時点で保存されます。下書きを取り消しても、Agent の変更は戻りません。工程の並べ替えを取り消すつもりで、Agent の変更まで戻ると考えないでください。

Agent の変更を試すときは、新しい Agent を作って試します。 自分の Agent を複製する操作はないので、新しい Agent を作ってゴールや Skill を移し、試すプロジェクト(複製で作れます)に置いて確かめてから、元の Agent に反映します。変えた内容と日時は、自分で控えます。 記録 (証跡) に残る変更の範囲は記録リファレンスにあります。

設定 タブ >「基本情報」は、下書きを使わず、保存した時点で変わります。 編集を始めたあとに別の操作でプロジェクトが更新されていたら、保存のときに知らせが出るので、「最新を読み込む」か「入力した項目を残す」を選びます。入力した項目を残すと、自分が変えていない項目は最新の値になり、そのまま編集を続けられます。もう一度「保存」を押すと保存されます。

画面上の場所 編集 の上部 >「設定を検証」「変更を反映」

前のバージョンに戻す​

反映した定義はバージョンとして残り、変更の中身を見て、工程の設定を前のバージョンに戻せます。 バージョンを選ぶと、その変更が「基本情報と実行ルール」「工程」「配置」「トリガー」「通知」「連携先」の区分ごとに、「追加」「削除」「変更」で出ます。

「このバージョンに戻す」で戻るのは、今もある工程の設定だけです。 工程の追加・削除・並び、配置・トリガー・通知・連携先・基本情報と実行ルールは戻りません。戻すと、そのバージョンの工程の設定が下書きに読み込まれてエディタが開くので、「変更を反映」で保存します(定義の変更に承認が要るテナントでは、承認されるまで使われません。上の段落のとおりです)。今の工程の設定と違いが無いときは、その旨が出て、何も読み込みません。戻せるのはオーナーで、広い画面のエディタでだけです。「承認待ち」と「取り消し」のバージョンには戻せません。

画面上の場所 概要 タブ >「プロジェクト情報」>「すべて表示」>「バージョン」> バージョンを選ぶ >「このバージョンに戻す」

AI に下書きを作らせる​

AI で作る・相談する機能は α 版です。 画面の入口に「(α版)」と付いています。動きや画面は今後変わることがあります。AI が作ったものは、そのまま使わずに必ず確かめてください。

プロジェクトを作るときに AI に下書きを作らせる方法は 2 つあります(チャットから作る道は、下の「チャットから下書きを作る」)。「どのように作りますか」で、「相談して作る」か「誘導で作る」を選びます(どちらも「α版」と付いています)。

インサイトの「自分」タブには「プロジェクトにする候補」が出ます。 定期で動かしている Schedule・Claw と、何度も使っている Playbook・Skill です。繰り返している作業をプロジェクトにすると、記録と改善の相談が使用できます。候補の「誘導で作る」から、そのまま作り始められます。

相談しながら 1 つ作る​

やりたいことを書くと、AI が型・工程・Agent を決めて下書きを作ります。やりとりの中で質問が返ってくることもあります。AI は、自分が参加しているプロジェクトと公開プロジェクトの形(工程の並び・確認の置き方・配置など)と結果も参考にし、案に「参考にしたプロジェクト」を示します。ゴールの本文や会話は参考にしません。すでに登録してある Playbook と Skill は、AI が候補から選んで付けます。名前しか分からないものは「未登録: …」と表示されるので、自分で付けてください。案の Agent には、付ける Skill と Playbook の名前が「Skill: …」「Playbook: …」で出ます。

内容を確かめて作成すると、その時点で保存されます。

質問に答えて作る​

「誘導で作る」を選ぶと、決まった質問に 1 問ずつ答えて、公式のひな形から始めます。答えている間は AI は動かず、プロジェクトも作られません。「分からないので次へ」が出る質問では、それで先へ進めます。何も選ばずに「次へ」を押せる質問では、選ばないまま先へ進めます。前の質問に戻って答えを直すこともできます。

答え終わると「おすすめの構成」が出ます。種別・工程・担当の Agent・起動・連携先が並び、この時点ではまだ保存されていません。「AIと仕上げる」を押すと、この構成をもとに AI と相談して仕上げます。内容を確かめて作成すると、その時点で保存されます。

ひな形が求める Skill と Playbook は、名前では付きません。「用意が要るもの」として出るので、付けるものは相談しながら作るときと同じように選ばれるか、自分で付けます。連携先はまだ接続されていません(「未設定」と出ます)。作成したあとに、プロジェクトの連携先で接続します。

工程の形が決まっているワークフローのひな形では、ワークフローのまま作る限り、工程の数と、Agent の工程・確認工程の並びはひな形のままになります。 AI との相談でこの数や並びが変わった案は、ひな形の工程に戻されます(画面にそう出ます)。変えたいときは、作成したあとに編集で変えます。相談でサイクルに変えると決めたときは、レーンや次の工程の候補などのひな形の形は外れます(画面にそう出ます)。

公式の質問とひな形が使えないときは、「誘導で作る」は今使えない、と出ます。

どちらの場合も確かめること​

時間トリガーが提案された場合、無効の状態で登録されます。 サイクルで周期が提案された場合は、プロジェクトが一時停止の状態で作られ、配置ごとの巡回はその周期で登録されます。再開すると巡回が始まります。「定期実行の作成」を許されていない人が作ったときは、巡回は無効で登録され、再開しても始まりません。どちらの経路でも同じです。内容を確かめてから、有効にするか再開してください(起動ガイド)。

できあがった配置を見て、1 つの工程に何体置かれたかを確かめてください。必要な数や配置になっていなければ、作成後に調整します。 担当の Agent がいない「Agent が実行」の工程には「担当なし」と出ます。作成後に Agent を置いてください。編集画面の図の上に「Agentを配置する工程が◯件あります」と出て、「「(工程名)」のAgentをAIで作る」か「「(工程名)」を開く」で、最初のその工程から Agent を置けます。その工程を選んだ右の欄にも「AIでAgentを作る (α版)」と「新規 Agent」が出ます。案の工程が下限(ワークフローは 2 つ、サイクルは 1 つ。サイクルでは確認工程を除いて数えます)に満たないときは、空の「Agent が実行」の工程が下限まで足され、そのことが警告で知らされます。作成後に、足された工程の内容と担当を設定するか、置き換えてください。

作ったあとで AI に相談する​

作ったあとも、編集画面で AI に相談できます。 相談できるのは、プロジェクトの構成の見直しと、Agent の作成です。うまくいかなかったワークフローの工程の実行とサイクルの巡回のうち対象になるものは、実行記録で改善案を相談できます(記録ガイド)。

ほかの人が持ち主の非公開の Agent については、AI に渡るのはゴール (指示) までです。 ガードレールと、付けている Skill・Playbook は AI から見えないので、相談の提案がそれを踏まえていないことがあります。必要なら持ち主に確かめてください。

提案を取り込むと、工程・配置・巡回の周期の変更は下書きに入ります。 反映するまでプロジェクトには入りません。Agent を作る・直す提案は、Agent の画面が開き、そこで保存したときに保存されます。 新しい Agent に置く工程があれば、その配置も下書きに入ります。

画面上の場所 プロジェクトを作るとき >「どのように作りますか」>「相談して作る」または「誘導で作る」。作成後は 編集 > 左の「編集ツール」>「AIに相談 (α版)」>「プロジェクトの構成を相談」または「Agentの作成を相談」

チャットから下書きを作る​

チャットで決めた流れから、プロジェクトの下書きを作ってもらうこともできます。 チャットで、決めた流れをプロジェクトにするよう頼みます(たとえば「この流れをプロジェクトにして」)。すると、チャットに「プロジェクトの下書き」のカードが出ます。この時点では何も作られません。 「プロジェクトの作成で開く」を押すと、プロジェクトの作成の画面が、この下書きを取り込む形で開きます。中身(工程・Agent・予定)を確かめて「取り込む」を押すと、プロジェクトができます(取り込みと同じく、一時停止で作られ、予定は無効です)。

うまく動かない Agent の直しも、チャットで頼めます。 プロジェクトの中の自分の Agent のゴールやガードレールを直したいと頼むと、「Agent の修正の下書き」のカードが出ます。「Agent の編集で開く」を押すと、自分の Agent が見つかれば、その編集の画面が直しを重ねて開きます(同じ名前の Agent が複数あれば、当てる Agent を選びます)。保存するまで変わりません。保存すると、その Agent を使うすべてのプロジェクトに反映されます。

Agent に付ける Playbook と Skill の下書きも、チャットで頼めます。 「Playbook の下書き」「Skill の下書き」のカードが出て、「Playbook の画面で開く」「Skill の画面で開く」を押すと、作成の画面が下書きを入れて開きます(直したい自分の Playbook・Skill の名前を言って頼み、同じ名前の物が 1 つだけあれば、その編集の画面が開きます)。保存するまで登録も変更もされません。

どれも、開いた後は今の画面で確かめて保存するのは自分です。ほかの人の Agent は直せません(持ち主に直してもらいます)。工程や配置の直しは、プロジェクトの編集画面の「AI に相談」で行います。

取り違えやすいところ​

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

  • ガードレールで操作を止めたつもりになる。 ガードレールに「返信を自分で送信しない」と書いても、それは Agent への指示で、操作が止まる保証はありません。確実に止めたい操作は、実行ルールで禁止します(実行ルールガイド)
  • 1 つの Agent を直して、複数の業務を一度に壊す。 Agent の設定を変えると、その Agent を使っているすべてのプロジェクトに及びます。しかも Agent の変更は工程・周期の下書きとは別に保存され、下書きを破棄しても戻りません。プロジェクトごとに違う動きをさせたいなら、Agent を分けてください
  • プロジェクトを複製すれば Agent も分かれると思う。 自分の Agent は、複製したプロジェクトにも同じものが置かれます。 試すなら新しい Agent を作ります
  • サイクルで工程の並びを順序だと思う。 図で工程が並んでいても、サイクルではその並びは実行の順番ではなく、前の工程が終わるのも待ちません。段階をつなぐなら記録先の目印で表します。実行そのものを順に進めたいなら、ワークフローを選びます
  • 起動の設定を、作ったあとに確かめない。 AI(α版)が提案した時間トリガーは無効の状態で登録され、周期が提案されたサイクルは一時停止の状態で作られます。コピーでは、時間トリガーは無効になり、サイクルの巡回の周期は引き継がれません。動かしたいものが動くか、動かしたくないものが動かないかを、作ったあとに確かめてください(起動ガイド)

次に読むもの​