Usar ferramentas de IA no Server
Configure e execute o Ferramentas de IA no Server 2026.1 com uma entidade de serviço. Use este guia para criar uma entidade de serviço no Alteryx One e conectar suas ferramentas de IA. Para obter mais informações sobre as entidades de serviço no Alteryx One, vá para a página Entidades de serviço.
Requisitos
Um Administrador do espaço de trabalho deve criar e gerenciar entidades de serviço.
Você deve ser um Usuário completo ou ter uma função personalizada com a capacidade Ferramentas de IA generativa para usar ferramentas de IA.
O AMP deve estar habilitado para o Server. Um administrador deve habilitar o AMP em Configurações do sistema. Para obter mais informações sobre AMP e Server, acesse AMP Engine.
Primeira configuração
Conclua estas etapas uma vez para permitir que as ferramentas de IA se conectem à sua conexão com LLMs no Alteryx One.
Criar uma entidade de serviço no Alteryx One
Nota
Você deve ser um Administrador do espaço de trabalho para concluir esta etapa.
No Alteryx One, abra o menu do perfil.
Acesse Administrador do espaço de trabalho > Entidades de serviço.
Selecione Novo.
Insira os valores:
Nome: insira um nome exclusivo.
Descrição: insira uma descrição.
Vida útil do segredo (dias): insira um valor de 1 a 365.
Em Funções, selecione uma função de Usuário completo ou uma função personalizada com a capacidade Ferramentas de IA generativa.
Selecione Criar.
Depois de criar a entidade de serviço:
Copie o ID do cliente.
Copie o Segredo do cliente.
Armazene esses valores de forma segura.
Compartilhar a conexão com LLMs no Alteryx One
Acesse Dados.
Selecione Conexões.
Localize a conexão com LLMs.
Clique no menu de três pontos e selecione Compartilhar.
Em Selecionar usuários ou entidades de serviço, selecione a entidade de serviço.
No menu suspenso "Função", selecione Editor (ou a função necessária).
Defina o compartilhamento de credenciais como Compartilhar credenciais.
Clique em Compartilhar.
Configurar a ferramenta Prompt ou Substituição por LLM no Designer
Selecionar a conexão da entidade de serviço
No Designer, abra seu fluxo de trabalho.
Selecione a ferramenta Prompt.
Na seção Opções de conexão, selecione Entidade de serviço (para o Server).
Criar uma conexão
Clique em Criar uma nova conexão.
No Gerenciador de Conexões de Dados (DCM), selecione + Nova.
No menu suspenso Selecionar tecnologia, selecione Aplicativo OAuth do Alteryx One.
Inserir as credenciais
Nota
Para inserir essas credenciais, você deve ter acesso ao ID do cliente e ao segredo do cliente da entidade de serviço. Se você não criou a entidade de serviço, peça a um Administrador do espaço de trabalho para fornecer esses valores.
Em Nome da fonte de dados, insira um nome.
Em ID do cliente, insira o ID do cliente da entidade de serviço.
Em Segredo do cliente, insira o segredo do cliente da entidade de serviço.
Clique em Salvar.
Publicar fluxo de trabalho no Server
Depois de configurar a conexão da entidade de serviço, publique seu fluxo de trabalho no Server.
O fluxo de trabalho é executado no Server usando a entidade de serviço. As ferramentas de IA usam a conexão com LLMs compartilhada e são executadas sem exigir autenticação do usuário.
Rotacionar os segredos da entidade de serviço
Os segredos do cliente de uma entidade de serviço expiram após 1 ano. Quando o segredo expirar, atualize a conexão da entidade de serviço com um novo segredo do cliente no Gerenciador de Conexões de Dados. Para obter mais informações sobre a rotação de segredos, acesse a página Entidades de serviço.
Nota
Se você não criou a entidade de serviço, peça a um Administrador do espaço de trabalho para fornecer um novo segredo de cliente.
Gerar um novo segredo do cliente
Em Alteryx One, acesse Administrador do espaço de trabalho > Entidades de serviço.
Na página "Entidades de serviço", selecione uma entidade de serviço para abrir sua página de detalhes.
Selecione Gerar segredo.
Copie e armazene com segurança o novo segredo.
Atualizar a conexão no Designer Desktop
Em Designer Desktop, selecione Arquivo > Gerenciar conexões.
Na página "Conexões", selecione a conexão da entidade de serviço.
Clique em Editar.
Insira o Segredo do cliente e clique em Salvar.
Verifique a conexão para garantir que ela funciona como esperado antes de usá-la em um fluxo de trabalho.