Pré-requisitos para habilitar a IA no Tableau Server

Para configurar e ativar o Tableau Agent para o Tableau Server, você precisará do seguinte:

• Função de administrador no Tableau Server. A configuração de site da IA no Tableau é específica do site e, quando ativada, permite que todos os usuários com acesso a esse site usem o recurso de IA.

• Conta de provedor de LLM ativa ou endpoint de Gateway personalizado. Dependendo do nosso método de autenticação, uma implantação ativa com chaves de API, URLs de endpoint ou credenciais OAuth

• Sua chave de API. Você precisará disso para conectar o Tableau Server ao seu OpenAI, provedor de LLM do Azure OpenAI ou seu gateway personalizado ao usar o modo de autenticação de chave de API. Recomendamos seguir as práticas recomendadas de segurança padrão e alternar a chave da API regularmente.

• Se você estiver usando o Azure OpenAI, um modelo de bate-papo/preenchimento e incorporaçãos implantado no Azure.

• Os modelos de LLM que o Tableau Agent utilizará para realizar tarefas como compreender as solicitações dos usuários e retornar resultados relevantes. A partir da versão 2026.3, se você estiver usando uma conexão direta do OpenAI, poderá aceitar os padrões sugeridos. Você também pode selecionar seus próprios modelos. Se estiver usando o Azure OpenAI ou uma conexão de gateway personalizada, você precisará selecionar seus modelos.

  O Tableau recomenda os seguintes modelos para obter melhores resultados:

  • Entender as solicitações dos usuários (modelo de tarefa pequena/ rápida): gpt-4o-ini ou posterior

  • Executar tarefas analíticas (raciocínio complexo ou modelo grande): gpt-4o ou posterior ou Claude Sonnet 4.6 ou posterior

  • Contexto de dados do processo (modelo de inserção): text-embedding-3-small ou modelo de incorporação pequeno semelhante compatível com seu provedor de LLM.

• Se você estiver usando um proxy de encaminhamento com o Tableau Server, precisará configurá-lo para comunicação com o LLM. Para obter detalhes, consulte Configurar um proxy de encaminhamento abaixo.

Conexões suportadas

Recursos disponíveis

Os recursos de IA no Tableau a seguir estão disponíveis no Tableau Server:

• Criação na Web do Tableau: cria visualizações ou conclui tarefas para você usando uma interface de usuário conversacional: permitir que os usuários explorem dados, criem visualizações e cálculos conheçam informações com a assistência do Tableau Agent na criação na Web do Tableau Server e no Tableau Desktop (versão 2025.3 e posteriores). Para obter mais informações sobre o Tableau Agent, consulte Explorar seus dados com o Tableau Agent(O link é aberto em uma nova janela).

• Tableau Agent em painéis (Beta): requer o Tableau Server+. Não disponível se estiver usando um gateway personalizado com autenticação OAuth. Você deve aceitar o beta para ativar esse recurso. Permita que consumidores e autores do painel obtenham rapidamente uma visão geral sobre seu painel ou informações sobre as visualizações em seu painel. Eles também podem fazer perguntas sobre seus dados usando o Dashboard Q&A. Como autor de painel, você pode ativar ou desativar cada recurso no nível do painel. Você também pode configurar o Dashboard Insights para incluir ou excluir determinadas planilhas ou se concentrar apenas em alguns tipos de informações. Para obter mais informações, consulte Tableau Agent em painéis (beta)(O link é aberto em uma nova janela).

  Observação: o Tableau Agent em Painéis exige que os usuários tenham o Acesso à IA e os recursos de permissão Consultar dados completos em todas as pastas de trabalho onde desejam usar o Tableau Agent. A permissão Consultar dados completos garante que o Tableau Agent tenha acesso aos dados subjacentes necessários para funcionar. Para obter mais informações, consulte Permissões(O link é aberto em uma nova janela).

• Tableau Agent no Tableau Prep: sugere etapas para limpar e transformar seus dados: permitir que os usuários limpem seus dados, criem campos calculados e criem fluxos com a ajuda do Tableau Agent. Esse recurso está disponível na criação na Web do Tableau Prep no Tableau Server e no Tableau Prep Builder (versão 2025.3 e posteriores). Para obter mais informações sobre o Tableau Agent no Tableau Prep, consulte Criar fluxos do Tableau Prep com o Tableau Agent(O link é aberto em uma nova janela).

Configurar IA no Tableau

As etapas para configurar a IA no Tableau e as informações que você precisa inserir são diferentes, com base no provedor de LLM selecionado. A configuração de um provedor de LLM diferente por site é aceita.

Etapa 1: conectar-se ao provedor do LLM ou ao Gateway personalizado

1. Entre no Tableau Server como administrador de servidor.

2. No site onde você deseja ativar os recursos generativos de IA, selecione Configurações.

3. Na IA no Tableau, clique em Conectar.

   

4. Na caixa de diálogo Conectar-se ao LLM, selecione seu provedor no menu suspenso de provedor de LLM.

   

