Como usar Model connections no Document Automation

Conecte qualquer LLM, incluindo modelos de código aberto, On-Premises ou personalizados ao Document Automation usando o recurso Model connections no AI Agent Studio.

Pré-requisitos

Certifique-se de que você possua a licença e as permissões necessárias. Para informações de configuração, consulte Criar e gerenciar Model connections.
Tarefa Licenças, funções e permissões
Exibir Model connections
Criar Model connections
  • Licença de executor de bots assistido
  • Função AAE_Basic
  • Permissões para Exibir conexões de modelo e Gerenciar conexões de modelo
(Opcional) Criar credenciais e cofres Todas as permissões na opção CREDENCIAIS

Você precisará dessas permissões se quiser armazenar e usar suas credenciais com segurança.
Importante: Se você estiver atualizando para a versão 39 ou posterior e utilizando BYOK para provedores de generative AI em suas instâncias de aprendizagem existentes, siga as etapas abaixo:
  1. Crie Model connections para o provedor de generative AI e, em seguida, utilize-o na instância de aprendizagem.
  2. Abra a action Extrair dados da instância de aprendizagem e defina Nenhum na opção Configurações adicionais.

Com as Model connections gerenciadas na Control Room, você pode acessar essas conexões sem precisar configurá-las toda vez. Consulte Conexões de modelo.

Você pode criar Model connections e utilizá-las em instâncias de aprendizagem criadas no Document Automation.

Procedimento

  1. Crie um Model connection. Consulte Criar e gerenciar Model connections.
  2. Use o Model connection criado em uma nova instância de aprendizagem ou em uma instância de aprendizagem existente.
    • Nova instância de aprendizagem
      1. Clique em Criar nova.
      2. Na tela de configuração Criar instância de aprendizagem, clique no menu suspenso Extração de dados orientada por IA generativa.
        Nota: Pode levar algum tempo para exibir as Model connections no menu suspenso.
      3. Selecione o modelo personalizado criado na seção Conexões de modelos personalizados.
      4. Configure os campos obrigatórios para criar a instância de aprendizagem. Consulte Criar uma instância de aprendizagem no Document Automation.

      Seleção de Model connections ao criar novas instâncias de aprendizagem

    • Instância de aprendizado existente
      1. Abra a instância de aprendizagem.
      2. Clique na opção Configuração da instância de aprendizagem (Ícone de configuração da instância de aprendizagem).
      3. Na tela de configuração Editar propriedades, clique no menu suspenso Extração de dados baseada em IA generativa.
        Nota: Pode levar algum tempo para exibir as Model connections no menu suspenso.
      4. Selecione o modelo personalizado criado na seção Conexões de modelos personalizados.
      5. Clique em Modificar.

      Seleção de Model connections ao editar novas instâncias de aprendizagem

    Nota:
    • Se você estiver usando o token OAuth na Model connection, o token de acesso está configurado para expirar em uma hora por padrão e o token de atualização está configurado para expirar conforme a configuração do usuário. Certifique-se de substituir os tokens expirados para manter a Model connection ativa.
    • Você não poderá excluir uma Model connection que está sendo usada pela versão atual das instâncias de aprendizagem. Para excluir essa Model connection, você deve primeiro remover a associação das instâncias de aprendizagem e, em seguida, excluir a conexão.
    • Se uma Model connection foi registrada no histórico de versões do modo de teste e a Model connection foi excluída, um erro é exibido quando você tenta restaurar para a versão que estava usando a Model connection.