AIエージェントのアクションリファレンス

要するに

AIエージェントは、作業アイテムの更新、作成、承認、アサイン、通知を自動化します。アクションは、設定可能なフィルターと対象を用いて順番に実行されます。連携とフィールド更新にはそれぞれ制限があり、遅延のあるワークフローには複数のエージェントが必要です。

• 概要
• アクションテーブル
• カスタムフィールド書き込みルール
• 「アイテムを作成」アクションでアイテムを作成する
  • アイテムの説明を整形する
  • ブループリントからアイテムを作成する
• マルチエージェント自動化でワークフローを一時停止する
• アクションの詳細とプロンプト例
• アクションの対象場所
• 作業アイテムのフィルタリング
• 複数アクション
• ステータス変更を使用するタイミング
• 次は何？

概要

アクションは、AI エージェントがトリガーされたときに何を行うかを定義します。エージェントごとに複数のアクションを追加できます。

アクションテーブル

カスタムフィールド書き込みルール

AI エージェントはこれらのカスタムフィールドタイプを更新できます: テキスト、単一選択、複数選択、数値、パーセント、通貨、データベースへのリンク、チェックボックス、日付、期間、人物。

• 読み取り専用（書き込み不可）: ミラーフィールドおよび計算／数式フィールド（コンテキストとしては読み取り可）。 
• AI エージェントのアクションでは、時間コンポーネントを含む日付フィールド（Wrike Labs 機能）はサポートされておらず、フィールドピッカーにも表示されません。エージェント保存後にその日付フィールドへ時間部分が追加された場合、そのアクションは実行のたびに失敗します。

アクションの詳細とプロンプト例

担当者を変更 - AI エージェントはユーザープロフィール属性（役職、部門、国、タイムゾーン、割り当てタスク数）およびグループ所属を参照できます。エージェントはタスク数を除き、ワークロードやキャパシティのデータにはアクセスできません。 （AI エージェントで作業アイテムを割り当てる を参照）

Link-to-Database レコードを選択:

• L2DB フィールドを変更 アクション: AI エージェントはデータベース全体を検索できます。列名ではなく値で検索します。
• その他のアクション: AI エージェントは現在選択されている値のみを参照します。

✅ 「その値を含むレコードを選択」
❌ 「列名が値であるレコードを選択」

開始／期限日を変更 – プロンプト例:

• 「ステータスが Blocked に変わったら、期限日を 5 営業日後ろ倒しにする。」
• 「必須フィールドがすべて入力されたら、開始日を今日に設定する。」

場所 - 2 つのモード:

• 場所へ移動: アイテムを現在のフォルダーから削除し、ターゲットフォルダーのみに配置します。
• 場所へ追加: アイテムを現在のフォルダーに残したまま、追加のフォルダーにも追加します。

プロンプト例:

• 「タスクの説明に legal、compliance、regulatory が含まれている場合、Legal Review フォルダーに移動する。」
• 「Priority が Critical に設定されたら、タスクを Urgent Queue フォルダーに追加する。」

重要: AI エージェントがアイテムを移動できるのは、ロケーションチップで明示的に参照したフォルダーのみです。任意の場所へ移動したり、新しいフォルダーを作成したりすることはできません。

承認フローを開始／管理 - サポートされる操作: 承認の作成、ドラフト承認の更新、承認者の追加／削除、作成者または担当者を承認者に設定、ユーザーチップでユーザー／グループを指定。

プロンプト例:

• 「ステータスが Ready for Review になったら、プロジェクトオーナーを承認者として承認を開始する。」
• 「Budget フィールドが 50,000 を超えたら、Finance Team ユーザーグループで承認を開始する。」

メールを送信 - セットアップ時にスペース管理者が Gmail または Outlook のアカウントを認証します。

AI エージェントは担当者のプライマリメール、作成者のメール、カスタムフィールドの値、タスクのタイトル/説明文、明示的なアドレス、合成ルール（例: "名 + ドット + 姓 + @contoso.com"）から宛先アドレスを判断できます。

AI エージェントは次の情報からアドレスを取得できません: フォロワー、セカンダリメールアドレス。

