Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Início rápido

Este início rápido explica como usar Ollama para fornecer capacidades de LLM a Liz. Você pode trocar de provedores após a instalação inicial referindo-se a Procedimentos para Administradores.

Pré-requisitos

A versão atual do Assistente de IA requer os seguintes componentes:

  • Helm instalado

  • Rancher Prime/Gerenciador da Comunidade 2.13 ou superior

Certifique-se de que você tem os direitos para implantar CRD (cluster_admin) no cluster host.

Requisitos Técnicos

Aqui está uma tabela dos componentes de IA suportados e seus requisitos.

Você só precisa atender aos requisitos para os componentes específicos que pretende executar. Os requisitos variarão com base no modelo de linguagem de grande escala (LLM) específico que você escolher implantar.
Modelo LLM Requisitos Requisito de GPU

gpt-oss:20b

Ollama instalado

NVIDIA RTX A5000, NVIDIA RTX 4090 ou similar (Mínimo 24Gb VRAM)

gpt-oss:120b

Ollama instalado

NVIDIA A100 ou similar (Mínimo 80Gb VRAM)

Gemini

Conta do Google Workplace

N/A

ChatGPT

Conta do OpenAI

N/A

AWS Bedrock

Conta da AWS

N/A

Fornecedor semelhante ao OpenAI

Conta do Azure, Evroc Think, …​

N/A

A lista de modelos testados está disponível na documentação de Modelos.

Se você executar seu próprio Ollama, certifique-se de ter pelo menos gpt-oss:20b para o modelo local. Consulte documentação do Ollama sobre como baixar modelos.

Instale Liz: The Rancher AI Assistant

A instalação de Liz é um processo em duas etapas:

  • Implante o agente e o MCP via o gráfico Helm fornecido.

  • Implante a extensão da interface do Rancher.

Instale o Agente e o MCP no cluster local

  1. Crie um arquivo de configuração values.yaml (para Ollama):

    ollamaLlmModel: "gpt-oss:20b"
ollamaUrl: "http://ollama:11434"
activeLlm: "ollama"

    Você pode alterar essas configurações e provedores mais tarde nas abas 'Configurações Globais → Assistente de IA' do Rancher.

  2. Instale o chart rancher-ai-agent

    helm install rancher-ai-agent \
  --namespace cattle-ai-agent-system \
  --create-namespace \
  -f values.yaml oci://registry.suse.com/rancher/charts/rancher-ai-agent

Instale a extensão da interface do usuário

Abra a interface do usuário do Rancher Manager e navegue até a página 'Extensões'.

  1. No Rancher Manager, clique em Extensão na barra de menu.

    Botão de Extensão na barra de menu

  2. Use o menu de três pontos no canto superior direito e selecione 'Adicionar Repositórios do Rancher'.

    Menu para gerenciar Repositórios do Rancher

  3. Selecione 'Adicionar Repositório Oficial de Extensões do Rancher' para adicionar o repositório.

    Adicionar Repositório Oficial do Rancher

  4. Clique em 'Adicionar'.

  5. Encontre o cartão do Assistente de IA e clique em 'Instalar'.

  6. Selecione uma versão (ou use a mais recente por padrão) e clique em 'Instalar'.

    Selecione uma versão ou use a mais recente.

  7. Uma vez que a extensão tenha terminado de instalar, clique no botão 'Recarregar' que aparece na parte superior da página.