# 連携ガイド

登録 Agent は、外部のサービスを使うことがあります。このガイドでは、**プロジェクトが何につなぎ、確認や結果をどこへ知らせるか**を扱います。外部への通信を許すかどうかは[実行ルールと通信ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/control-guide.md#%E5%A4%96%E3%81%B8%E3%81%AE%E9%80%9A%E4%BF%A1%E3%82%92%E7%B5%9E%E3%82%8B)にあります。

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

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

- **ワークフロー**: 工程の設定の「連携先」で、契約の接続 slot ごとに、このプロジェクトの連携先から選びます。選べるのは、管理者が slot に許可した連携先だけです。許可された連携先がこのプロジェクトに無いときは、先に設定の連携先で追加します（[エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md#%E5%B7%A5%E7%A8%8B%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC)）
- **サイクル**: 工程の設定で割り当てる枠はありません。このプロジェクトの連携先のうち、有効なもののトークンが、Agent に渡ります（[エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%81%A7-agent-%E3%81%AB%E6%B8%A1%E3%82%8B%E3%82%82%E3%81%AE)）

**ワークフローでは、連携先が使えないと、Agent は起動しません。** サイクルでは、使えない連携先のトークンは Agent に渡らず、Agent は起動します（起動の直前にトークンを取れなくなったときは、起動しません）。 「工程で選択した連携先が使用不可」「連携先の資格情報が無いか無効」などの理由は、実行記録に出ます（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E8%B5%B7%E5%8B%95%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%A8%E3%81%8D)）。**動かす前に、連携先の認証が切れていないか**を見てください。

**外部へ書き込む Agent の前に人の判断を挟みたいときは、その前に確認工程を置きます。**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md)）。

**外部条件待ちでは、確認工程の「観測に使用する連携先」を、このプロジェクトの連携先から選びます**。GitLab からの Webhook で早く進めるには、連携先の「外部条件待ちのWebhook秘密鍵」も入れます（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md#%E5%A4%96%E9%83%A8%E6%9D%A1%E4%BB%B6%E5%BE%85%E3%81%A1)）。

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

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

**確認の依頼と、確認期限の超過の知らせは、設定しなくても確認担当者へ届きます（既定はオンです）。** 製品の中の通知と、ブラウザのプッシュ通知と、メールです。プッシュは、そのブラウザで通知を許可（購読）している人にだけ届きます。オーナーがその出来事をオフにしたとき、本人が自分の通知の設定でプッシュやメールを止めているときは、その分は届きません。確認担当者が任せた期間中の代理人にも、製品の中の通知と、専用リンク付きのメールが届きます。送るメールには、管理コンソールの「お知らせと通知」＞「通知設定」＞「メールプロバイダー設定」のタブで決めた送信手段と送信元が使われます。**メールプロバイダーが設定されていないと、メールは送られません**（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md#%E6%9C%9F%E9%99%90%E3%81%A7%E3%81%AF%E6%B1%BA%E3%81%BE%E3%82%89%E3%81%AA%E3%81%84)）。

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

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

## 通知を止める

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

- 確認の依頼・催促・超過の知らせの宛先は、確認担当者です（最後の催促は、期限超過時の連絡先にも送ります）
- 「実行の締め切り超過」と「実行の停滞」は、プロジェクトのオーナー全員に届きます（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E7%B7%A0%E3%82%81%E5%88%87%E3%82%8A%E3%81%A8%E5%81%9C%E6%BB%9E%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC)）

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

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

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

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

**ワークフローは、案件が完了で閉じたときに届きます。** **サイクルでは、結果の通知が届くのは、Agent が完遂を報告した実行だけで、同じ配置では、時刻の 1 時間ごとの区切りに 1 回までです。** 「実行終了 (完遂は未計測)」の実行には届きません（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%81%AE%E7%B5%90%E6%9E%9C%E5%AE%9F%E8%A1%8C%E7%B5%82%E4%BA%86-%E5%AE%8C%E9%81%82%E3%81%AF%E6%9C%AA%E8%A8%88%E6%B8%AC)）。

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

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

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

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

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

## 取り違えやすいところ

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

## 次に読むもの

- [エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md) — 連携先の割り当てと、Agent に渡るトークン
- [確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md) — 確認の通知と、外部条件待ち
- [記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md) — 起動できなかった理由
