メインコンテンツにスキップ

OperatorでData Connectorsを構築および修正する

OperatorにチャットからData Connectorsの作成、テスト、修正を依頼し、すべての変更は反映前にレビューされます。

対応者:Dawn Perrott

Data Connectorの設定は通常、APIドキュメントを読み、すべてのフィールドを手動で入力することを意味します。Operatorを使うと、Finが参照または更新する内容を説明するだけで、Operatorが新しいコネクターを作成したり、動作しないものを修正したりします。この記事では、Operatorが設定できる内容、提案のレビューとテスト方法、注意すべき制限事項を学べます。

すべての変更は提案として届きます。あなたがレビューし、各テストコールを承認し、公開するかドラフトとして保存するかを選択します。Operatorは単独でコネクターを変更したりAPIを呼び出したりできません。

注意:OperatorはProアドオンに含まれています。OperatorとチャットするにはCan access Fin Operator権限が必要です。コネクターの変更を適用するには、Fin AI Agent & Automation権限とCan access Developer Hubも必要です。

Data Connectorsが初めての場合は、Data Connectorsの設定方法から始めてください。


OperatorでData Connectorを構築または修正する方法

最初のリクエストから公開されたコネクターまで、すべてのプロセスは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”というタイトルのカードで送信予定の値を表示します。

  1. 値を確認してください。Run testをクリックするまで何も送信されません。Cancelで停止します。

  2. テストは実際のAPIを呼び出します。結果は「Test passed (HTTP 200)」や「Test failed (HTTP 401)」のように表示されます。

  3. 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は顧客のメールアドレスなどのIntercom属性をデータ入力として追加するのではなく、直接リクエストに入れます。これが推奨設定です。Operatorが追加するすべてのデータ入力はFinが顧客から収集する値です。


既知の制限事項

  • Operatorクレジット — Operatorチャットは他のOperator作業と同様にOperatorクレジットを使用します。

  • すべての変更はあなたが適用する — Operatorはコネクターを自動で公開、保存、削除できません。

  • テストは実際のリクエストを送信する — コネクターがデータを作成、更新、削除する場合、テストによって接続システムに変更が加わります。テスト用レコードを使用してください。

  • トークン — Operatorは認証トークンの値を見られず、トークンの作成、編集、削除もできません。認証設定で新しいトークンを追加し、Operatorに付けるよう依頼してください。APIキーはURLや本文ではなくトークンに保持してください。OperatorはURLや本文を読み取れます。

  • 適用は未公開ドラフト編集を置き換える — Operatorはライブ版に基づいて変更を作成します。公開またはドラフト保存で適用すると、それ以降にエディターで行われたドラフト編集は置き換えられます。先に自分のドラフト編集を公開または破棄してください。

  • ライブコネクターは削除できない — Operatorはドラフトまたは一時停止中のコネクターのみ削除可能です。ライブコネクターを削除するには、まず設定で一時停止してください。Operatorはコネクターの一時停止、再開、複製、アーカイブ、以前のバージョンへのロールバックはできません。

  • MCPコネクター — OperatorはMCPサーバー由来のコネクターを編集、テスト、削除できません。MCPサーバーの設定で管理してください。

  • テンプレートなし — Operatorはテンプレートからコネクターをインストールできません。

  • 入力タイプ — Operatorは静的入力値やリスト・オブジェクト入力タイプを追加できません。

  • リリース — Operatorのコネクター変更は直接コネクターに適用されます。Fin Releaseに追加できません。

  • Finプレビュー — OperatorがFinにテスト質問をする際、Finは保存されたテストレスポンスやモックを使用し、APIは呼び出しません。削除保留中はプレビューされず、テストレスポンスやモックがない変更は何も返しません。

コネクターが公開後に会話で失敗した場合は、Data Connectorエラーの理解を参照してください。


よくある質問

なぜPublishボタンが無効なのですか?

変更の最新バージョンに合格したテストがありません。URL、メソッド、ヘッダー、本文、入力、認証トークンの変更は以前のテストをクリアします。Operatorにテスト実行を依頼するか、モックレスポンスを使用してください。ドラフト保存は常に可能です。

なぜコネクターが会話で動作しているのにテストが401で失敗するのですか?

テストはエンドユーザーのIDを持たないため、顧客の身元を確認するコネクターはテストに合格できません。USERタイプのトークンは静的テスト値を送信します。

Operatorは私のコネクターで何を見ていますか?

Operatorは認証トークンの値を見ません。URL、本文、コードブロックはDeveloper Hubと同様に完全に見え、ヘッダー値は最初の4文字のみ見えます。テストレスポンスでは、APIが返すトークンや資格情報はマスクされます。

こちらの回答で解決しましたか?