Capítulo 31: Guía de configuración BYOK — Configurar tus proveedores de IA

Piensa en BYOK (Bring Your Own Key) como llevar tus propios granos de café a una cafetería que tiene la máquina de espresso: SeaMeet proporciona el motor de extracción y análisis, tú suministras las credenciales de acceso a la IA. Esto mantiene tus datos fluyendo directamente entre tú y tu proveedor de IA elegido, sin intermediarios.

Este capítulo te guía a través de la configuración de ambos componentes requeridos: una clave de Resumen de IA (Gemini) y un proveedor de Agente de IA (GitHub Copilot o Claude Code).

Objetivos del capítulo

Después de leer este capítulo, podrás:

Entender qué claves se necesitan y por qué
Obtener una Clave API de Gemini gratuita desde Google AI Studio
Instalar y configurar GitHub Copilot CLI (nivel gratuito)
Alternativamente, instalar y configurar Claude Code CLI
Verificar que ambos componentes funcionen
Actualizar o eliminar una clave cuando sea necesario

Descripción general: Lo que necesitas

BYOK tiene dos componentes:

┌─────────────────────────────────────────────────────────────┐
│                    BYOK COMPONENTS                          │
├──────────────────────┬──────────────────────────────────────┤
│  A. AI Summary       │  Gemini API key (required)           │
│  (required)          │  Powers: transcription, summaries,   │
│                      │  action items, decisions, chapters   │
├──────────────────────┼──────────────────────────────────────┤
│  B. AI Agent         │  GitHub Copilot CLI  ← OR →          │
│  (need at least one) │  Claude Code CLI                     │
│                      │  Powers: screenshot analysis,        │
│                      │  custom AI queries                   │
└──────────────────────┴──────────────────────────────────────┘

Debes configurar A y al menos una opción de B para que todas las funciones de IA funcionen.

Parte A: Resumen de IA — Clave API de Gemini

¿Por qué Gemini?

SeaMeet usa el modelo Gemini de Google para la transcripción de audio, los resúmenes de reuniones, la extracción de elementos de acción y otros resultados de IA relacionados. La API de Gemini tiene un generoso nivel gratuito que cubre las cargas de trabajo típicas de reuniones.

Obtener tu Clave API de Gemini

Abre tu navegador y ve a Google AI Studio (aistudio.google.com/apikey)
- Inicia sesión con tu cuenta de Google si se te solicita
Haz clic en "Create API Key"
Selecciona o crea un proyecto de Google Cloud cuando se te pida
Copia la clave generada (comienza con AIza…)

Nivel gratuito: El nivel gratuito de Gemini permite un número sustancial de llamadas a la API por día. Para el uso típico de grabación de reuniones (unas pocas horas de audio por semana), el nivel gratuito es suficiente para la mayoría de los usuarios.

Privacidad: Tu audio se envía directamente a la API de Google para la transcripción. Revisa la política de uso de datos de IA de Google si esto es una preocupación para tu caso de uso.

Ingresar tu clave en SeaMeet

Durante el asistente de configuración (primera vez después de suscribirse):

El asistente se abre automáticamente después de suscribirte
El Paso 1 muestra la sección de Resumen de IA
Pega tu Clave API de Gemini en el campo de entrada
La clave se valida automáticamente; verás:
- ✅ Marca de verificación verde: la clave es válida
- ❌ X roja: la clave es inválida o se copió incorrectamente; revisa y vuelve a pegar
Haz clic en "Next" para continuar con la configuración del Agente de IA

Más tarde, a través de Configuración:

Abre Configuración (⚙️)
Navega a AI → API Keys
Encuentra la sección "AI Summary"
Haz clic en "Edit" o pega en el campo de Clave API de Gemini
Haz clic en "Save" — la clave se valida automáticamente

Probar y eliminar una clave

En la configuración de claves API:

Botón "Test" — valida la clave contra la API de Google
Botón "Remove" — elimina la clave almacenada; las funciones de Resumen de IA no estarán disponibles hasta que agregues una nueva clave

Si una clave falla la validación, se borra automáticamente para evitar almacenar una clave defectuosa. Simplemente pega una nueva.

Parte B: Proveedor de Agente de IA

Necesitas al menos un proveedor de Agente de IA. SeaMeet actualmente admite dos:

Proveedor	Costo	Límite	Mejor para
GitHub Copilot CLI	Gratuito (plan Copilot Free)	50 chats/mes	Comenzar, uso ligero
Claude Code CLI	De pago (Claude Pro o Max)	Límites más altos	Uso regular, usuarios avanzados

Puedes instalar ambos y cambiar entre ellos desde Configuración → AI.

Opción 1: GitHub Copilot CLI (Gratuito)

GitHub Copilot CLI es una herramienta de línea de comandos que SeaMeet usa como su Agente de IA. El nivel gratuito de GitHub Copilot incluye 50 solicitudes de agente por mes, suficiente para análisis ocasional de capturas de pantalla y consultas de IA.

