Capítulo 36: Guia de configuração BYOK — Configurar os seus fornecedores de IA

Pense no BYOK (Bring Your Own Key) como trazer os seus próprios grãos de café para um café que tem a máquina de espresso — o SeaMeet fornece o motor de extração e análise, você fornece as credenciais de acesso à IA. Isto mantém os seus dados a fluir diretamente entre si e o fornecedor de IA que escolheu, sem retransmissão de terceiros.

Este capítulo guia-o pela configuração de ambos os componentes necessários: uma chave de Resumo de IA (Gemini) e um fornecedor de Agente IA (GitHub Copilot ou Claude Code). Também cobre um benefício que frequentemente surpreende os novos assinantes — o seu plano BYOK Pro também inclui sincronização gratuita entre dispositivos via GitHub, não apenas acesso à IA.

Inclui sincronização com GitHub

A partir da v2.1.x, cada assinatura BYOK Pro vem com sincronização entre dispositivos de notas e wikis via o seu próprio repositório GitHub privado — sem custo extra, um repositório por espaço de trabalho, sem limites de armazenamento. A sincronização era invisível nos ecrãs de atualização; agora é destacada no painel principal do Pre-Subscribe, no cartão Plano, no FAQ do BYOK Explainer e no ecrã de definições de Sincronização.

Como difere do plano dedicado Sync Pro: BYOK sincroniza apenas o texto leve (notas + wiki) através do seu próprio GitHub. Sync Pro é um serviço gerido separadamente que sincroniza tudo — notas, áudio, vídeo e capturas de ecrã — através da infraestrutura do SeaMeet. A maioria dos utilizadores BYOK só precisa da sincronização de texto que já está incluída.

Ver Capítulo 38: GitHub Sync para o passo a passo completo.

Objetivos do capítulo

Depois de ler este capítulo, será capaz de:

Compreender que chaves são necessárias e porquê
Obter uma chave de API Gemini gratuita do Google AI Studio
Instalar e configurar o GitHub Copilot CLI (nível gratuito)
Alternativamente, instalar e configurar o Claude Code CLI
Configurar a sincronização com GitHub que vem incluída na sua assinatura (Cap 38)
Verificar que ambos os componentes estão a funcionar
Atualizar ou remover uma chave quando necessário

Visão geral: o que precisa

O BYOK tem dois componentes de configuração — mais um benefício incluído que não tem de configurar:

┌─────────────────────────────────────────────────────────────┐
│                    COMPONENTES BYOK                         │
├──────────────────────┬──────────────────────────────────────┤
│  A. Resumo de IA     │  Chave de API Gemini (obrigatória)   │
│  (obrigatório)       │  Alimenta: transcrição, resumos,     │
│                      │  ações, decisões, capítulos          │
├──────────────────────┼──────────────────────────────────────┤
│  B. Agente IA        │  GitHub Copilot CLI  ← OU →          │
│  (precisa de pelo    │  Claude Code CLI                     │
│  menos um)           │  Alimenta: análise de capturas,      │
│                      │  consultas IA personalizadas         │
├──────────────────────┼──────────────────────────────────────┤
│  C. GitHub Sync      │  Incluído com BYOK Pro               │
│  (incluído, opcional)│  Repositório GitHub privado por      │
│                      │  espaço de trabalho. Sincroniza      │
│                      │  notas + wiki entre dispositivos.    │
│                      │  Configuração: Cap 38.               │
└──────────────────────┴──────────────────────────────────────┘

Tem de configurar A e pelo menos uma opção de B para todos os recursos de IA funcionarem. C é opcional mas já está pago — ative-o quando estiver pronto para sincronização entre dispositivos.

Recapitulação da proposta de valor

O que $4,99/mês BYOK Pro cobre:

Privacidade — os dados vão diretos do seu dispositivo para Google / Anthropic / OpenAI; os servidores do SeaMeet nunca os veem.
Qualidade — escolha o melhor modelo por trabalho.
Controlo de custos — pague aos fornecedores diretamente; a maioria dos utilizadores fica no nível gratuito do Gemini.
Soberania — as chaves vivem no porta-chaves do seu SO; revogue a qualquer momento.
Sincronização gratuita e privada — faça backup de notas e wiki para o seu próprio repositório GitHub privado.

Onde verá isto na aplicação