5. Base na sua seleção, faça o seguinte:

   • OpenAI: insira a sua Chave de API.

   • Azure OpenAI: insira a sua Chave de API e Nome do recurso.

   • Gateway personalizado (beta): aceite o aviso de isenção de responsabilidade para optar pela versão Beta.

     • Insira o URL de gateway personalizado (exemplo: https://gateway.example.com/v1).

     • Selecione o modo Autenticação:

       • Sem autenticação: selecionar quando o gateway estiver protegido por meio de regras de rede interna (por exemplo, lista de permissões de IP ou perímetro VPC/VPN).

       • Chave de API: insira o token/chave exigido pelo gateway de API interno.

       • OAuth: fornecer os detalhes necessários do cliente OAuth:

         • ID do cliente e segredo do cliente: credenciais de aplicativo geradas pelo provedor de identidade.

         • URL de redirecionamento: o endpoint de retorno de chamada exigido pelo Tableau Server. Insira uma URL válida que termine com /auth/add_oauth_token (exemplo: https://<your-server-name>/auth/add_oauth_token). Se estiver usando HTTP em vez de HTTPS, o nome de domínio deve ser localhost.

         • Arquivo de configuração do OAuth: carrega um arquivo de configuração XML personalizado configurado para seu IDP. Para obter mais informações, consulte Elementos XML(O link é aberto em uma nova janela) na SDK de Conector do Tableau.

6. Clique em Conectar.

Etapa 2: definir as configurações do modelo

Se estiver usando OpenAI, selecione os modelos recomendados (selecionados por padrão) e clique em Aplicar. O Tableau recomenda esses modelos para o desempenho ideal. Os modelos são atualizados automaticamente sempre que o Tableau altera o modelo recomendado.

Se você estiver usando o Azure OpenAI ou um Gateway personalizado, precisará selecionar seus modelos. Para o Azure OpenAI, os modelos selecionados devem primeiro ser implantados e nomeados. Seja qual for o nome usado para o modelo implantado, é o mesmo nome que você digitará nos campos de modelo. Em seguida, você pode inserir esse nome no campo.

Os modelos selecionados manualmente também devem ser mantidos por você, e a configuração atualizada quando os modelos não são mais compatíveis para evitar que os usuários percam o acesso ao Tableau Agent.

1. Clique em Editar modelos.

2. Na caixa de diálogo Configurações do modelo, selecione ou insira as IDs de modelo específicas fornecidas por seu host ou gateway de LLM:

   • Entender as solicitações dos usuários: selecione ou insira o identificador de modelo pequeno (por exemplo, gpt-4o-ini ou posterior).

   • Criar visualizações, campos calculados e criar fluxos: selecione ou insira o identificador do modelo de rascunho primário (por exemplo, gpt-4o ou cláusula Solnet 4.6).

   • Contexto de dados do processo: selecionar ou inserir o identificador do modelo de inserção (por exemplo, text-embedding-3-small).

     

3. Clique em Aplicar.

Etapa 3: ativar recursos de IA para usuários

Observação: o Tableau Agent em Painéis requer o Tableau Server versão 2026.3 ou posterior, Tableau Server+ e não está disponível se usar um gateway personalizado com autenticação OAuth.

1. Em Configurações de IA por recurso, clique em Ativar para cada recurso que você deseja disponibilizar para os usuários neste site (Tableau Agent na criação na Web, Tableau Agent no Tableau Prep, Tableau Agent em painéis (Beta)).

2. Clique no botão Salvar na parte superior da página Configurações.

   

Experiência de autenticação do usuário final (gateways OAuth)

Quando um gateway personalizado é configurado usando OAuth, os usuários finais que acessam o Tableau Agent serão solicitados a entrar no gateway LLM e permitir o acesso ao Tableau Agent.

1. Ao abrir o Tableau Agent em uma pasta de trabalho ou sessão de criação, após digitar uma pergunta, o painel do agente será exibido Entrar para o Gateway do LLM.

2. Clicar em Entrar O abre a tela de logon do Provedor de identidades/OAuth da sua organização em uma janela do navegador separada.

3. Uma vez autenticado, o usuário é redirecionado de volta ao Tableau e pode interagir com o Tableau Agent.

Configurar um proxy de encaminhamento

Se o Tableau estiver configurado para usar um proxy de encaminhamento para se conectar à Internet, você pode configurar o Tableau Server para usar o host proxy e as configurações de porta para entrar em contato com o LLM.

Use o comando tsm configuration set(O link é aberto em uma nova janela) para fazer as alterações.

• Para hosts proxy HTTPS, use os seguintes pares de chave-valor:

  -k tomcat.https.proxyHost -v host.domain

  -k tomcat.https.proxyPort -v port_number

  Por exemplo, se o seu servidor proxy estiver em https://proxy.example.lan:8443, em seguida, execute os seguintes comandos:

  tsm configuration set -k tomcat.https.proxyHost -v proxy.example.lan

  tsm configuration set -k tomcat.https.proxyPort -v 8443

  tsm pending-changes apply

  Isso reiniciará o Tableau Server. Esteja ciente disso ao configurar o ambiente de produção.

• Para hosts proxy HTTP, use os seguintes pares de chave-valor:

  -k tomcat.http.proxyHost -v host.domain

  -k tomcat.http.proxyPort -v port_number

  Depois de definir essas chaves, execute

  tsm pending-changes apply

  Isso reiniciará o Tableau Server. Esteja ciente disso ao configurar o ambiente de produção.