Criar conexões com LLMs
Controles de acesso para administradores
Os usuários com a função Usuário completo podem criar conexões com LLMs, por padrão. Para limitar o acesso a conexões com LLM, atribua uma função personalizada que tenha a capacidade de Conectividade com LLMs desabilitada. Saiba mais sobre funções e capacidades de usuário.
Para usar os modelos de linguagem avançados (LLMs) com as ferramentas de IA, conecte o Alteryx One ao LLM de sua preferência. Para fazer isso…
Em sua conta do Alteryx One, vá para a página Dados e selecione a guia Conexões.
Selecione Nova conexão. Para obter detalhes sobre a criação de conexão, acesse a janela Criar conexão.
Você pode usar a barra de Pesquisa para encontrar seu LLM ou selecionar LLMs para filtrar a lista para exibir apenas conexões com LLMs disponíveis.
Escolha o LLM de sua preferência e insira os detalhes da configuração.
Depois que a conexão é criada, a LLM fica disponível para você por meio das ferramentas Substituição por LLM e Prompt no Designer. Se você criou a conexão com LLMs para outros usuários, compartilhe a conexão com eles a partir da página "Conexões".
Importante
Cada conexão com LLMs tem requisitos de configuração diferentes, tanto em termos de qual configuração é necessária no LLM em si quanto nas configurações no Alteryx One.
Para obter detalhes, revise as configurações específicas do LLM abaixo.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Nome da região da AWS: insira a região da sua conta da AWS (por exemplo, EUA-Oeste).
Tipo de credencial: atualmente, a chave de acesso da AWS é a única opção. Insira o ID da chave de acesso da AWS e a chave de acesso secreta da AWS da conta que você deseja conectar. Para obter mais informações, acesse a documentação do AWS IAM. Recomendamos que você crie uma função do IAM e use as chaves de acesso correspondentes.
Para obter permissões amplas, adicione
AmazonBedrockFullAccessà função do IAM.Para obter permissões mínimas, adicione estas permissões à função do IAM:
bedrock:InvokeModelbedrock:InvokeModelWithResponseStreambedrock:ListFoundationModelsbedrock:GetFoundationModel
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do Anthropic. Obtenha sua chave de API por meio do Console do Anthropic.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Há dois tipos de credencial que você pode selecionar para o Auzure OpenAI.
Configure sua conexão do Azure diretamente no Alteryx One. Configure estes campos:
Nota
Antes de poder gerar chamadas de conteúdo, você deve primeiro implantar um modelo. Para começar, saiba como criar e implantar um modelo do Azure OpenAI.
Chave de API do Azure: insira sua chave de API do Azure OpenAI. Você deve primeiro seguir o guia de gerenciamento de API do Azure para configurar seu modelo para uso com a API do Azure OpenAI.
URL base da API do Azure: insira o URL base do Azure (por exemplo,
https://<account_name>.openai.azure.com).Versão da API do Azure: insira sua versão da API do Azure (por exemplo,
2024-10-21).ID de cliente do Azure: entre em contato com sua equipe de TI para obter ajuda para criar esse parâmetro. Forneça este guia de configuração como referência.
ID de locatário do Azure: entre em contato com sua equipe de TI para obter ajuda para criar esse parâmetro. Forneça este guia de configuração como referência.
Segredo do cliente do Azure: entre em contato com sua equipe de TI para obter ajuda para criar esse parâmetro. Forneça este guia de configuração como referência.
ID da assinatura do Azure: insira o ID da assinatura do Azure. Você o encontra em Grupos de recursos > seu grupo de recursos > Assinatura > sua assinatura > ID da assinatura. Como alternativa, você pode acessar o AI Foundry, selecionar o nome da sua conta e, em seguida, selecionar o portal Foundry para encontrar a informação.
Nome do grupo de recursos do Azure: insira o nome do seu grupo de recursos do Azure. Você pode encontrá-lo em Grupo de recursos > seu grupo de recursos. Como alternativa, você pode acessar o AI Foundry, selecionar o nome da sua conta e, em seguida, selecionar o portal Foundry para encontrar a informação.
Nome da conta do (recurso) Azure: insira o nome da sua conta do Azure. Você pode encontrá-lo na página do AI Foundry.
Use o OAuth 2.0 para autenticar sua conexão do Azure. Configure estes campos:
Nota
Antes de poder gerar chamadas de conteúdo, você deve primeiro implantar um modelo. Para começar, saiba como criar e implantar um modelo do Azure OpenAI.
Importante
Se você atualizar sua conexão, selecione Autenticar para seu cliente OAuth. Caso contrário, a conexão será interrompida.
URL base da API do Azure: insira o URL base do Azure (por exemplo,
https://<account_name>.openai.azure.com).Versão da API do Azure: insira sua versão da API do Azure (por exemplo,
2024-10-21).Lista de modelos: insira uma lista separada por vírgulas de modelos (por exemplo,
gpt-5,gpt-4o,personalizado). Use o nome do modelo implantado para modelos personalizados.Nota
Certifique-se de que os modelos selecionados sejam implantados com os nomes corretos. Caso contrário, você não poderá fazer solicitações com eles na ferramenta Prompt.
Cliente OAuth: selecione o cliente OAuth a ser usado. Em seguida, selecione Autenticar para validá-lo. Para criar um cliente OAuth, siga estas etapas:
Nota
Só o Administrador do espaço de trabalho pode criar e compartilhar clientes OAuth. Se você não tiver permissão, entre em contato com seu Administrador do espaço de trabalho.
Acesse Administrador do espaço de trabalho > Clientes OAuth.
Selecione Novo.
Insira os detalhes do cliente OAuth:
Nome: insira um nome descritivo.
Tecnologia: selecione
azure.Tipo de concessão: selecione Credenciais do cliente.
ID do cliente: entre em contato com sua equipe de TI para configurar. Forneça este guia de configuração como referência.
Segredo do cliente: entre em contato com sua equipe de TI para configurar. Forneça este guia de configuração como referência.
Data de vencimento de segredo do cliente: selecione uma data de vencimento futura.
URL do token: digite
https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. Substitua{tenant_id}pelo seu ID de locatário. Para obter seu ID de locatário, entre em contato com sua equipe de TI. Forneça este guia de configuração como referência.Escopos: digite
https://cognitiveservices.azure.com/.default.Validade do token de acesso: insira a vida útil do token em segundos.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do Cohere. Saiba como obter sua chave de API a partir da sua conta do Cohere.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
URL base: insira o URL base do Databricks (por exemplo,
https://<workspace>.databricks.com/serving-endpoints).Chave de API: insira seu Token de acesso pessoal do Databricks. Isso fornece acesso tanto aos modelos Foundation do Databricks quanto aos modelos personalizados implantados.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do DeepSeek. Saiba como obter sua chave de API a partir da sua conta do DeepSeek.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, o JSON de credencial do Vertex é a única opção.
Credenciais do Vertex: copie e cole o JSON que contém as chaves da conta de serviço. Saiba como criar suas chaves de conta de serviço a partir do Google Cloud.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do GroqCloud. Saiba como criar sua chave de API a partir da sua conta do GroqCloud.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Lista de modelos: insira uma lista de modelos a serem usados com essa conexão. Separe os modelos com vírgulas (por exemplo,
meta-llama/Llama-Prompt-Guard-2-86M,meta-llama/Llama-3.3-70B-Instruct,katanemo/Arch-Router-1.5B). Certifique-se de que cada modelo seja implantado no Hugging Face usando o provedor de inferência do Hugging Face, que seja compatível com a geração de texto e que você tenha acesso a ele. A partir de agora, somente modelos implantados com o próprio provedor de inferência do Hugging Face são compatíveis.Nota
Certifique-se de que os nomes dos modelos estejam corretos. Se os nomes estiverem incorretos, você não poderá fazer solicitações para eles na ferramenta Prompt.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira seu token de acesso do usuário do Hugging Face. Saiba como criar seu token de acesso do usuário a partir da sua conta do Hugging Face.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do Mistral. Saiba como criar sua chave de API a partir da sua conta do Mistral.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do OpenAI. Saiba como criar sua chave de API a partir da sua conta do OpenAI.
Use conexões compatíveis com o OpenAI para se conectar a APIs do LLM que seguem a especificação da API do OpenAI.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
URL base: ponto de extremidade de API do seu modelo personalizado ou provedor compatível com OpenAI (por exemplo,
https://seu-pontodeextremidade-personalizado.com/v1).Chave de API: insira a chave de API do seu modelo personalizado ou provedor compatível com OpenAI.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API do Perplexity. Saiba como criar sua chave de API a partir da sua conta do Perplexity.
Informações da conexão
Nome da conexão: forneça um nome descritivo para a conexão que os usuários utilizarão como referência ao usar essa conexão posteriormente.
Descrição da conexão (opcional): forneça uma descrição para a conexão.
Informações de credencial
Tipo de credencial: atualmente, a chave de API é a única opção.
Chave de API: insira a sua chave de API da xAI. Saiba como criar sua chave de API a partir da sua conta da xAI.