Primeiros passos

Este guia leva você do zero até um agente respondendo: instalar o runtime da Bia no seu servidor, criar o primeiro agente e conversar com ele. Leva cerca de 15 minutos, e a maior parte desse tempo é a instalação rodando sozinha.

Antes de começar, você precisa de três coisas:

• Um servidor Linux que você controla (uma VPS nova serve). Acesso root por senha ou por chave SSH.
• Uma chave de API de um provedor de LLM — a Bia não revende inferência. Você fala direto com o seu provedor e paga direto a ele.
• Um convite, porque a Bia é fechada por enquanto.

#O que a Bia faz com o seu servidor

Vale entender isso antes de apertar qualquer botão, porque é a diferença entre a Bia e a maioria das plataformas de IA.

A Bia se conecta ao seu servidor por SSH e instala ali um runtime de agentes. Os agentes rodam na sua máquina, pensando com o seu modelo. A Bia fica de fora, gerenciando: ela instala, atualiza o núcleo de habilidades, mostra o que está acontecendo e te dá um botão de parada.

Isso tem uma consequência que vale dizer em voz alta: se você remover a Bia, os agentes continuam funcionando. Eles param de receber atualizações do núcleo e congelam na última versão, mas não desligam. Você não fica refém.

#1. Instale seu primeiro servidor

Uma conta nova começa assim — sem servidor, sem agente, com um único caminho à frente:

No menu lateral, vá em Servidores e clique em Novo servidor. O assistente pergunta:

• Como conectar — endereço IP, porta SSH e como autenticar (senha ou chave privada). A Bia usa isso uma vez para entrar e instalar; depois ela passa a falar com o servidor por um canal próprio.
• Qual preset usar — um preset é um time de agentes pronto. Se você não tem certeza, comece com o Assistente Pessoal: é um único agente generalista, e você pode adicionar outros depois.

Em seguida você informa a chave do seu modelo — é ela que dá aos agentes a capacidade de pensar — e, se quiser, o bot do Telegram e quem pode falar com ele:

Na imagem acima, o nome do bot e os identificadores do Telegram são exemplos — trocamos os reais para não expor dados de pessoas na documentação. O resto da tela é o painel de verdade.

Por fim, como a Bia entra no servidor: endereço, porta, usuário e senha. Repare na última opção — você escolhe se a Bia guarda essa credencial ou a descarta depois de instalar. O padrão é descartar.

Clique em instalar e acompanhe. A instalação roda em segundo plano e demora de 5 a 10 minutos, dependendo do servidor. Ela endurece o SSH, instala o runtime, sobe os serviços e registra o servidor de volta na Bia.

Se a instalação falhar, o erro aparece na própria página do servidor, com a etapa que quebrou. Veja Solução de problemas — a causa mais comum é uma porta SSH bloqueada ou uma chave sem permissão de root.

Quando terminar, o servidor aparece como Pronto e Online — e, se você escolheu um preset, os agentes dele já estão instalados junto:

#2. Configure seu modelo

Vá em Credenciais e informe a chave do seu provedor de LLM. É essa chave que os agentes usam para pensar — ela é enviada para o seu servidor e fica lá.

Se você quiser que os agentes falem no Telegram, é aqui também que você cadastra o token do bot. Cada agente precisa do seu próprio bot: o Telegram não aceita dois processos consultando o mesmo token ao mesmo tempo.

#3. Crie um agente

Se você escolheu um preset, os agentes dele já foram criados e provisionados junto com o servidor — pule para o passo 4.

Para criar um do zero, vá em Agentes → Novo agente:

• Nome — como você vai chamá-lo. O identificador técnico se preenche sozinho a partir do nome.
• Persona — quem ele é e como trabalha, em português corrido. Não é um prompt de sistema cheio de truque: escreva como se estivesse explicando a função para uma pessoa nova.
• Canais — por onde ele fala: o chat do painel, o Telegram, ou um widget no seu site.

Salve e clique em Instalar. A Bia leva a persona até o servidor e sobe o agente. Em cerca de um minuto ele fica Pronto.

#4. Converse com ele

Vá em Chat, escolha o agente na lista da esquerda e mande uma mensagem. A resposta vem do seu servidor, usando o seu modelo.

Se você conectou o Telegram, mande a mesma mensagem por lá — é o mesmo agente, com a mesma memória. A conversa aparece nos dois lugares.

#5. Saiba onde fica o freio

Antes de soltar um agente para valer, encontre o botão Parar agentes no menu. Ele pausa tudo — todos os agentes, em todos os seus servidores — em segundos, e continua valendo até você religar.

Vale abrir essa página uma vez agora, com calma, para saber onde ela fica antes de precisar dela com pressa. Veja Parar agentes.

#Próximos passos

• Visão geral do painel — o que cada área faz.
• Agentes — personas, presets e canais em detalhe.
• Habilidades — ensinar coisas novas aos seus agentes.
• Credenciais e privacidade — o que a Bia guarda, e como desligar isso.