Capítulo 31: Guia de configuração BYOK — Configurando seus provedores de IA

Pense no BYOK (Bring Your Own Key — Traga Sua Própria Chave) como trazer 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. Isso mantém seus dados fluindo diretamente entre você e seu provedor de IA escolhido, sem intermediário de terceiros.

Este capítulo orienta você na configuração dos dois componentes necessários: uma chave de Resumo de IA (Gemini) e um provedor de Agente de IA (GitHub Copilot ou Claude Code).

---

Objetivos do capítulo

Após ler este capítulo, você será capaz de:

• Entender quais chaves são necessárias e por quê
• Obter uma chave de API Gemini gratuita do Google AI Studio
• Instalar e configurar o GitHub Copilot CLI (plano gratuito)
• Alternativamente instalar e configurar o Claude Code CLI
• Verificar se os dois componentes estão funcionando
• Atualizar ou remover uma chave quando necessário

---

Visão geral: o que você precisa

O BYOK tem dois componentes:

┌─────────────────────────────────────────────────────────────┐
│                    COMPONENTES BYOK                          │
├──────────────────────┬──────────────────────────────────────┤
│  A. Resumo de IA     │  Chave de API Gemini (obrigatória)    │
│  (obrigatório)       │  Alimenta: transcrição, resumos,     │
│                      │  itens de ação, decisões, capítulos  │
├──────────────────────┼──────────────────────────────────────┤
│  B. Agente de IA     │  GitHub Copilot CLI  ← OU →          │
│  (precisa de pelo    │  Claude Code CLI                     │
│  menos um)           │  Alimenta: análise de captura de     │
│                      │  tela, consultas de IA personalizadas│
└──────────────────────┴──────────────────────────────────────┘

Você deve configurar A e pelo menos uma opção de B para que todos os recursos de IA funcionem.

---

Parte A: Resumo de IA — Chave de API Gemini

Por que Gemini?

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

Obtendo sua chave de API Gemini

1. Abra o navegador e vá para Google AI Studio (aistudio.google.com/apikey)
   • Faça login com sua conta Google se solicitado
2. Clique em Create API Key
3. Selecione ou crie um projeto do Google Cloud quando solicitado
4. Copie a chave gerada (começa com AIza…)

Plano gratuito: O plano 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 plano gratuito é suficiente para a maioria dos usuários.

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

Inserindo sua chave no SeaMeet

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

1. O assistente abre automaticamente após você assinar
2. A Etapa 1 mostra a seção de Resumo de IA
3. Cole sua chave Gemini no campo de entrada
4. A chave é validada automaticamente — você verá:
   • ✅ Sinal de verificação verde: A chave é válida
   • ❌ X vermelho: A chave é inválida ou foi copiada incorretamente — verifique e cole novamente
5. Clique em Avançar para prosseguir para a configuração do Agente de IA

Depois, via Configurações:

1. Abra as Configurações (⚙️)
2. Navegue até IA → Chaves de API
3. Encontre a seção Resumo de IA
4. Clique em Editar ou cole no campo de chave Gemini
5. Clique em Salvar — a chave é validada automaticamente

Testando e removendo uma chave

Nas configurações de Chaves de API:

• Botão Testar — valida a chave contra a API do Google
• Botão Remover — exclui a chave armazenada; os recursos de Resumo de IA ficarão indisponíveis até que você adicione uma nova chave

Se uma chave falhar na validação, ela é automaticamente limpa para evitar armazenar uma chave quebrada. Basta colar uma nova.

---

Parte B: Provedor de Agente de IA

Você precisa de pelo menos um provedor de Agente de IA. O SeaMeet atualmente suporta dois:

Provedor	Custo	Limite	Ideal 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, usuários avançados

Você pode instalar ambos e alternar entre eles em Configurações → IA.

---

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

O GitHub Copilot CLI é uma ferramenta de linha de comando que o SeaMeet usa como Agente de IA. O plano gratuito do GitHub Copilot inclui 50 solicitações de agente por mês—suficiente para análise ocasional de capturas de tela e consultas de IA.

Etapa 1: Instale o 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

Observação: O SeaMeet mostra botões de cópia ao lado de cada comando na interface de configuração — você pode copiar o comando exato sem precisar digitá-lo.

Etapa 2: Autentique com o GitHub

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

gh auth login

Siga os prompts para fazer login na sua conta GitHub. Isso vincula o CLI à sua conta GitHub e habilita os recursos do Copilot.

Etapa 3: Detectar no SeaMeet

1. Nas configurações de Chaves de API do SeaMeet (ou Configurações → IA → Chaves de API):
2. Encontre a seção Agente de IA → bloco GitHub Copilot
3. Clique em Atualizar (🔄)
4. O SeaMeet verifica o CLI instalado
5. Se encontrado: ✅ Status "Detectado" aparece
6. Se não encontrado: verifique sua instalação e repita

Limite de 50 chats/mês: O plano gratuito do Copilot é generoso o suficiente para começar, mas se você usar o Agente de IA com frequência, pode atingir o limite. Você pode atualizar para o GitHub Copilot Pro ou mudar para o 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 plano gratuito do Copilot.

Etapa 1: Instale o Claude Code CLI

Windows (PowerShell):

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

macOS / Linux:

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

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

Etapa 2: Autentique

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

claude auth

Faça login com sua conta Anthropic (requer plano Claude Pro ou Max).

Etapa 3: Detectar no SeaMeet

1. Em Configurações → IA → Chaves de API → Agente de IA → bloco Claude Code
2. Clique em Atualizar (🔄) para detectar o CLI instalado
3. ✅ "Detectado" aparece quando encontrado

---

Escolhendo seu provedor padrão

Se você tem tanto o Copilot quanto o Claude instalados, o SeaMeet permite que você escolha qual usar por padrão:

1. Vá para Configurações → IA → Chaves de API
2. Na seção Agente de IA, os dois blocos aparecerão como detectados
3. Use o botão de opção ou seletor para escolher o provedor ativo
4. O provedor selecionado é usado para todas as solicitações do Agente de IA

Você pode trocar de provedor a qualquer momento nas Configurações.

---

Verificando se tudo funciona

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

Teste do Resumo de IA:

1. Abra qualquer gravação na sua biblioteca
2. Clique em AI Insights → "Generate Summary"
3. Se concluir sem erro: ✅ A chave Gemini está funcionando

Teste do Agente de IA:

1. Faça uma captura de tela usando o SeaMeet
2. Abra-a no visualizador de capturas de tela
3. Clique na aba de análise de IA e faça uma pergunta
4. Se obtiver uma resposta: ✅ O provedor do Agente de IA está funcionando

---

Atualizando uma chave

Para atualizar sua chave Gemini:

1. Configurações → IA → Chaves de API → Resumo de IA → Editar
2. Limpe a chave antiga e cole a nova
3. Clique em Salvar

Para atualizar seu provedor do Agente:

• Execute novamente as etapas de instalação/autenticação do CLI se uma chave tiver expirado
• Clique em Atualizar no SeaMeet para detectar novamente

---

Referência rápida

┌────────────────────────────────────────────────────────────┐
│                  GUIA DE CONFIGURAÇÃO BYOK                  │
│                  Referência rápida                          │
├────────────────────────────────────────────────────────────┤
│  Fonte da chave Gemini │ aistudio.google.com/apikey (grátis)│
│  Plano gratuito Gemini │ Generoso — suficiente para uso     │
│                        │ típico                             │
│  Inserir chave         │ Config. → IA → Chaves de API →    │
│                        │ Resumo de IA                       │
├────────────────────────────────────────────────────────────┤
│  Instalar Copilot      │ winget / brew / apt (gratuito)    │
│  Auth Copilot          │ gh auth login                      │
│  Limite do Copilot     │ 50 chats/mês (plano gratuito)      │
├────────────────────────────────────────────────────────────┤
│  Instalar Claude       │ script curl/irm (pago)             │
│  Auth Claude           │ claude auth                        │
│  Claude requer         │ Assinatura Claude Pro ou Max       │
├────────────────────────────────────────────────────────────┤
│  Detectar provedor     │ Config. → IA → Chaves API → Atual. 🔄│
│  Trocar provedor       │ Botão de opção na seção Agente IA  │
│  Testar Resumo IA      │ Abrir gravação → "Generate Summary"│
└────────────────────────────────────────────────────────────┘

---

Última atualização: 2026-03-20

← Capítulo 30: Assinatura e cobrança | Capítulo 32: Provedor GitHub Copilot →