Gerenciar Conexões de modelo

Conecte-se a uma lista selecionada de modelos básicos de fornecedores de hiperescala, como Amazon Bedrock, Vertex AI do Google, 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 disponíveis para os desenvolvedores profissionais, que podem se conectar a elas ao criar Modelos de prompt. As Conexões de modelo são usadas em Modelos de prompt 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 estas 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: Executor de bots assistidos

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

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 Conexão de modelo, é necessário estar conectado a um Agente de bot (v22.60.10 e superior). 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 Modelo de prompt de IA generativa para testar a conexão. Um Prompt de teste deve ser executado para testar a Conexão de modelo.

Procedimento

  1. No ambiente da Control Room, navegue para Gerenciar > 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
    • Configurações de conexão:
      • Nome da conexão do modelo: Forneça um nome de conexão.
      • Descrição (opcional): Adicione uma breve descrição que defina a conexão.
      • Escolha um fornecedor: Escolha um fornecedor de modelo básico na lista de fornecedores compatíveis. No momento, oferecemos suporte para Amazon Bedrock, Vertex AI do Google, Azure OpenAI, OpenAI e outros modelos.
      • Depois de selecionar um modelo na lista suspensa, o campo Escolha um modelo é exibido. Selecione na lista de modelos disponíveis.
      • Após concluir a inserção de valores para todos os parâmetros da seção Configurações de conexão, clique em Avançar para ir para a seção Detalhes de autenticação.
    • Detalhes de autenticação:
      Os parâmetros de detalhes da autenticação variam conforme o modelo escolhido ao definir a conexão.
      Nota: Para obter detalhes de autenticação para cada modelo, consulte: Autenticar conexões de modelo.

      Depois de configurar os detalhes de autenticação, Confirme e clique em Avançar para prosseguir para a seção Testar conexão a fim de testar a Conexão de modelo.

    • Testar conexões:
      • 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.
      • 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 baixou o pacote do modelo básico compatível para o espaço de trabalho, você 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.
      • Clique em Avançar para começar a adicionar as funções personalizadas para os usuários.
    • Convidar funções:
      • Nessa fase, o administrador de automação começa a atribuir funções personalizadas aos usuários.

        Atribuir função personalizada aos usuários

        Nota: 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.
      • Após atribuir as funções, clique em Criar conexão de modelo para concluir a criação da Conexão de modelo.
    A Conexão de modelo é um sucesso
  3. 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.
  4. Você pode Exibir conexão, Editar conexão, Alterar status ou Excluir cada conexão clicando nas reticências ao lado delas.
    Ações do Conexão de modelo
    Ações Função
    Exibir conexão

    Os Detalhes da conexão fornecem 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 novos Modelos de prompt e executar os existentes.
    • Acesso limitado: A Conexão de modelo está disponível para executar Modelos de prompt existentes, mas não é possível adicionar isso a novos.
    • Desabilitado: Novos Modelos de prompt 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 Conexões de modelo > Exibir conexões de modelo, podem ver detalhes da Conexão de modelo mas não podem editá-los.
    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, todos os Modelos de prompt 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 os Modelos de prompt 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 exclui-los.

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 Modelos de prompt. Consulte Criar Modelos de prompt
Nota:

Ao criar, testar, editar ou excluir uma Conexão de modelo, os detalhes de sucesso ou falha das ações são capturados como logs e podem ser visualizados em Administração > Log de auditoria e Administração > Governança da IA.

Consulte Governança de IA.