ヒント: 「プロジェクト状況を要約して担当者にメール送信」といった曖昧さのない表現を使用し、「担当者にプロジェクト状況をアップデート」などは避けてください。

重要: 1 つのメールアクションで複数の「To」受信者を指定できます。 CC／BCC、添付ファイル、セカンダリメール、フォロワーメールは使用できません。送信者は接続されたアカウントとして表示されます。

Slack で通知 - スペース管理者が Slack ワークスペースを接続し、チップでチャンネルを選択します。チャンネルはセットアップ時に固定されます。

重要: Slack ワークスペースの接続が必要です。ターゲットチャンネルには Slack アプリがインストールされている必要があります。 Wrike アプリ for Slack は Marketplace 承認済みですが、制限付きワークスペースでは管理者の事前承認が必要な場合があります。

制限事項: アクションごとに 1 チャンネルのみ、スレッド返信なし、Slack ユーザーへの @メンション不可。

Microsoft Teams で通知 - スペース管理者 が Teams アカウントを接続し、設定時に宛先（チャンネル、既存の 1:1 チャット、既存のグループチャット）を選択します。 1 つのアクションでチャットとチャンネルの両方に同時に投稿することもできます。メッセージには作業アイテムへのリンクが含まれます。

制限と機能:

• 対応宛先:
  • チャンネル（1 度に 1 つのチーム内）: 1 つのチーム内で複数のチャンネルを対象にできます。別々のチームのチャンネルへ投稿する場合は、チームごとに個別のアクションを追加してください。
  • 既存の 1:1 チャット
  • 既存のグループチャット
• 非対応: 新規チャットの作成、会議チャット、1 つのアクションから複数のチャットやチャンネルへの投稿、スレッド返信、@メンション、基本的な Teams マークダウンを超える高度な書式設定。
• メッセージの詳細: すべてのメッセージには必ず作業アイテムへのリンクが含まれます。

アクションの対象場所

更新を適用する場所を選択:

「アイテムを作成」アクションでアイテムを作成する

エージェントがトリガーされるたびに、Create item 1 アクションを使用して 1 つのアイテム（タスク、プロジェクト、または フォルダー）2 を作成します。アイテムをブループリントから作成するには、Create item from blueprint（このアクションのすぐ下にあります）を選択します。

アイテムの説明を整形する

このアクションは次のようなリッチテキストの説明をサポートします:

• 見出し
• チェックリスト
• 箇条書きリストおよび番号付きリスト
• テキストカラー

制限: テキストの配置およびカスタムフォントサイズには対応していません。 

プロンプト例:

• 「リクエストが送信されたら、要約の見出しと次のステップのチェックリストを含むプロジェクトを作成する。」
• 「新しいキャンペーンリクエストが届いたら、必要なアクションを番号付きリストでまとめたタスクを作成する。」

ブループリントからアイテムを作成する

1. エージェント設定時に Create item from blueprint 1 アクションを追加します。
2. ブループリントピッカーを開きます 2。
3. エージェントに使用させたいブループリントを選択します 3。
4. いつアイテムを作成するかをエージェントに指示するインストラクションを追加します 4。
5. アイテムを作成する場所を選択します 5。
6. Save 6 でエージェントを保存します。

エージェントはトリガーごとに 1 つのアイテムを作成し、選択したブループリントのすべてのサブタスクを含めます。

プロンプト例:

「リクエストが送信されたら、『Client Onboarding』ブループリントからプロジェクトを作成する。」

マルチエージェント自動化でワークフローを一時停止する

ヒューマンインザループのプロセスでは、自動化されたワークフローが、次に進む前にチームメンバーが不足している詳細を入力できるよう一時停止する必要が生じることがよくあります。単一のカスタムエージェントは実行途中で停止して同じセッション内で再開することはできませんが、イベント駆動型エージェントとスケジュール型のフォローアップエージェントを組み合わせることで、同等のロジックを実現できます。

エージェントの機能を理解する

• エージェントができること: 更新（フィールド変更など）に即座に反応する、または設定した時間ベースのスケジュールでタスクを実行する。
• エージェントにできないこと: 実行途中で一時停止する、遅延中にアクティブ状態を保持する、1 回の実行内で自動的に再開する。