Paso 1: Instalar GitHub Copilot CLI

Elige el método que corresponda a tu sistema:

Windows (winget):

winget install GitHub.cli

macOS (Homebrew):

brew install gh

Linux (apt):

sudo apt install gh

Nota: SeaMeet muestra botones de copiar junto a cada comando en la interfaz de configuración; puedes copiar el comando exacto sin escribirlo.

Paso 2: Autenticar con GitHub

Después de la instalación, abre una terminal y ejecuta:

gh auth login

Sigue las indicaciones para iniciar sesión en tu cuenta de GitHub. Esto vincula el CLI a tu cuenta de GitHub y habilita las funciones de Copilot.

Paso 3: Detectar en SeaMeet

En la configuración de claves API de SeaMeet (o Configuración → AI → API Keys):
Encuentra la sección "AI Agent" → ficha "GitHub Copilot"
Haz clic en "Refresh" (🔄)
SeaMeet busca el CLI instalado
Si se encuentra: aparece el estado ✅ "Detected"
Si no se encuentra: revisa tu instalación y repite

Límite de 50 chats/mes: El plan gratuito de Copilot es generoso para comenzar, pero si usas el Agente de IA con frecuencia podrías alcanzar el límite. Puedes actualizar a GitHub Copilot Pro, o cambiar a Claude Code CLI para obtener límites más altos.

Opción 2: Claude Code CLI (De pago)

Claude Code es la herramienta CLI de Anthropic. Requiere una suscripción Claude Pro o Max, pero tiene límites de uso más altos que el nivel gratuito de Copilot.

Paso 1: Instalar Claude Code CLI

Windows (PowerShell):

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

macOS / Linux:

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

La interfaz de configuración de SeaMeet muestra botones de copiar para cada comando de instalación.

Paso 2: Autenticar

Después de la instalación, abre una terminal y ejecuta:

claude auth

Inicia sesión con tu cuenta de Anthropic (requiere plan Claude Pro o Max).

Paso 3: Detectar en SeaMeet

En Configuración → AI → API Keys → "AI Agent" → ficha "Claude Code"
Haz clic en "Refresh" (🔄) para detectar el CLI instalado
Aparece ✅ "Detected" cuando se encuentra

Elegir tu proveedor predeterminado

Si tienes Copilot y Claude instalados, SeaMeet te permite elegir cuál usar de forma predeterminada:

Ve a Configuración → AI → API Keys
En la sección "AI Agent", ambas fichas aparecerán como detectadas
Usa el botón de opción o selector para elegir el proveedor activo
El proveedor seleccionado se usa para todas las solicitudes del Agente de IA

Puedes cambiar de proveedor en cualquier momento desde Configuración.

Verificar que todo funciona

Después de la configuración, realiza una comprobación completa de extremo a extremo:

Probar Resumen de IA:

Abre cualquier grabación de tu biblioteca
Haz clic en "AI Insights" → "Generate Summary"
Si se completa sin errores: ✅ La Clave API de Gemini funciona

Probar Agente de IA:

Toma una captura de pantalla con SeaMeet
Ábrela en el visor de capturas de pantalla
Haz clic en la pestaña de análisis de IA y haz una pregunta
Si obtienes una respuesta: ✅ El proveedor de Agente de IA funciona

Actualizar una clave

Para actualizar tu Clave API de Gemini:

Configuración → AI → API Keys → AI Summary → "Edit"
Borra la clave antigua y pega la nueva
Haz clic en "Save"

Para actualizar tu proveedor de Agente:

Vuelve a ejecutar los pasos de instalación/autenticación del CLI si una clave ha expirado
Haz clic en "Refresh" en SeaMeet para volver a detectar

Referencia rápida

┌────────────────────────────────────────────────────────────┐
│                  BYOK SETUP GUIDE                          │
│                  Quick Reference                           │
├────────────────────────────────────────────────────────────┤
│  Gemini key source │ aistudio.google.com/apikey (free)     │
│  Gemini free tier  │ Generous — enough for typical use     │
│  Enter key         │ Settings → AI → API Keys → AI Summary │
├────────────────────────────────────────────────────────────┤
│  Copilot install   │ winget / brew / apt (free)            │
│  Copilot auth      │ gh auth login                         │
│  Copilot limit     │ 50 chats/month (free tier)            │
├────────────────────────────────────────────────────────────┤
│  Claude install    │ curl/irm install script (paid)        │
│  Claude auth       │ claude auth                           │
│  Claude requires   │ Claude Pro or Max subscription        │
├────────────────────────────────────────────────────────────┤
│  Detect provider   │ Settings → AI → API Keys → Refresh 🔄│
│  Switch provider   │ Radio button in AI Agent section      │
│  Test AI Summary   │ Open recording → Generate Summary     │
└────────────────────────────────────────────────────────────┘

Last updated: 2026-03-20

← Capítulo 30: Suscripción y facturación | Capítulo 32: Proveedor GitHub Copilot →