Gerenciar Conexões de modelo (administrador de automação)

O administrador de automação configura e gerencia Conexões de modelo, cria funções e atribui usuários a funções em sua organização. Siga estas etapas para configurar uma Conexão de modelo.

O administrador de automação cria Conexões de modelo e as disponibiliza para os desenvolvedores profissionais se conectarem ao criar os Templates de prompt.

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ções:
    • Bot_Creator
    • Bot_Runner
    • AAE_Basic
  • Permissões e tarefas:
    • Habilitar/desabilitar cofre de credenciais
    • Gerenciar Conexões de modelo
      • Criar
      • Teste
      • Editar
      • Excluir
    • Criar funções personalizadas
    • Atribuir funções e permissões
    • Executar bots
    • Ler logs de auditoria
    • Habilitar ou desabilitar geração de logs de auditoria
    • Atribuir permissões de leitura de logs de auditoria aos usuários
Além das funções e permissões, você precisaria fazer o seguinte:
  • Baixar o pacote de IA generativa que será usado para criar a Conexão de modelo.
  • Para armazenar detalhes de autenticação em um cofre de credenciais, tenha essas informações em mãos.
  • Para testar uma Conexão de modelo, é necessário estar conectado a um Agente de bot (v22.31 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. 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 com sucesso. O Prompt de teste deve ser executado para testar a Conexão de modelo.

Procedimento

  1. No locatário 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 as configurações para os seguintes parâmetros:
    Criar conexão 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 o fornecedor da IA generativa entre as opções disponíveis. Atualmente, oferecemos suporte apenas para os fornecedores Microsoft Azure OpenAI e OpenAI.
      • Depois de selecionar um fornecedor na lista suspensa, o campo Escolha um modelo é exibido. Selecione na lista de versões 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 conexão variam conforme o fornecedor de IA generativa escolhido ao definir a conexão.
      • No Microsoft Azure, você deve definir detalhes de conexão para os campos Nome do recurso Azure OpenAI, ID da implantação e Chave de API.
        • Nome do recurso Azure OpenAI: Você pode ver esse valor na página Recurso do Microsoft Azure.
        • ID da implantação: Você pode ver esse valor na página Recurso do Microsoft Azure.
        Nota: Ver Configurar o Azure OpenAI
      • No OpenAI, você deve definir detalhes de conexão para a Chave de API.
      • Chave de API: Esse parâmetro de conexão é comum nos modelos LLM do Microsoft Azure e OpenAI.
        Nota: Consulte Arquitetura de segurança e Credenciais e cofres no Credential Vault para referência.
        • String insegura: Selecionar essa opção exibe uma mensagem de aviso mencionando que o valor fornecido neste campo não está criptografado. Recomendamos o uso de uma credencial.
        • Credencial: Recomendamos usar esta opção. Clique em Selecionar para selecionar os valores Cofre, Credencial e Atributo disponíveis na lista suspensa. Isso se baseia nas configurações mantidas na Control Room conectada para o gerenciador de credenciais.
      • 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 de IA generativa, receberá uma mensagem de erro. Será necessário baixar o pacote e testar a Conexão de modelo novamente.
      • 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 aos usuários

        Nota: O administrador de automação precisa criar funções personalizadas para as Conexões de modelo, que podem ser atribuídas aos usuários. Somente usuários atribuídos a essa função personalizada podem usar essas Conexões 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 do modelo é um sucesso
  3. Você receberá uma mensagem de sucesso gerada pelo sistema informando que suas Conexões de modelo foram criadas. Você será direcionado para a tela Conexões de modelo que exibe uma lista de Conexões de modelo.
  4. Você pode Excluir, Visualizar ou Editar cada conexão clicando nas reticências ao lado dela.
    • Se você clicar em Excluir, receberá uma mensagem solicitando sua confirmação para a exclusão. Após a exclusão, você receberá uma mensagem de confirmação.
      Nota: Usuários com permissão de visualização, como desenvolvedor profissional, desenvolvedor cidadão e usuário corporativo, poderão ver detalhes da Conexão de modelo, mas não a editar ou excluir.
    • Os botões Editar e Excluir estão habilitados para o administrador de automação, pois ele tem permissão para ambos.

Próximas etapas

Depois de criar e testar a Conexão de modelo, ela é atribuída aos desenvolvedores profissionais, que usa essas conexões para criar um Template de prompt.
Nota: Ao criar ou testar uma Conexão de modelo, os detalhes de sucesso ou falha podem ser visualizados em Administração > Log de auditoria. Ver Governança de IA