代替アプローチ: マルチエージェント自動化

一時停止したワークフローを再現するには、2 つのエージェントを連携させて設定します:

1. トリガーベースのエージェント: ユーザーが必須のカスタムフィールドに入力したら即座に反応し、メインのワークフローをただちに継続させます。
2. スケジュールチェックエージェント: 指定した時間経過後（例: アイテム作成から 1 時間後）に実行されます。必須フィールドが未入力の場合、このエージェントがアイテムのステータスを自動で更新します。

設定チェックリスト

エージェントを設定する前に、次の要素を定義してください:

• 必須フィールド: データを格納する必要があるカスタムフィールド。
• 待機時間: スケジュールチェックを実行するまでの待機間隔。この設定用の専用 UI 要素は存在しないため、関連する要素とタイミングの詳細をすべてアクションの指示内に直接記載してください。
• 成功アクション: フィールドが期限内に入力された場合に実行されるステップまたはトリガー。
• タイムアウトアクション: 待機時間後もフィールドが空のままの場合に適用するステータス変更。

結果

このセットアップでは、一時停止した単一実行ではなく 2 つの個別トリガーを使用しますが、データの正確性を維持しながらヒューマンインザループの遅延を自動化することに成功しています。

作業アイテムのフィルタリング

各アクションにはフィルターピッカーがあります。アイテム種別、ステータス、担当者、カスタムフィールド、重要度、名前などで組み合わせてフィルターできます。条件に合致しないアイテムはエージェントクレジットを消費せずにスキップされます。アクションごとに設定します。

ヒント: AI エージェントがプロジェクトとタスクの両方を含むフォルダーに割り当てられている場合、フィルターを適用して該当する item type にアクションを限定してください。一般的な使用例: 完了済みの item を除外し、エージェントのアクションが無駄にならないようにする。

複数アクション

複数アクションの動作:

• アクションは独立しており、デフォルトでは 1 つのアクションの結果が他のアクションに影響を与えることはありません。
• 実行順序が保証されます - アクションは設定した順序どおりに実行されます。順次実行されるため、アクション B はアクション A が書き込んだ内容を読み取れます。ビルダーでアクションをドラッグ＆ドロップするだけで順序を設定できます。
• 各アクションには独自のインストラクションと対象があり、一般インストラクションは共有されます。
• 設定やログで識別しやすいように各アクションに名前を付けましょう（例: 「優先度を設定」、「チームにルーティング」、「概要を投稿」）。

プロンプトへの影響:

• 各アクションのプロンプトは単独で完結している必要があります。
• 「前のアクションが投稿したコメントを読んで」や「アクション 1 が成功したら…」といった記述は避けてください。
• 2 つのアクションが同じ値を必要とする場合、それぞれが同じ情報源から独立して計算してください。
• アクション B が本当にアクション A の出力を必要とする場合は、エージェントチェーンを使用してください（効果的なエージェントプロンプトの作成 を参照）。

複数アクションの好例: カテゴリーフィールドを設定してコメントを投稿、担当者を変更してステータスを更新、複数のカスタムフィールドを同時に更新など。

ステータス変更を使用するタイミング

• インテーク確認: 必須フィールドがすべて完了したら Ready に変更。
• 期限超過追跡: 期限を過ぎたら Overdue に設定。
• 依存関係検出: 依存関係が言及されたら Blocked に設定。
• プロジェクト完了: すべてのサブタスクが完了したら Complete に移動。

注意: エージェントはワークフローの遷移規則を順守し、必須ステータスを飛ばすことはできません。変更は理由とともにログに記録されます。ステータスがすでに正しい場合は、ログエントリーのみが作成されます。標準およびカスタムワークフローで機能します。

ステータス変更のプロンプト例:

• 「タスクが期限を過ぎ、ステータスが Completed でない場合、ステータスを Overdue に変更する。」
• 「タスクの 3 つの必須フィールドがすべて入力されたら」

次は何？

• AI エージェントで作業アイテムを割り当てる