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

OperatorでData Connectorsを構築・修正する

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

対応者:Dawn P

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やその提案を見ることはありません。


既存のData Connectorsをテストする

既存のコネクタを変更せずにOperatorにテストを依頼することもできます。APIの変更後などに正常に動作するかを素早く確認する方法です。

  1. Operatorチャットで、Operatorにコネクタのテストを依頼します。例えば、「ライブのData Connectorsをテストしてください」や「Order lookupコネクタをテストしてください。」

  2. Operatorは各コネクタの送信予定値を表示したTest 「connector name」カードを表示します。保存されたテスト値を再利用するには、Operatorに保存値を使うよう指示してください。独自の値を指定することも可能です。

  3. 実行したいカードでRun testをクリックし、スキップする場合はCancelをクリックします。

  4. 結果はチャットに表示されます。例えば「Test passed (HTTP 200)」や「Test failed (HTTP 500)」です。失敗したテストは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が返すトークンや資格情報はマスクされます。

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