Integration Connectors 工具

代理可以使用连接器工具，通过在集成连接器中配置的连接来执行操作。每个连接器工具都配置有单个连接和一个或多个操作。如果需要，您可以为单个连接创建多个工具，以便将不同的操作分组在一起供代理使用。

连接器工具支持以下连接器类型：

创建连接

如需创建连接，请执行以下操作：

  • 从代理构建器前往工具 > 创建
  • 选择集成连接器工具类型
  • 选择您所选的连接器类型
  • 使用创建连接按钮。

这会将您引导至 Integration Connectors 创建页面，其中预先填充了多个字段。

或者，您也可以前往“Integration Connectors”，然后按照创建连接的说明操作。

连接器操作

对于每个连接器工具，您可以为代理提供两种类型的操作（如需了解详情，请参阅实体、操作和动作）：

  1. 实体 CRUD 操作

    每个连接都有与相应数据源的对象对应的“实体”（对于 BigQuery，这些是表；对于 Salesforce，这些是对象，例如“订单”或“支持请求”）。

    您可以对每个实体执行 CRUD 操作：

    • 创建：创建具有指定字段值的实体
    • 列表：基于过滤条件的实体实例搜索
    • 更新：一种基于过滤条件的方法，用于更改实体字段值
    • 删除：删除实体
    • Get 使用 entityId
      检索单个实体

    如需详细了解实体 CRUD 操作，请参阅连接器文档。

  2. 连接器专用操作

    许多连接器都支持 'ExecuteCustomQuery' 操作，该操作允许针对数据源执行 SQL 查询，其中每个数据源实体都可以作为表进行引用。如需查看支持的连接器，请参阅此列表。

    其他操作因连接器类型而异 - 例如，请参阅 BigQuery 连接器操作或 Salesforce 连接器操作。

为 CRUD 操作配置输入 / 输出字段

通过为连接器工具操作选择要使用的特定输入或输出字段，您可以限制代理的这些操作的复杂性。

例如，如果您只需要创建具有部分字段的实体，则在操作中配置这组字段可简化代理的操作。

指定一组输出字段可减小工具响应的大小（如果担心令牌限制，这会很有用），并且仅公开相关字段，从而简化代理对输出的处理。

身份验证

如果您使用的连接配置为允许身份验证替换，则可以将该工具配置为从指定的会话参数传递凭据。

作为代理构建者，您负责将这些凭据填充到会话参数中，并且当调用工具的操作时，该工具会自动将这些凭据传递给数据源以用于身份验证。