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 disponíveis para os desenvolvedores profissionais, que podem se conectar a elas ao criar Habilidades de IA. 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 assistido
  • Configurações: Gerenciamento de dados de IA deve ser habilitado pelo administrador de automação e a caixa de seleção Permitir que os usuários desabilitem logs em habilidades de IA deve estar marcada. Permitir que usuários com a licença de Bot Creator desativem o registro de dados ao usar Habilidades de IA.

Veja Funções e permissões para Ferramentas de IA 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.

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 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 Padrão na lista suspensa.
    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 .
    6. Clique em Avançar para ir para a seção Detalhes de autenticação.
  3. 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. 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.
  5. 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 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.
  6. 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.

    Atribuir função personalizada aos usuários

  7. Atribua acesso ao desenvolvedor profissional usando a função personalizada (usando RBAC), para usar esta Conexão de modelo para criar uma Habilidade de IA.
  8. 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.

  9. 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.
    A Conexão de modelo é um sucesso
  10. Você pode Exibir conexão, Editar conexão, Alterar status ou Excluir cada conexão clicando nas reticências ao lado delas.
    Conexão de modelo ações
    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 novas Habilidades de IA e executar as existentes.
    • Acesso limitado: a Conexão de modelo está disponível para executar Habilidades de IA existentes, mas não é possível adicionar a novas.
    • 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 as Habilidades de IA que fazem referência à 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 usam essa conexão para criar Habilidades de IA . Consulte 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, usar em uma automação.