Criar e gerenciar Conexões de modelo

Conecte-se a uma lista selecionada de modelos básicos de fornecedores de hiperescala, como Amazon Bedrock, Google Vertex AI, Azure OpenAI, OpenAI e outros para integrar o potencial da IA generativa nas automações.

O administrador de automação cria e testa Conexões de modelo se conectando a modelos básicos e disponibilizando essas conexões para os desenvolvedores profissionais, que podem se conectar a elas ao criar Habilidades de IA. As Conexões de modelo são usadas em Habilidades de IA para enviar prompts e receber respostas dos modelos.

Além disso, o administrador de automação cria funções personalizadas e atribui essas Conexões de modelo para as funções personalizadas. Essas funções personalizadas são então atribuídas a usuários que podem acessar as Conexões de modelo.

Siga essas etapas para criar uma Conexão de modelo.

Pré-requisitos

O administrador de automação precisa dessas funções e permissões para criar e gerenciar Conexões de modelo para sua empresa.
  • Função: AAE_Basic, função personalizada de administrador de automação
  • Permissão: Bot Runner assistido
  • Configurações: O administrador de automação deve habilitar o Gerenciamento de dados de IA e marcar a caixa de seleção Permitir que usuários desabilitem logs em habilidades de IA.
    • Permitir que usuários com a licença Bot Creator desativem o registro de dados ao usar Habilidades de IA.

Veja Funções e permissões para consultar as permissões de função personalizada do administrador de automação.

Importante: Para se conectar a modelos externos de IA generativa no AI Agent Studio, você precisará trazer suas próprias licenças (BYOL), como chaves de API, chaves de acesso ou tokens, dos respectivos provedores de modelos.
Outros requisitos:
  • Para armazenar detalhes de autenticação em um cofre de credenciais, tenha essas informações em mãos. Consulte Armazenamento seguro de credenciais no Cofre de credenciais.
  • Para testar uma Conexão de modelo, é necessário estar conectado ao Agente de bot 22.60.10 e mais recente. Como parte do teste, é necessário executar o bot na sua área de trabalho. Portanto, certifique-se de que o Agente de bot esteja configurado para seu usuário. Para esta tarefa, se você tiver que mudar a conexão para uma outra Control Room, consulte: Alternar o registro do dispositivo entre instâncias da Control Room.
  • Você precisa de acesso aos pacotes Gravador e Habilidades de IA para testar a conexão. Um Prompt de teste deve ser executado para testar a Conexão de modelo.
Analise, na tabela a seguir, considerações importantes sobre proxy ao usar a Conexão de modelo:
Tipo de proxy Descrição Status
Autenticado Mesmas configurações de proxy para URL da Control Room e endpoints da API Conexão de modelo Compatível
Credenciais de proxy diferentes para URL da Control Room e endpoints da API Conexão de modelo Incompatível
Ignorar proxy autenticado para URL da Control Room e configurações de proxy autenticado para endpoints da API Conexão de modelo Incompatível
Não autenticado Mesmas configurações para URL da Control Room e endpoints da API Conexão de modelo Compatível
Configurações de proxy distintas para o URL da Control Room e endpoints da API Conexão de modelo Compatível
Combinação entre autenticado e não autenticado Proxy autenticado para URL da Control Room e configurações de proxy não autenticado para endpoints da API Conexão de modelo Compatível
Proxy não autenticado para URL da Control Room e configurações de proxy autenticado para endpoints da API Conexão de modelo Incompatível
Nenhum Nenhum proxy encontrado na máquina do Bot Runner Compatível