Estes cinco benefícios são reforçados em cada ponto de contacto de atualização BYOK via o BYOK Value Hero partilhado — no explicador Pre-Subscribe, no recibo pós-assinatura, em Definições → IA, nos Locked Feature Cards que aparecem quando um utilizador gratuito clica numa funcionalidade restrita por IA (transcrição, resumo, ações, síntese de notas, lista wiki, IA de captura de ecrã), e no banner de incentivo das definições de sincronização.

Parte A: Resumo de IA — chave de API Gemini

Porquê Gemini?

O SeaMeet usa o modelo Gemini do Google para transcrição de áudio, resumos de reuniões, extração de ações e saídas de IA relacionadas. A API Gemini tem um nível gratuito generoso que cobre cargas de trabalho típicas de reuniões.

Obter a sua chave de API Gemini

Abra o seu navegador e vá ao Google AI Studio (aistudio.google.com/apikey)
- Inicie sessão com a sua conta Google se solicitado
Clique em Create API Key
Selecione ou crie um projeto Google Cloud quando perguntado
Copie a chave gerada (começa com AIza…)

Nível gratuito: o nível gratuito do Gemini permite um número substancial de chamadas de API por dia. Para uso típico de gravação de reuniões (algumas horas de áudio por semana), o nível gratuito é suficiente para a maioria dos utilizadores.

Privacidade: o seu áudio é enviado diretamente para a API do Google para transcrição. Reveja a política de uso de dados de IA do Google se isto for uma preocupação para o seu caso de uso.

Introduzir a sua chave no SeaMeet

Durante o assistente de configuração (primeira vez após subscrever):

O assistente abre automaticamente após subscrever
O passo 1 mostra a secção Resumo de IA
Cole a sua chave Gemini no campo de entrada
A chave é validada automaticamente — verá:
- ✅ Marca verde: a chave é válida
- ❌ X vermelho: a chave é inválida ou foi copiada incorretamente — verifique e cole de novo
Clique em Seguinte para prosseguir para a configuração do Agente IA

Mais tarde, via Definições:

Abra Definições (⚙️)
Navegue para IA → Chaves de API
Encontre a secção Resumo de IA
Clique em Editar ou cole no campo da chave Gemini
Clique em Guardar — a chave valida automaticamente

Testar e remover uma chave

Nas definições de Chaves de API:

Botão Testar — valida a chave contra a API do Google
Botão Remover — elimina a chave armazenada; os recursos de Resumo de IA ficarão indisponíveis até adicionar uma nova chave

Se uma chave falhar a validação, é automaticamente limpa para prevenir armazenar uma chave partida. Simplesmente cole uma nova.

Parte B: fornecedor do Agente IA

Precisa de pelo menos um fornecedor de Agente IA. O SeaMeet atualmente suporta dois:

Fornecedor	Custo	Limite	Melhor para
GitHub Copilot CLI	Gratuito (plano Copilot Free)	50 chats/mês	Começar, uso leve
Claude Code CLI	Pago (Claude Pro ou Max)	Limites mais altos	Uso regular, utilizadores avançados

Pode instalar ambos e alternar entre eles a partir de Definições → IA.

Opção 1: GitHub Copilot CLI (gratuito)

O GitHub Copilot CLI é uma ferramenta de linha de comandos que o SeaMeet usa como seu Agente IA. O nível gratuito do GitHub Copilot inclui 50 pedidos de agente por mês — suficiente para análise ocasional de capturas de ecrã e consultas de IA.

Passo 1: instalar GitHub Copilot CLI

Escolha o método que corresponde ao seu sistema:

Windows (winget):

winget install GitHub.cli

macOS (Homebrew):

brew install gh

Linux (apt):

sudo apt install gh

Nota: o SeaMeet mostra botões de cópia junto a cada comando na UI de configuração — pode copiar o comando exato sem o escrever. Para outras distribuições Linux, veja os documentos de instalação do GitHub CLI.

Passo 2: autenticar com o GitHub

Após instalação, abra um terminal e execute:

gh auth login

Siga os pedidos para iniciar sessão na sua conta GitHub. Isto liga o CLI à sua conta GitHub e ativa os recursos Copilot.

Passo 3: detetar no SeaMeet

Na configuração de Chaves de API do SeaMeet (ou Definições → IA → Chaves de API):
Encontre a secção Agente IA → mosaico GitHub Copilot
Clique em Atualizar (🔄)
O SeaMeet procura o CLI instalado
Se encontrado: aparece o estado ✅ "Detected"
Se não encontrado: verifique a sua instalação e repita

