Skip to main content

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…

  1. Em sua conta do Alteryx One, vá para a página Dados e selecione a guia Conexões.

  2. Selecione Nova conexão. Para obter detalhes sobre a criação de conexão, acesse a janela Criar conexão.

  3. 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.

  4. 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.

Amazon Bedrock

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:InvokeModel

      • bedrock:InvokeModelWithResponseStream

      • bedrock:ListFoundationModels

      • bedrock:GetFoundationModel

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

  • 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.

Azure AI Foundry

Connection Information

  • Connection Name: Provide a descriptive connection name that users will reference when using this connection later.

  • Connection Description (optional): Provide a description for the connection.

  • Azure AI Foundry API Base URL: Enter your Azure AI Foundry base URL (for example, https://<account_name>.services.ai.azure.com).

  • Azure Foundry API Version: Enter your Azure AI Foundry API version (for example, 2024-02-01).

  • Model List: Enter a comma-separated list of models (for example, gpt-4o-mini). Use the deployed model name for each model.

    Nota

    Make sure that your selected models are deployed with the correct names. Otherwise, you can’t make requests with them in the Prompt tool.

Credential Information

There are 2 Credential Types that you can select for Azure AI Foundry.

API Key

  1. Credential Type: Select API Key.

  2. Azure AI Foundry API Key: Enter your Azure AI Foundry API key.

OAuth Client

Use OAuth 2.0 to authenticate your Azure AI Foundry connection. Configure these fields:

Importante

If you update your connection, select Authenticate for your OAuth client. Otherwise, the connection breaks.

  1. Credential Type: Select OAuth 2.0.

  2. Oauth Client: Select the OAuth client to use. Then select Authenticate to validate it. To create an OAuth client, follow these steps:

    Nota

    Only Workspace AdminAdministrador do espaço de trabalho can create and share OAuth clients. If you don’t have permission, contact your Workspace AdminAdministrador do espaço de trabalho.

    1. Go to Workspace Admin > OAuth Clients.

    2. Select New.

    3. Enter the OAuth client details:

      • Name: Enter a descriptive name.

      • Technology: Select azure_ai_foundry.

      • Grant Type: Select Client Credentials.

      • Client ID: Contact your IT team for setup. Provide this setup guide as reference.

      • Client Secret: Contact your IT team for setup. Provide this setup guide as reference.

      • Client Secret Expiration Date: Select a future expiration date.

      • Token URL: Enter https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. Replace {tenant_id} with your tenant ID. To get your tenant ID, contact your IT team. Provide this setup guide as reference.

      • Scopes: Enter https://ai.azure.com/.default.

      • Access Token Expiry: Enter the token lifetime in seconds.

Nota

Select Authenticate before you select Test Connection. Then select Create to save the connection.

Azure OpenAI Service

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.

Credenciais AAC do Azure

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.

  1. 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.

  2. URL base da API do Azure: insira o URL base do Azure (por exemplo, https://<account_name>.openai.azure.com).

  3. Versão da API do Azure: insira sua versão da API do Azure (por exemplo, 2024-10-21).

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. Nome da conta do (recurso) Azure: insira o nome da sua conta do Azure. Você pode encontrá-lo na página do AI Foundry.

Cliente OAuth

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.

  1. URL base da API do Azure: insira o URL base do Azure (por exemplo, https://<account_name>.openai.azure.com).

  2. Versão da API do Azure: insira sua versão da API do Azure (por exemplo, 2024-10-21).

  3. 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.

  4. 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.

    1. Acesse Administrador do espaço de trabalho > Clientes OAuth.

    2. Selecione Novo.

    3. 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.

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.

  • 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.

Databricks

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

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, 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.

Google Vertex AI

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.

Groq

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.

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.

  • 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.

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 Mistral. Saiba como criar sua chave de API com a conta do Mistral.

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 OpenAI. Saiba como criar sua chave de API a partir da sua conta do OpenAI.

Compatível com 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.

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 do Perplexity. Saiba como criar sua chave de API a partir da sua conta do Perplexity.

xAI

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.

Nesta secção: