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

連携ガイド

登録 Agent は、外部のサービスを使うことがあります。このガイドでは、プロジェクトが何につなぎ、確認や結果をどこへ知らせるかを扱います。外部への通信を許すかどうかは実行ルールと通信ガイドにあります。

連携先は、このプロジェクトがつなぐ先​

登録 Agent は、契約で決めた接続先の枠(接続 slot)を通して、外部のサービスにつながります。 プロジェクトでは、その枠に、このプロジェクトの連携先を割り当てます。

  • ワークフロー: 工程の設定の「連携先」で、契約の接続 slot ごとに、このプロジェクトの連携先から選びます。選べるのは、管理者が slot に許可した連携先だけです。許可された連携先がこのプロジェクトに無いときは、先に設定の連携先で追加します(エージェントガイド)
  • サイクル: 工程の設定で割り当てる枠はありません。このプロジェクトの連携先のうち、有効なもののトークンが、Agent に渡ります(エージェントガイド)

ワークフローでは、連携先が使えないと、Agent は起動しません。 サイクルでは、使えない連携先のトークンは Agent に渡らず、Agent は起動します(起動の直前にトークンを取れなくなったときは、起動しません)。 「工程で選択した連携先が使用不可」「連携先の資格情報が無いか無効」などの理由は、実行記録に出ます(記録ガイド)。動かす前に、連携先の認証が切れていないかを見てください。

外部へ書き込む Agent の前に人の判断を挟みたいときは、その前に確認工程を置きます。(確認ガイド)。

外部条件待ちでは、確認工程の「観測に使用する連携先」を、このプロジェクトの連携先から選びます。GitLab からの Webhook で早く進めるには、連携先の「外部条件待ちのWebhook秘密鍵」も入れます(確認ガイド)。

画面上の場所 設定 タブ >「連携先(MCP, A2A)」。ワークフローの連携先の割り当ては、編集 > 工程の Agent を選び、右の「工程の設定」

確認の通知は、担当者へ届く​

確認の依頼と、確認期限の超過の知らせは、設定しなくても確認担当者へ届きます(既定はオンです)。 製品の中の通知と、ブラウザのプッシュ通知と、メールです。プッシュは、そのブラウザで通知を許可(購読)している人にだけ届きます。オーナーがその出来事をオフにしたとき、本人が自分の通知の設定でプッシュやメールを止めているときは、その分は届きません。確認担当者が任せた期間中の代理人にも、製品の中の通知と、専用リンク付きのメールが届きます。送るメールには、管理コンソールの「お知らせと通知」>「通知設定」>「メールプロバイダー設定」のタブで決めた送信手段と送信元が使われます。メールプロバイダーが設定されていないと、メールは送られません(確認ガイド)。

確認は、メールのリンクから開く確認の画面で決めます。

確認の期限を過ぎても、確認は自動では決まりません。 期限超過の知らせは、確認担当者(と、設定していれば期限超過時の連絡先)へ届き、案件はそのまま判断を待ちます。

通知を止める​

オーナーは、通知を出来事ごとにオン・オフに切り替えられます。 出来事は「確認の依頼」「確認期限の催促」「確認期限の超過」「実行の締め切り超過」「実行の停滞」です。オフにした出来事は、プッシュもメールも送られません。

  • 確認の依頼・催促・超過の知らせの宛先は、確認担当者です(最後の催促は、期限超過時の連絡先にも送ります)
  • 「実行の締め切り超過」と「実行の停滞」は、プロジェクトのオーナー全員に届きます(記録ガイド)

オーナーは、出来事を外の仕組みの URL へ送れます(外部へ送信する Webhook)。 URL は、外から届く HTTPS のものです。 送れる出来事は上の 5 つと「実行の終了」(案件が閉じたとき)です。送る中身は、出来事・プロジェクト・実行・確認依頼の ID と時刻・リンクだけです(「実行の終了」は閉じたときの状態も)。署名の秘密鍵を入れると、X-Agentic-Star-Signature ヘッダに HMAC-SHA256 の署名が付きます。届かなかったときは、1 分・5 分・30 分あけて 3 回まで送り直します。

画面上の場所 設定 タブ >「トリガーと通知」。外部へ送信する Webhook も同じ場所です

実行の結果を、自分で受け取る​

メンバーは、プロジェクトの実行が完了したときの知らせを、自分の分だけ受け取れます。 設定した人にだけ、現在もメンバーである間、プッシュとメールで届きます(本人の通知の設定でプッシュやメールを止めていると、その手段では届きません)。中身は、名前・終わった時刻・出力の最初の段落と、記録へのリンクです。

ワークフローは、案件が完了で閉じたときに届きます。 サイクルでは、結果の通知が届くのは、Agent が完遂を報告した実行だけで、同じ配置では、時刻の 1 時間ごとの区切りに 1 回までです。 「実行終了 (完遂は未計測)」の実行には届きません(記録ガイド)。

画面上の場所 設定 タブ >「トリガーと通知」>「結果の通知」の切り替え

送れたかどうかを確かめる​

確認の知らせのメールを送ろうとした結果は、その確認依頼の履歴に残ります。 ただし相手に届いたことの確認ではありません。 残るのは「通知を送信待ちに登録しました」「通知を送信しました」「通知を送信できませんでした」などです。届かないときは、まずこれを見てください。

コピーしたときの連携先​

プロジェクトをコピーすると、連携先の一覧は写されます。 接続(認証)は写されないので、コピーしたプロジェクトで連携先に接続し直します。

取り違えやすいところ​

  • 連携先を追加すれば、すべての Agent が使えると思う。 ワークフローでは、契約の接続 slot に、管理者が許可した連携先だけを割り当てられます
  • 外部への書き込みの前に止めるには、確認工程を置きます。 連携先の設定だけでは止まりません
  • 確認期限を過ぎたら自動で進むと思う。 進みません。期限超過を通知して待ちます
  • サイクルの「実行終了 (完遂は未計測)」でも結果の通知が届くと思う。 届きません

次に読むもの​