Limite de 50 chats/mês: o plano Copilot gratuito é suficientemente generoso para começar, mas se usa o Agente IA frequentemente pode atingir o limite. Pode atualizar para GitHub Copilot Pro, ou mudar para Claude Code CLI para limites mais altos.

Opção 2: Claude Code CLI (pago)

O Claude Code é a ferramenta CLI da Anthropic. Requer uma assinatura Claude Pro ou Max mas tem limites de uso mais altos do que o nível gratuito do Copilot.

Passo 1: instalar Claude Code CLI

Windows (PowerShell):

irm https://claude.ai/install.ps1 | iex

macOS / Linux:

curl -fsSL https://claude.ai/install.sh | sh

A UI de configuração do SeaMeet mostra botões de cópia para cada comando de instalação.

Passo 2: autenticar

Após instalação, abra um terminal e execute:

claude auth

Inicie sessão com a sua conta Anthropic (requer plano Claude Pro ou Max).

Passo 3: detetar no SeaMeet

Em Definições → IA → Chaves de API → Agente IA → mosaico Claude Code
Clique em Atualizar (🔄) para detetar o CLI instalado
✅ "Detected" aparece quando encontrado

Escolher o seu fornecedor predefinido

Se tem o Copilot e o Claude instalados, o SeaMeet permite-lhe escolher qual usar por predefinição:

Vá a Definições → IA → Chaves de API
Na secção Agente IA, ambos os mosaicos serão mostrados como detetados
Use o botão de opção ou seletor para escolher o fornecedor ativo
O fornecedor selecionado é usado para todos os pedidos do Agente IA

Pode trocar de fornecedores a qualquer momento a partir das Definições.

Verificar que tudo funciona

Após configuração, faça uma verificação rápida de ponta a ponta:

Testar Resumo de IA:

Abra qualquer gravação na sua biblioteca
Clique em AI Insights → Generate Summary
Se completar sem erro: ✅ a chave Gemini está a funcionar

Testar Agente IA:

Tire uma captura de ecrã usando o SeaMeet
Abra-a no visualizador de capturas
Clique no separador de análise IA e faça uma pergunta
Se receber uma resposta: ✅ o fornecedor do Agente IA está a funcionar

Atualizar uma chave

Para atualizar a sua chave Gemini:

Definições → IA → Chaves de API → Resumo de IA → Editar
Limpe a chave antiga e cole a nova
Clique em Guardar

Para atualizar o seu fornecedor de Agente:

Volte a correr os passos de instalação/auth do CLI se uma chave expirou
Clique em Atualizar no SeaMeet para re-detetar

Referência rápida

┌────────────────────────────────────────────────────────────┐
│                  GUIA DE CONFIGURAÇÃO BYOK                 │
│                  Referência rápida                         │
├────────────────────────────────────────────────────────────┤
│  Fonte chave Gemini │ aistudio.google.com/apikey (gratuita)│
│  Nível grat. Gemini │ Generoso — suficiente para uso típico│
│  Introduzir chave   │ Definições → IA → Chaves → Resumo IA │
├────────────────────────────────────────────────────────────┤
│  Instalar Copilot   │ winget / brew / apt (gratuito)       │
│  Auth Copilot       │ gh auth login                        │
│  Limite Copilot     │ 50 chats/mês (nível gratuito)        │
├────────────────────────────────────────────────────────────┤
│  Instalar Claude    │ script curl/irm (pago)               │
│  Auth Claude        │ claude auth                          │
│  Claude requer      │ Assinatura Claude Pro ou Max         │
├────────────────────────────────────────────────────────────┤
│  Detetar fornecedor │ Definições → IA → Chaves → Atualiz.🔄│
│  Trocar fornecedor  │ Botão opção na secção Agente IA      │
│  Testar Resumo IA   │ Abrir gravação → Generate Summary    │
└────────────────────────────────────────────────────────────┘

Capítulos relacionados

Cap 31: Transcrição ao vivo · Cap 32: Extração por IA · Cap 33: Modelos de resumo de IA · Cap 34: Editar resultados da IA — todos alimentados pela sua chave Gemini
Capítulo 35: Assinatura e faturação — gestão de plano e portal de faturação
Capítulo 37: Copilot — usar o GitHub Copilot CLI como Agente IA
Capítulo 38: GitHub Sync — a sincronização entre dispositivos incluída no seu plano BYOK Pro

Última atualização: 2026-06-04

← Capítulo 35: Assinatura e faturação | Capítulo 37: Copilot →