Ferramentas do Integration Connectors

As ferramentas de conexão podem ser usadas por um agente para realizar ações usando suas conexões configuradas nos Integration Connectors. Cada ferramenta de conector é configurada com uma única conexão e uma ou mais ações. Se necessário, várias ferramentas podem ser criadas para uma única conexão e agrupar diferentes ações para o agente usar.

A ferramenta de conector é compatível com os seguintes tipos de conector:

Crie uma conexão

Para criar uma conexão:

  • Navegue do Agent Builder até Ferramentas > Criar.
  • Selecione o tipo de ferramenta Conector de integração.
  • Selecione o tipo de conector escolhido.
  • Use o botão Criar conexão.

Isso vai levar você à criação de Integration Connectors com vários campos pré-preenchidos.

Como alternativa, acesse o Integration Connectors e siga as instruções para criar uma conexão.

Ações do conector

Para cada ferramenta de conector, há dois tipos de ações que podem ser disponibilizadas ao seu agente. Consulte Entidades, operações e ações para mais informações.

  1. Operações CRUD de entidades

    Cada uma das suas conexões tem "entidades" correspondentes aos objetos dessa fonte de dados. No BigQuery, são tabelas. No Salesforce, são objetos, como "Pedido" ou "Caso".

    É possível realizar operações CRUD em cada entidade:

    • Create: cria uma entidade com valores de campo especificados
    • Lista: pesquisa baseada em filtros de instâncias de entidade
    • Atualização: método baseado em filtro para alterar valores de campo de entidade
    • Excluir: exclui uma entidade
    • Get recupera uma única entidade usando o entityId

    Saiba mais sobre os detalhes das operações CRUD de entidades na documentação do Connectors.

  2. Ações específicas do conector

    Muitos conectores são compatíveis com uma ação 'ExecuteCustomQuery', que permite executar uma consulta SQL na fonte de dados, em que cada uma das entidades da fonte de dados pode ser referenciada como tabelas. Consulte esta lista para ver os conectores compatíveis.

    Outras ações variam de acordo com o tipo de conector. Por exemplo, consulte as ações do conector do BigQuery ou as ações do conector do Salesforce.

Configurar campos de entrada / saída para operações CRUD

Ao selecionar campos de entrada ou saída específicos para a ação da ferramenta de conector usar, você pode limitar a complexidade dessas ações para o agente.

Por exemplo, se você só precisar criar uma entidade com um subconjunto de campos, configurar esse conjunto na ação simplifica o processo para o agente.

Especificar um conjunto de campos de saída reduz o tamanho da resposta da ferramenta (útil se os limites de token forem uma preocupação) e simplifica o processamento da saída pelo agente, expondo apenas os campos relevantes.

Autenticação

Se a conexão que você está usando estiver configurada para permitir a substituição de autenticação, a ferramenta poderá ser configurada para transmitir credenciais dos parâmetros de sessão especificados.

Você, como criador de agentes, é responsável por como essas credenciais são preenchidas nos parâmetros da sessão, e a ferramenta as transmite automaticamente para a fonte de dados para usar na autenticação quando as ações da ferramenta são chamadas.