注意： OperatorはProアドオンの一部として含まれています。使用するにはProアドオンが必要です。
データコネクターの設定は通常、APIドキュメントを読み、すべてのフィールドを手動で入力することを意味します。Operatorでは、Finが検索または更新する内容を説明すると、Operatorが新しいコネクターを作成するか、動作しないものを修正します。この記事では、Operatorが設定できる内容、提案のレビューとテスト方法、注意すべき制限について説明します。
すべての変更は提案として届きます。あなたがレビューし、各テストコールを承認し、公開するかドラフトとして保存するかを選択します。Operatorは単独でコネクターを変更したりAPIを呼び出したりできません。
注意： OperatorとチャットするにはCan access Fin Operator権限が必要です。コネクターの変更を適用するには、さらにCan manage Automation settings and inbound WorkflowsとCan manage data connectors and authentication tokensが必要です。
データコネクターが初めての場合は、Fin AI Agent用データコネクターの追加から始めてください。
Operatorでデータコネクターを構築または修正する方法
最初のリクエストから公開されたコネクターまで、すべてのプロセスはOperatorチャット内で行われます。
ステップ1：Operatorに依頼する
Operatorチャットで、Finが必要とする内容を説明します。例：
「Shopifyの注文番号で注文を検索するコネクターを作成してください。」
「Finが注文を見つけられないと言い続けます。Get Orderコネクターを修正できますか？」
ステップ2：Operatorが調査する
提案を出す前に、Operatorはワークスペース内を調べることができます：
コネクターを検索し、それぞれの完全な設定を読みます。
コネクターの保存されたテストレスポンスやモックレスポンスを読みます。
どのworkflowsや手順がコネクターを使用しているかを確認します。
最近の成功率や実行履歴をチェックします。送受信内容ではなく、ステータスとタイミングを確認します。
リクエストやマッピング対象として使用できる属性を一覧表示します。
認証トークンを名前とタイプで一覧表示します。秘密情報は見ません。
ステップ3：提案をレビューする
提案はチャット内にData connectorカードとして表示されます。
ヘッダーにはコネクター名とNew、Live、Draft、Pausedのバッジが表示されます。名前変更は旧名が取り消し線で示されます。
APIはメソッド、URL、データ入力、ヘッダー、ペイロード、テスト、認証トークンを表示します。
Dataはレスポンスフィールド、Pythonコード、オブジェクトマッピングを表示します。
FinはFinが読むプロンプトと対象ユーザーを表示します。
Securityは顧客認証設定を表示します。
編集の場合、カードはライブバージョンに対する変更点を示します。変更のないセクションは折りたたまれ、各セクションは追加・削除された行数を表示します。
認証トークンは名前のみ表示されます。
ステップ4：テストを承認する
テスト実行前に、OperatorはTest “connector name”というタイトルのカードで送信する値を表示します。
値を確認してください。Run testをクリックするまで何も送信されません。Cancelで停止します。
テストは実際のAPIを呼び出します。結果は「Test passed (HTTP 200)」や「Test failed (HTTP 401)」のように表示されます。
Operatorはレスポンスを読み取り、それを使ってレスポンスフィールドを設定します。
OperatorはFinにプレビュー会話でテスト質問をすることもできます。これは顧客が行うようにFinがコネクターを選択し、レスポンスをどう使うかを示します。プレビューでは、チャットの保留中のコネクター変更が適用されたかのようにFinが回答し、APIを呼び出さず保存されたテストレスポンスやモックを使用します。
重要：テストは接続されたシステムに実際のリクエストを送信します。コネクターがデータを作成、更新、削除する場合、テストもその変更を行います。テスト用レコードを使用してください。Operatorはテスト前に必ず承認を求めます。
ステップ5：変更を適用する
変更の反映方法を選択します：
ライブコネクターでは、メインボタンはPublishです。メニューにはSave as draft（ドラフトがある場合はUpdate draft）があります。
新規、ドラフト、または一時停止中のコネクターでは、メインボタンはSave as draft（またはUpdate draft）です。Publishはメニューにあります。
Publishは最初に「公開の準備はできていますか？」と尋ねます。Operatorのテストが合格するまで無効のままですが、モックレスポンスを使うコネクターは例外です。リクエスト（URL、メソッド、ヘッダー、本文、入力、認証トークン）を変更しない編集は、以前の合格テストを保持します。
削除の場合は赤いDeleteボタンと取り消せない警告が表示されます。
ゴミ箱アイコン（Discard change）は提案を破棄します。
Apply allはチャット内のすべての変更を適用します。新しいコネクターはドラフトとして反映され、編集は現在のライブまたはドラフト状態を維持します。
提案保留中に誰かがコネクターを編集した場合、カードに「この変更は古いバージョンに基づいています」と表示され、適用時に「新しい変更に上書きしますか？」と尋ねられます。Apply anywayをクリックすると新しい編集が上書きされます。
ステップ6：適用後
「変更が正常に適用されました」というメッセージが表示され、チャットログに「1件の変更を適用しました」と記録され、コネクターはPublishedまたはDraftとしてマークされます。適用されたすべての変更はチームメンバーのアクティビティログにも「Operator proposal applied」として表示されます。
公開された変更は手動で作成されたコネクターと同様に機能し、Finはすぐに会話で使用を開始します。ドラフトは公開されるまで会話に影響しません。顧客はOperatorやその提案を見ることはありません。
Operatorが設定できる内容
名前と説明 — チームメンバーはコネクター設定で説明を確認できます。
リクエスト — URL、メソッド、ヘッダー、本文。URLはHTTPSである必要があります。
データ入力 — Finが顧客から収集する値（例：注文番号）。各入力には名前、タイプ、説明があり、必須または任意が指定され、デフォルト値を持つこともあります。
認証トークン — Operatorは既存のトークンを付け外しできます。各トークンは独自のヘッダーとして送信されます。
レスポンスフィールド — テストレスポンスまたはモックレスポンスから構築されます。Finが見るフィールド、名前、形式、コード化された値の翻訳方法を決定します。Pythonコードブロックでレスポンスを変形することも可能です。
モックレスポンス — APIテスト前にレスポンスフィールドを構築するためのサンプルレスポンス本文。
オブジェクトマッピング — レスポンス値を会話、ユーザー、カスタムオブジェクト属性に書き込みます。
Finの使用方法 — Finがコネクターを自動選択できるか、使用タイミングを決めるプロンプト、書き込み可能か、セグメントから作成された対象ユーザー。
顧客認証 — Finが本人確認済み顧客のみにコネクターを呼び出すかどうか。
ヒント： Operatorは顧客のメールアドレスなどの顧客属性をデータ入力として追加するのではなく、直接リクエストに入れます。これが推奨設定です。Operatorが追加するすべてのデータ入力はFinが顧客から収集する値です。
既知の制限事項
Operatorクレジット — Operatorチャットは他のOperator作業と同様にOperatorクレジットを使用します。
すべての変更はあなたが適用する — Operatorはコネクターを自動で公開、保存、削除できません。
テストは実際のリクエストを送信する — コネクターがデータを作成、更新、削除する場合、テストも接続システムにその変更を行います。テスト用レコードを使用してください。
トークン — Operatorは認証トークンの値を見られず、作成、編集、削除もできません。認証設定で新しいトークンを追加し、Operatorに付けるよう依頼してください。APIキーはURLや本文ではなくトークンに保持してください。Operatorが読み取れます。
適用は未公開ドラフト編集を置き換える — Operatorはライブバージョンに基づいて変更を作成します。公開またはドラフト保存で適用すると、それ以降のドラフト編集は置き換えられます。先に自分のドラフト編集を公開または破棄してください。
ライブコネクターは削除できない — Operatorはドラフトまたは一時停止中のコネクターのみ削除可能です。ライブコネクターを削除するには、まず設定で一時停止してください。Operatorは一時停止、再開、複製、アーカイブ、以前のバージョンへのロールバックはできません。
MCPコネクター — OperatorはMCPサーバー由来のコネクターを編集、テスト、削除できません。MCPサーバーの設定で管理してください。
テンプレートなし — Operatorはテンプレートからコネクターをインストールできません。
入力タイプ — Operatorは静的入力値やリスト・オブジェクト入力タイプを追加できません。
リリース — Operatorからのコネクター変更は直接コネクターに適用されます。Fin Releaseには追加できません。
Finプレビュー — OperatorがFinにテスト質問をする際、Finは保存されたテストレスポンスやモックを使用しAPIは呼び出しません。保留中の削除はプレビューされず、テストレスポンスやモックがない変更は何も返しません。
設定リンク — チャットの「適用済み」リストでコネクター名は設定ページにリンクしません。代わりにデータコネクター設定から開いてください。
よくある質問
なぜPublishボタンが無効なのですか？
なぜPublishボタンが無効なのですか？
変更の最新バージョンに合格したテストがありません。URL、メソッド、ヘッダー、本文、入力、認証トークンの変更は以前のテストをクリアします。Operatorにテスト実行を依頼するか、モックレスポンスを使用してください。ドラフト保存は常に可能です。
なぜコネクターが会話で動作してもテストが401で失敗するのですか？
なぜコネクターが会話で動作してもテストが401で失敗するのですか？
テストはエンドユーザーのIDを持たないため、顧客を確認するコネクターはテストに合格しません。USERタイプのトークンは静的テスト値を送信します。
Operatorは私のコネクターで何を見ていますか？
Operatorは私のコネクターで何を見ていますか？
Operatorは認証トークンの値を見ません。URL、本文、コードブロックは完全に見ますが、ヘッダー値は最初の4文字のみです。テストレスポンスでAPIが返すトークンや資格情報はマスクされます。