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

要するに

Wrike の AI エージェントはトリガーされるとアクションを実行します。コメントの投稿、フィールドの更新、担当者／ステータス／日付の変更、アイテムの移動、メールの送信、Slack や Microsoft Teams での通知などが可能です。 1 つのエージェントに複数のアクションを追加（設定した順に実行）し、対象となるアイテムをフィルターし、更新先の場所を指定できます。

• 概要
• アクションテーブル
• カスタムフィールド書き込みルール
• アクションの詳細とプロンプト例
• アクションの対象場所
• 作業アイテムのフィルタリング
• 複数アクション
• ステータス変更を使用するタイミング
• 次は何？

概要

アクションは、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 アカウントを接続し、チャンネルを選択します。チャンネルはセットアップ時に固定されます。 メッセージには作業アイテムへのリンクが含まれ、アクティビティログに配信状況が記録されます。

制限事項: チーム内のチャンネルのみ（グループ DM 不可）、@メンション不可、スレッドメッセージ不可、アクションごとに 1 チャンネル。

アクションの対象場所

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

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

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

ヒント: AI エージェントをプロジェクトとタスクが混在するフォルダーに設定する場合、フィルターで対象のアイテム種別に絞り込みましょう。

複数アクション

複数アクションの動作:

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

プロンプトへの影響:

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

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

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

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

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

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

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

次は何？

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