Integration Connector ツール

コネクタツールは、エージェントが Integration Connectors で構成された接続を使用してアクションを実行するために使用できる各コネクタツールは、1 つの接続と 1 つ以上のアクションで構成されています。必要に応じて、1 つの接続に対して複数のツールを作成し、エージェントが使用するさまざまなアクションをグループ化できます。

コネクタ ツールは、次のコネクタ タイプをサポートしています。

接続を作成する

接続を作成するには:

  • エージェント ビルダーから [ツール] > [作成] に移動します。
  • [統合コネクタ] ツールタイプを選択します。
  • 選択したコネクタの種類を選択する
  • [接続を作成] ボタンを使用します。

これにより、いくつかのフィールドが事前入力された状態で、インテグレーション コネクタの作成ページに移動します。

または、Integration Connectors に移動して、接続を作成する手順に沿って操作することもできます。

コネクタ アクション

各コネクタ ツールには、エージェントが利用できる 2 種類のアクションがあります（詳細については、エンティティ、オペレーション、アクションをご覧ください）。

  1. エンティティの CRUD オペレーション

    各接続には、そのデータソースのオブジェクトに対応する「エンティティ」があります（BigQuery の場合はテーブル、Salesforce の場合は「Order」や「Case」などのオブジェクト）。

    各エンティティに対して CRUD オペレーションを実行できます。

    • 作成: 指定されたフィールド値でエンティティを作成します。
    • リスト: フィルタベースのエンティティ インスタンスの検索
    • 更新: エンティティ フィールドの値を変更するフィルタベースのメソッド
    • 削除: エンティティ
      を削除します
    • Get は、entityId
      を使用して単一のエンティティを取得します。

    エンティティの CRUD オペレーションの詳細については、Connectors のドキュメントをご覧ください。

  2. コネクタ固有のアクション

    多くのコネクタは 'ExecuteCustomQuery' アクションをサポートしています。このアクションを使用すると、データソースに対して SQL クエリを実行できます。ここで、各データソース エンティティはテーブルとして参照できます。サポートされているコネクタについては、こちらのリストをご覧ください。

    追加のアクションはコネクタのタイプによって異なります。たとえば、BigQuery コネクタのアクションや Salesforce コネクタのアクションをご覧ください。

CRUD オペレーションの入出力フィールドを構成する

コネクタ ツールの操作で使用する特定の入力フィールドまたは出力フィールドを選択することで、エージェントの操作の複雑さを軽減できます。

たとえば、フィールドのサブセットを含むエンティティのみを作成する必要がある場合、アクションでこのフィールドのセットを構成すると、エージェントのアクションが簡素化されます。

出力フィールドのセットを指定すると、ツールのレスポンス サイズが小さくなり（トークン上限が懸念される場合に役立ちます）、関連するフィールドのみが公開されるため、エージェントによる出力の処理が簡素化されます。

認証

使用している接続が認証のオーバーライドを許可するように構成されている場合、指定されたセッション パラメータから認証情報を渡すようにツールを構成できます。

エージェント ビルダーは、これらの認証情報をセッション パラメータに設定する方法を決定する必要があります。ツールの操作が呼び出されると、ツールは認証に使用するデータソースにこれらの認証情報を自動的に渡します。