Project
プロジェクトは、Agent と工程を束ねて業務を進める機能です。工程ごとに、どこまで Agent に任せるかを決められます。ワークフローでは人が判断する工程を置けば、そこで一度止めて確認できます。実行した内容は、あとから 1 件ずつたどれます。
業務への組み込みを考えるなら設計ガイドの「業務として決めること」から、動かしている業務を見直すなら記録ガイドの「実績から見直す」から読んでください。
仕組みを理解する
中で何が起きているかを先に押さえる。
→小さく動かして確かめる
読んだことを手で試す。
→業務に合わせて設定する
どちらを選ぶべきか、判断の基準を示す。
→迷ったときに参照する
上限・既定値と、画面の言葉の対応。
→プロジェクトの構成
プロジェクトには工程があり、工程には Agent を置きます(Agent を置かない工程もあります。確認工程・外部の自動化・条件分岐)。Agent には、やることを書いたゴール(指示)と、やってはいけないことを書いたガードレールを持たせ、Playbook と Skill を付けます。人が判断する工程には Agent を置きません。確認担当者が、直前の工程の出力を見て決めます。1 件ごとの実行記録に、何をしたかが残ります。
| 言葉 | 意味 |
|---|---|
| プロジェクト | 工程と Agent をまとめる単位。タグで分類できる |
| 工程 | Agent を置く場所。1 つの工程に複数置ける。確認工程・外部の自動化・条件分岐には置かない |
| Agent | 仕事をする担当。ゴール(指示)とガードレールで動き方を決め、Playbook と Skill を付ける。複数の工程やプロジェクトで使い回せる |
| Playbook | Agent に最大 1 つ付けられる段取り。繰り返す作業の手順を、各ステップの目的・ガイダンス・成功条件で書く。手順は Agent が依頼に応じて調整する |
| Skill | Agent に複数付けられる、個別の作業のやり方。やり方を書いた文書に、必要ならスクリプトなどのファイルを添えて登録する |
| 配置 | Agent を工程に置いた 1 つ 1 つ。同じ Agent を 2 つの工程に置けば、配置は 2 つ。サイクルでは周期もこの単位で決める |
| 確認工程 | 人が判断する工程。確認担当者が直前の工程の出力を見て、次の工程へ進める・差し戻す・却下するのいずれかを選ぶ(進めるときに出力を直すこともできる)。担当者に届く依頼は「確認依頼」 |
| 実行記録 | 実行 1 件の詳細。依頼・根拠・実行したこと・確認・結果をたどれる。実行の一覧は「実行履歴」、プロジェクト内の操作の記録は「記録 (証跡)」 |
| 実行ルール | Agent にどの操作まで許すかを決める設定。テナント全体で決めた実行ルールを受け継ぎ、プロジェクトでは厳しくする方向にだけ変えられる |
| 共通の記録先 | プロジェクトの Agent どうしが共通に読み書きする連携先。連携先に「共通の記録先にする」を付けて指定する。付けただけでは読み書きは起きず、何をどう読み書きするかは各 Agent のゴール(指示)が決める |
| 接続の確認 | 連携先に「接続時の確認」を設定したとき、Agent がその連携先を使う前に実行を止めて立てる確認依頼。承認すると起動し直す。ワークフローでもサイクルでも使える |
なお、Agent を作るときに Claw という言葉が出てきます。Claw は、会話に紐づけて決めた予定で実行する機能です。プロジェクトで使うものではなく、Agent を作るときの複製元としてだけ出てきます。複製されるのは内容だけで、時間などのトリガーは引き継がれません。
2 つの型
型はプロジェクトを作るときに選びます。後から変えられません。
| サイクル | ワークフロー | |
|---|---|---|
| 始まり方 | 置いた Agent ごとに周期を決めて、その周期で動く。Webhook やメールで動かすこともできる | 手動で始める。決めた時刻や外部 API、メールから始めることもできる。決めた時刻に始めるときは、どの工程から始めるかを選べる |
| 進み方 | Agent どうしは待ち合わせない。それぞれが自分の周期で動く | 1 件の実行が工程を順に進む。前の工程が終わってから次の工程に移る。途中でレーンに分かれて同時に進めることも、条件で通るレーンを選ぶこともできる |
| 終わり方 | 終わらない。止めるまで動き続ける | 1 件ごとに終わる(完了・却下・失敗・中断) |
| 向く仕事の例 | 届いた依頼を受け取って一次対応する。決まった間隔で状態を点検し、異常があれば知らせる | 申請を 1 件受けて、作業し、担当者の確認を通して仕上げる。月末に一度動かして、レポートを作って出す |
使い方の順序
業務を選ぶ
任せる範囲、業務としての終わり、結果の届け先を決める。
つなぎ先を決める
このプロジェクトで使う外部サービスを追加して、認証する。
任せ方を決める
工程を並べ、Agent を置き、許す操作の範囲を決める。
確認しながら使う
ワークフローなら確認工程で人が判断して次に進める。
実績で見直す
実績を見て、直す場所と確認の置き方を見直す。
それぞれの段階で読む場所です。
- 業務を選ぶ — どこまで任せるか、何ができたら終わりか、プロジェクトをどこで分けるか、結果をどこへ届けるか(設計ガイド)
- つなぎ先を決める — 連携ガイド
- 任せ方を決める — 型・工程・Agent(設計ガイド)、許す操作(実行ルールガイド)、始め方(起動ガイド)
- 確認しながら使う — 人の判断の置き方(確認ガイド)、誰がどこを見るか(記録ガイド)、人の手が要るものの片付け方(記録ガイド)、止め方(起動ガイド)
- 実績で見直す — 実績を読み、直す場所を選び、試してから反映し、業務としての終わりに照らして比べる(記録ガイド)
画面の場所
プロジェクトを開くとタブが並びます。「ワークフロー履歴」はワークフローだけなので、ワークフローでは 6 つ、サイクルでは 5 つです。
| タブ | 見るもの |
|---|---|
| 概要 | 上から、「プロジェクトの概要」(目的・工程・Agent の設定から AI が書いた、何をする業務かの説明。作れないときはプロジェクトの説明。どちらも無いときは出ない)、選んだ期間の「この業務の実行結果」(実行結果の文・指標(KPI)・日ごとの実行など)、工程と Agent の流れの図(「ワークフローの形」。右の列で、工程ごとの「基本情報」・「数値」・「最新の成果物」〈組織の運用の役割だけで開いた人には出ない〉を切り替える)、サイクルでは Agent ごとの直近 24 時間の帯、一番下に「プロジェクト情報」(1 行の要約。「すべて表示」で全部を開く)。進行中のワークフローの実行はワークフロー履歴で見る。目的・メンバーなどの基本情報と、起動・連携先(MCP, A2A)・登録Agent・人の確認・実行ルール・通知・記録と閲覧の設定は「プロジェクト情報」の「すべて表示」で開く |
| 実行履歴 | 実行の一覧。1 件を開くと実行記録。プロジェクト内の操作の記録(記録 (証跡))もここにある |
| ワークフロー履歴 | ワークフローの直近の実行。終わったものも並ぶ |
| 対応待ち | 人の手が要るものの一覧(確認待ち・期限超過・失敗・差し戻し待ち・巡回の失敗・実行の締め切り超過・停滞)。選んだ行をまとめて承認したり、期限を延ばしたりできる |
| ライブラリ | プロジェクトで共有するファイル。バージョンが残り、工程の Agent に渡せる |
| 設定 | 基本情報・トリガーと通知・連携先(MCP, A2A)・メンバー・実行ルール |
工程と Agent の編集は、タブとは別のエディタ画面で行います。オーナーには、プロジェクトの画面の上部に「編集」が出ます。
画面の言葉を 1 文ずつ説明した「用語集」は、プロジェクトの一覧の「自分のプロジェクト」に 1 件も並ばないとき(検索語を入れているときを除きます)と、設定 タブの「基本情報」の見出しの横と、「ホーム」の説明の行の横から開けます。最初の進め方を並べた「初めての流れ」のカードは、同じく「自分のプロジェクト」に 1 件も並ばないときの一覧と、「ホーム」にプロジェクトが 1 件も無いときと、作成から 7 日以内で、選んでいる期間に実行が 1 件も無いプロジェクトの概要に出ます(閉じると、そのブラウザでは出ません)。
プロジェクトは、外部 API からも使えます(外部 API のドキュメント)。
AI クライアントから使う
Claude Code・Codex・Claude に AGENTIC STAR のプラグインを入れると、話しかけるだけでプロジェクトを使えます。たとえば、次のように頼めます。
- 「毎朝 9 時に、社内向けのお知らせの下書きを作り、私が確認してから終わるワークフローを作って」
- 「最近うまくいかなかった実行の理由を調べて、直して」
- 「今朝の私の確認依頼を、中身を見て片付けて」
- 「直近 30 日の成功率を、プロジェクトごとに教えて」
プラグインの入れ方とつなぎ方は、AI クライアント接続ガイド(MCP) — プラグインで入れる を参照してください。AI が行える操作は、つないだアカウントやシステム連携にできることの範囲です。
仕組み
画面を見ても分からないことを、ここに集めています。設定を始める前に読んでください。
- プロジェクトと工程 — 工程は Agent を置く場所。確認工程には Agent を置かない。Playbook は段取り、Skill はやり方で、どちらも Agent に属する
- サイクルとワークフロー — サイクルは配置ごとに独立して動く。型は後から変えられない
- 誰が何を決められるか — 管理コンソールの役割とプロジェクトの役割は別。オーナーでも指名されていなければ(代理人でもなければ)確認を決定できない(Agent の結果から作られる確認依頼と接続の確認だけは、原則としてオーナー全員が担当者)
- 人の確認 — 確認工程は業務を次に進めるかを決める工程。Agent の実行を止める仕組みではない
- どこまで任せるか — 実行ルールは厳しくする方向にだけ使える。どこに効いて、どこからが利用者の責任か
- 記録と指標 — 実行記録は 5 つの問いで読む。Agentの完遂率は業務の成果ではない
クイックスタート
ガイド
- 設計ガイド — 業務として何を決め、どう分け、工程と Agent に何をどこまで任せるか
- 実行ルールガイド — Agent にどの操作まで許すか。全体の基本ルールをどう受け継ぎ、禁止操作をどう書くか
- 確認ガイド — 誰が、どこで判断するか。担当者の決め方と、期限が来たときの扱い
- 起動ガイド — いつ動かし、どう止めるか。決めた時刻、Agent ごとの周期、外部からの呼び出し、手動の使い分け
- 連携ガイド — 何につなぎ、どこへ知らせるか
- 記録ガイド — 結果をどう読み、実績からどこを見直すか
リファレンス
- 設定値リファレンス — 工程数・Skill 数・期限・時刻の書き方など、決まっている値の一覧
- 実行結果リファレンス — 表示される結果の意味と、Agentの完遂率の式
- 記録リファレンス — 記録に残る出来事、CSV の列、エクスポートに含まれるもの
- 用語リファレンス — 画面の言葉と、記録や設定に出てくる言葉の対応
- ロールリファレンス — オーナー・運用担当・メンバー・組織の運用の役割・組織管理者・システム管理者ごとに、できること