Criar e gerenciar Model connections

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 generative AI nas automações.

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

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

Siga essas etapas para criar uma Model connection.

Pré-requisitos

O administrador de automação precisa dessas funções e permissões para criar e gerenciar Model connections 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 Credential Vault.
  • Para testar uma Model connection, é necessário estar conectado ao Bot Agent 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 Bot Agent 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 Recorder e AI Skills para testar a conexão. Um Prompt de teste deve ser executado para testar a Model connection.

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 Model connections
    1. Nome da conexão do modelo: Forneça um nome para fácil identificação da Model connection.
    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 Model connection.
      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 Model connection.
    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 Model connection.
  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 Bot Agent. Use o Bot Agent 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 Model connection de novo.
    • Se o teste de uma Model connection não tiver êxito ou se você deixar a tarefa incompleta, a Model connection não será salva e você terá que reiniciar o processo de criação da Model connection.
  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 Model connections à função, que pode ser atribuída aos usuários. Apenas usuários atribuídos a essa função personalizada podem usar essa Model connection.

    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 Model connection e criar uma AI Skill.
  9. Clique em Criar conexão de modelo para concluir a criação da Model connection.
    Após a criação da Model connection, o desenvolvedor profissional a usaria para criar uma AI Skill

    Ver Criar AI Skills.

  10. Você receberá uma mensagem de sucesso gerada pelo sistema informando que a Model connection foi criada. Você será direcionado para a tela das Model connections 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 Model connection
    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 Model connection desta visão.
    Alterar status
    A Model connection é criada com o status Disponível. O administrador de automação pode alterar o status de uma Model connection para qualquer um dos seguintes:
    • Disponível: a Model connection pode ser usada para criar novas AI Skills e executar as existentes.
    • Acesso limitado: a Model connection está disponível para executar existentes, mas não é possível adicionar a novos.
    • Desabilitado: Novos AI Skills não podem ser criados usando essas Model connections. Todas as execuções de automação existentes que usarem essas Model connections falharão.
    Editar conexão Permite editar os detalhes da Model connection.
    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 Model connection, mas não podem editá-las.
    Excluir

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

    Se você excluir uma Model connection, todas as AI Skills referenciando a Model connection excluída não se conectarão ao modelo básico, o que pode fazer com que todas as automações que usam as AI Skill 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 Model connection, mas não podem excluí-la.

Próximas etapas

Depois de criar e testar a Model connection, ela é atribuída aos desenvolvedores profissionais, que usa essa conexão para criar AI Skills. Ver Criar AI Skills
Nota:
Ao criar, testar, editar ou excluir uma Model connection, 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 AI Governance.

Como o próximo passo na sua sequência de tarefas, vá para Criar AI Skills para criar uma AI Skill e conectar-se a uma Model connection e, então, usá-la em uma automação.