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 conexão é 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 para agrupar diferentes ações para o agente usar.

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

Crie uma conexão

Para criar uma conexão, faça o seguinte:

  • Navegue do criador de agentes 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 navegar até a criação de Integration Connectors com vários campos pré-preenchidos.

Como alternativa, você pode navegar até Integration Connectors e seguir 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 para o agente (consulte Entidades, operações e ações para mais informações):

  1. Operações CRUD de entidade

    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:

    • Criar: cria uma entidade com valores de campo especificados
    • Listar: pesquisa baseada em filtros de instâncias de entidades
    • Atualizar: método baseado em filtros para alterar valores de campo de entidade
    • Excluir: exclui uma entidade
    • Receber : recupera uma única entidade usando o entityId

    Saiba mais sobre os detalhes das operações CRUD de entidade na documentação dos conectores.

  2. Ações específicas do conector

    Muitos conectores oferecem suporte a uma 'ExecuteCustomQuery' ação, 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 de 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.

Como 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, a configuração desse conjunto de campos na ação simplifica a ação para o agente.

A especificação de 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 da autenticação, a ferramenta poderá ser configurada para transmitir credenciais de parâmetros de sessão especificados.

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