Procedimento

  1. No ambiente da Control Room, navegue para IA > Conexões de modelo e clique em Criar conexão de modelo.
  2. Na tela Criar conexão de modelo, você pode definir estas Configurações de conexão:
    Criar Conexões de modelo
    1. Nome da conexão do modelo: Forneça um nome para fácil identificação da Conexão de modelo.
    2. Descrição (opcional): Adicione uma breve descrição que defina a conexão.
    3. Escolha um fornecedor: Escolha um fornecedor de modelo básico na lista de fornecedores compatíveis, como Automation Anywhere, Amazon Bedrock, Google Vertex AI, Azure OpenAI ou OpenAI.
    4. Escolha um tipo: Depois de selecionar um modelo na lista suspensa, o campo Escolha um tipo é exibido. Selecione o tipo de modelo que você deseja conectar na lista suspensa.
      Nota: Se a Automation Anywhere for selecionada como o fornecedor e quando o tipo estiver definido como Padrão, a seção Detalhes de autenticação mudará para Selecionar região.
    5. Escolha um modelo: Escolha um modelo na lista suspensa. A lista exibe modelos relevantes de acordo com sua seleção de fornecedor.
      Para obter uma lista completa dos modelos suportados por cada fornecedor de modelo básico, consulte Perguntas frequentes gerais.
    6. Clique em Avançar.
  3. Realize uma das seguintes opções:
    1. Modelos fornecidos pela Automation Anywhere - Para modelos do tipo Automation Anywhere - Padrão, você precisa Selecionar região. As regiões disponíveis são Estados Unidos e Europa. Se a implantação for na região dos EUA, você ainda poderá direcionar o tráfego para a região da UE por motivos de conformidade ou outros. Se não houver uma região específica para uma implantação, você pode optar por fazer o roteamento pelos Estados Unidos ou pela Europa.
      Nota: Esses modelos estão hospedados na infraestrutura em nuvem da Automation Anywhere.
    2. Na seção Detalhes de autenticação, defina as configurações dos parâmetros, que variam de acordo com o modelo escolhido ao definir a Conexão de modelo.
      Nota: Para obter detalhes de autenticação de cada modelo, consulte Autenticar conexões de modelo.
  4. Na seção Detalhes de autenticação, defina as configurações dos parâmetros, que variam de acordo com o modelo escolhido ao definir a Conexão de modelo.
    Nota: Para obter detalhes de autenticação de cada modelo, consulte Autenticar conexões de modelo.
  5. Clique em Avançar para ir para a seção Testar conexão a fim de testar a Conexão de modelo.
  6. Clique em Testar conexão para garantir que todos os detalhes da conexão tenham sido definidos corretamente e verificar se a conexão está funcionando.
    Esta é uma operação de desktop usando um Agente de bot. Use o Agente de bot 22.60.10 e mais recente para testes bem-sucedidos.
    • Se a conexão funcionar conforme o esperado, o sistema processará a solicitação e você receberá uma mensagem de sucesso gerada pelo sistema.
    • Se a conexão não funcionar conforme o esperado, você receberá uma mensagem gerada pelo sistema informando o motivo da falha na conexão. Por exemplo, se você não tiver baixado o pacote do modelo básico compatível para o seu espaço de trabalho, receberá uma mensagem de erro. Será necessário baixar o pacote e testar a Conexão de modelo de novo.
    • Se o teste de uma Conexão de modelo não tiver êxito ou se você deixar a tarefa incompleta, a Conexão de modelo não será salva e você terá que reiniciar o processo de criação da Conexão de modelo.
  7. Clique em Avançar para ir para a seção Convidar funções e começar a atribuir funções personalizadas aos usuários.
    O administrador de automação pode criar funções personalizadas e atribuir as Conexões de modelo à função, que pode ser atribuída aos usuários. Apenas usuários atribuídos a essa função personalizada podem usar essa Conexão de modelo.

    Criar conexão de modelo — Convidar funções

  8. Atribua acesso ao desenvolvedor profissional por meio de função personalizada (usando RBAC), para usar esta Conexão de modelo e criar uma Habilidade de IA.
  9. Clique em Criar conexão de modelo para concluir a criação da Conexão de modelo.
    Após a criação da Conexão de modelo, o desenvolvedor profissional a usaria para criar uma Habilidade de IA

    Ver Criar Habilidades de IA.

  10. Você receberá uma mensagem de sucesso gerada pelo sistema informando que a Conexão de modelo foi criada. Você será direcionado para a tela das Conexões de modelo que exibe uma lista de Conexões de modelo.
  11. Você pode Exibir conexão, Editar conexão, Alterar status ou Excluir cada conexão clicando nas reticências ao lado delas.
    Ações de Conexão de modelo
    Ações Função
    Exibir conexão

    Os Detalhes da conexão oferecem uma visão resumida do modelo.

    Os Detalhes gerais são exibidos quando a conexão for modificada pela última vez e por quem.

    O administrador de automação pode editar a Conexão de modelo desta visão.
    Alterar status
    A Conexão de modelo é criada com o status Disponível. O administrador de automação pode alterar o status de uma Conexão de modelo para qualquer um dos seguintes:
    • Disponível: a Conexão de modelo pode ser usada para criar novas Habilidades de IA e executar as existentes.
    • Acesso limitado: a Conexão de modelo está disponível para executar existentes, mas não é possível adicionar a novos.
    • Desabilitado: Novos Habilidades de IA não podem ser criados usando essas Conexões de modelo. Todas as execuções de automação existentes que usarem essas Conexões de modelo falharão.
    Editar conexão Permite editar os detalhes da Conexão de modelo.
    O botão Editar está ativado apenas para o administrador de automação.
    Nota: Usuários, como desenvolvedor profissional e desenvolvedor cidadão, com permissão para AI STUDIO > Exibir conexões de modelo, podem ver detalhes da Conexão de modelo, mas não podem editá-las.
    Excluir

    Clicar em Excluir exibe uma mensagem solicitando a confirmação e em seguida exclui a Conexão de modelo. Você receberá uma mensagem de confirmação da exclusão.

    Se você excluir uma Conexão de modelo, todas as Habilidades de IA referenciando a Conexão de modelo excluída não se conectarão ao modelo básico, o que pode fazer com que todas as automações que usam as Habilidade de IA não sejam executadas.

    O botão Excluir está ativado apenas para o administrador de automação.
    Nota: Usuários, como desenvolvedor profissional e desenvolvedor cidadão, com permissão para Conexões de modelo > Exibir conexões de modelo, podem ver detalhes da Conexão de modelo, mas não podem excluí-la.

Próximas etapas

Depois de criar e testar a Conexão de modelo, ela é atribuída aos desenvolvedores profissionais, que usa essa conexão para criar Habilidades de IA. Ver Criar Habilidades de IA
Nota:
Ao criar, testar, editar ou excluir uma Conexão de modelo, os detalhes de sucesso ou falha, juntamente com as respostas do modelo, são capturados como logs e podem ser visualizados nestas telas de navegação:
  • Administração > Governança de IA > Log de prompt de IA
  • Administração > Governança de IA > Log de eventos
  • Administração > Log de auditoria
Consulte Governança de IA.

Como o próximo passo na sua sequência de tarefas, vá para Criar Habilidades de IA para criar uma Habilidade de IA e conectar-se a uma Conexão de modelo e, então, usá-la em uma automação.