SeaMeet Desktop is here — Record everything, miss nothing. Download free →

Guida alla configurazione BYOK - Configurazione dei tuoi provider AI

Capitolo 36: Guida alla configurazione BYOK — Configurazione dei vostri provider AI

Pensate a BYOK (Bring Your Own Key) come a portare i vostri chicchi di caffè in un caffè che ha la macchina espresso—SeaMeet fornisce il motore di estrazione e analisi, voi fornite le credenziali di accesso AI. Questo mantiene i vostri dati che fluiscono direttamente tra voi e il vostro provider AI scelto, senza relè di terze parti.

Questo capitolo vi guida attraverso la configurazione di entrambi i componenti richiesti: una chiave Riepilogo AI (Gemini) e un provider Agente AI (GitHub Copilot o Claude Code). Copre anche un vantaggio che spesso sorprende i nuovi abbonati — il vostro piano BYOK Pro include anche la sincronizzazione gratuita tra dispositivi tramite GitHub, non solo l'accesso AI.

Include la sincronizzazione GitHub

A partire da v2.1.x, ogni abbonamento BYOK Pro viene fornito con sincronizzazione tra dispositivi di note e wiki tramite il vostro repository GitHub privato — senza costi aggiuntivi, un repo per workspace, nessun limite di archiviazione. La sincronizzazione era invisibile nelle schermate di upgrade; ora è in evidenza nel hero di valore Pre-Subscribe, nella scheda Piano, nelle FAQ BYOK Explainer e nella schermata delle impostazioni Sync.

Come differisce dal piano dedicato Sync Pro: BYOK sincronizza solo il testo leggero (note + wiki) tramite il vostro GitHub. Sync Pro è un servizio gestito separatamente che sincronizza tutto — note, audio, video e schermate — tramite l'infrastruttura di SeaMeet. La maggior parte degli utenti BYOK ha solo bisogno della sincronizzazione del testo che è già inclusa.

Vedi Capitolo 38: Sincronizzazione GitHub per la guida completa.

Obiettivi del capitolo

Dopo aver letto questo capitolo, sarete in grado di:

  • Capire quali chiavi sono necessarie e perché
  • Ottenere una Chiave API Gemini gratuita da Google AI Studio
  • Installare e configurare GitHub Copilot CLI (livello gratuito)
  • Alternativamente installare e configurare Claude Code CLI
  • Configurare la sincronizzazione GitHub che è inclusa nel vostro abbonamento (Capitolo 38)
  • Verificare che entrambi i componenti funzionino
  • Aggiornare o rimuovere una chiave quando necessario

Panoramica: cosa vi serve

BYOK ha due componenti di configurazione — più un vantaggio incluso che non dovete configurare:

┌─────────────────────────────────────────────────────────────┐
│                    COMPONENTI BYOK                          │
├──────────────────────┬──────────────────────────────────────┤
│  A. Riepilogo AI     │  Chiave API Gemini (richiesta)       │
│  (richiesto)         │  Alimenta: trascrizione, riepiloghi, │
│                      │  elem. d'azione, decisioni, capitoli │
├──────────────────────┼──────────────────────────────────────┤
│  B. Agente AI        │  GitHub Copilot CLI  ← OPPURE →      │
│  (almeno uno)        │  Claude Code CLI                     │
│                      │  Alimenta: analisi schermate,        │
│                      │  query AI personalizzate             │
├──────────────────────┼──────────────────────────────────────┤
│  C. Sincr. GitHub    │  Incluso con BYOK Pro                │
│  (incluso, opzionale)│  Repo GitHub privato per workspace.  │
│                      │  Sincronizza note + wiki tra disp.   │
│                      │  Configurazione: Capitolo 38.        │
└──────────────────────┴──────────────────────────────────────┘

Dovete configurare A e almeno un'opzione da B affinché tutte le Funzionalità AI funzionino. C è opzionale ma già pagato — attivatelo ogni volta che siete pronti per la sincronizzazione tra dispositivi.

Riepilogo della proposta di valore

Cosa copre $4,99/mese BYOK Pro:

  • Privacy — i dati vanno direttamente dal vostro dispositivo a Google / Anthropic / OpenAI; i server SeaMeet non li vedono mai.
  • Qualità — scegliete il miglior modello per il lavoro.
  • Controllo dei costi — pagate i provider direttamente; la maggior parte degli utenti rimane nel livello gratuito di Gemini.
  • Sovranità — le chiavi vivono nel vostro keychain del SO; revocate in qualsiasi momento.
  • Sincronizzazione gratuita e privata — eseguite il backup di note e wiki nel vostro repository GitHub privato.

Dove lo vedrete nell'app

Questi cinque vantaggi sono rinforzati attraverso ogni touchpoint di upgrade BYOK tramite il BYOK Value Hero condiviso — sul Pre-Subscribe explainer, sulla ricevuta post-abbonamento, su Impostazioni → AI, sulle Locked Feature Cards che appaiono quando un utente gratuito clicca una funzionalità con gate AI (trascrizione, riepilogo, elementi d'azione, sintesi note, lista wiki, AI schermate) e sul banner delle impostazioni Sync.

Parte A: Riepilogo AI — Chiave API Gemini

Perché Gemini?

SeaMeet usa il modello Gemini di Google per la trascrizione audio, i riepiloghi delle riunioni, l'estrazione di elementi d'azione e i relativi output AI. L'API Gemini ha un generoso livello gratuito che copre i tipici carichi di lavoro di riunioni.

Ottenere la vostra Chiave API Gemini

  1. Aprite il vostro browser e andate a Google AI Studio (aistudio.google.com/apikey)
    • Accedete con il vostro account Google se richiesto
  2. Cliccate Create API Key
  3. Selezionate o create un progetto Google Cloud quando richiesto
  4. Copiate la chiave generata (inizia con AIza…)

Livello gratuito: Il livello gratuito di Gemini consente un numero sostanziale di chiamate API al giorno. Per l'utilizzo tipico di registrazione di riunioni (alcune ore di audio a settimana), il livello gratuito è sufficiente per la maggior parte degli utenti.

Privacy: Il vostro audio viene inviato direttamente all'API di Google per la trascrizione. Rivedete la politica di utilizzo dei dati AI di Google se questo è una preoccupazione per il vostro caso d'uso.

Inserire la vostra chiave in SeaMeet

Durante la configurazione guidata (prima volta dopo l'abbonamento):

  1. La configurazione guidata si apre automaticamente dopo l'abbonamento
  2. Il passo 1 mostra la sezione Riepilogo AI
  3. Incollate la vostra chiave Gemini nel campo di input
  4. La chiave viene convalidata automaticamente — vedrete:
    • ✅ Segno di spunta verde: La chiave è valida
    • ❌ X rossa: La chiave non è valida o copiata in modo errato — controllate e re-incollate
  5. Cliccate Successivo per procedere alla configurazione dell'Agente AI

Dopo, tramite Impostazioni:

  1. Aprite Impostazioni (⚙️)
  2. Navigate a AI → API Keys
  3. Trovate la sezione Riepilogo AI
  4. Cliccate Modifica o incollate nel campo della chiave Gemini
  5. Cliccate Salva — la chiave viene convalidata automaticamente

Testare e rimuovere una chiave

Nelle impostazioni delle Chiavi API:

  • Pulsante Testa — convalida la chiave contro l'API di Google
  • Pulsante Rimuovi — elimina la chiave memorizzata; le funzionalità Riepilogo AI saranno non disponibili finché non aggiungerete una nuova chiave

Se una chiave non supera la convalida, viene automaticamente cancellata per prevenire la memorizzazione di una chiave rotta. Semplicemente incollatene una nuova.

Parte B: Provider Agente AI

Avete bisogno di almeno un provider Agente AI. SeaMeet attualmente ne supporta due:

ProviderCostoLimiteIdeale per
GitHub Copilot CLIGratuito (piano Copilot Free)50 chat/meseIniziare, uso leggero
Claude Code CLIA pagamento (Claude Pro o Max)Limiti più altiUso regolare, utenti esperti

Potete installare entrambi e passare tra di loro da Impostazioni → AI.

Opzione 1: GitHub Copilot CLI (gratuito)

GitHub Copilot CLI è uno strumento da riga di comando che SeaMeet usa come suo Agente AI. Il livello gratuito di GitHub Copilot include 50 richieste agente al mese — abbastanza per analisi occasionale di schermate e query AI.

Passo 1: Installare GitHub Copilot CLI

Scegliete il metodo che corrisponde al vostro sistema:

Windows (winget):

winget install GitHub.cli

macOS (Homebrew):

brew install gh

Linux (apt):

sudo apt install gh

Nota: SeaMeet mostra pulsanti di copia accanto a ogni comando nell'UI di configurazione — potete copiare il comando esatto senza digitarlo. Per altre distribuzioni Linux, vedi i docs di installazione GitHub CLI.

Passo 2: Autenticare con GitHub

Dopo l'installazione, aprite un terminale ed eseguite:

gh auth login

Seguite i prompt per accedere al vostro account GitHub. Questo collega la CLI al vostro account GitHub e abilita le funzionalità Copilot.

Passo 3: Rilevare in SeaMeet

  1. Nella configurazione Chiavi API di SeaMeet (o Impostazioni → AI → API Keys):
  2. Trovate la sezione Agente AI → tile GitHub Copilot
  3. Cliccate Aggiorna (🔄)
  4. SeaMeet scansiona la CLI installata
  5. Se trovata: appare stato ✅ "Rilevato"
  6. Se non trovata: controllate la vostra installazione e ripetete

Limite 50 chat/mese: Il piano Copilot gratuito è abbastanza generoso per iniziare, ma se usate l'Agente AI frequentemente potreste raggiungere il limite. Potete fare l'upgrade a GitHub Copilot Pro, o passare a Claude Code CLI per limiti più alti.

Opzione 2: Claude Code CLI (a pagamento)

Claude Code è lo strumento CLI di Anthropic. Richiede un abbonamento Claude Pro o Max ma ha limiti di utilizzo più alti del livello Copilot gratuito.

Passo 1: Installare Claude Code CLI

Windows (PowerShell):

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

macOS / Linux:

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

L'UI di configurazione di SeaMeet mostra pulsanti di copia per ogni comando di installazione.

Passo 2: Autenticare

Dopo l'installazione, aprite un terminale ed eseguite:

claude auth

Accedete con il vostro account Anthropic (richiede piano Claude Pro o Max).

Passo 3: Rilevare in SeaMeet

  1. In Impostazioni → AI → API Keys → Agente AI → tile Claude Code
  2. Cliccate Aggiorna (🔄) per rilevare la CLI installata
  3. ✅ "Rilevato" appare quando trovato

Scegliere il vostro provider predefinito

Se avete sia Copilot che Claude installati, SeaMeet vi permette di scegliere quale usare per impostazione predefinita:

  1. Andate a Impostazioni → AI → API Keys
  2. Nella sezione Agente AI, entrambi i tile mostreranno come rilevati
  3. Usate il pulsante radio o selettore per scegliere il provider attivo
  4. Il provider selezionato viene usato per tutte le richieste Agente AI

Potete passare i provider in qualsiasi momento dalle Impostazioni.

Verificare che tutto funzioni

Dopo la configurazione, fate un rapido controllo end-to-end:

Testate il Riepilogo AI:

  1. Aprite qualsiasi registrazione nella vostra libreria
  2. Cliccate AI Insights → Genera riepilogo
  3. Se si completa senza errori: ✅ La chiave Gemini funziona

Testate l'Agente AI:

  1. Scattate una schermata usando SeaMeet
  2. Apritela nel visualizzatore di schermate
  3. Cliccate la scheda di analisi AI e fate una domanda
  4. Se ottenete una risposta: ✅ Il provider Agente AI funziona

Aggiornare una chiave

Per aggiornare la vostra chiave Gemini:

  1. Impostazioni → AI → API Keys → Riepilogo AI → Modifica
  2. Cancellate la vecchia chiave e incollate quella nuova
  3. Cliccate Salva

Per aggiornare il vostro provider Agente:

  • Rieseguite i passaggi di installazione/autenticazione CLI se una chiave è scaduta
  • Cliccate Aggiorna in SeaMeet per rilevare di nuovo

Riferimento rapido

┌────────────────────────────────────────────────────────────┐
│                  GUIDA CONFIGURAZIONE BYOK                 │
│                  Riferimento rapido                        │
├────────────────────────────────────────────────────────────┤
│  Fonte chiave Gemini│ aistudio.google.com/apikey (gratis)  │
│  Livello gratuito   │ Generoso — sufficiente per uso tipic.│
│  Inserire chiave    │ Imp. → AI → API Keys → Riepilogo AI  │
├────────────────────────────────────────────────────────────┤
│  Inst. Copilot      │ winget / brew / apt (gratis)         │
│  Auth Copilot       │ gh auth login                        │
│  Limite Copilot     │ 50 chat/mese (livello gratuito)      │
├────────────────────────────────────────────────────────────┤
│  Inst. Claude       │ script install curl/irm (a pagam.)   │
│  Auth Claude        │ claude auth                          │
│  Claude richiede    │ Abbonamento Claude Pro o Max         │
├────────────────────────────────────────────────────────────┤
│  Rilevare provider  │ Imp. → AI → API Keys → Aggiorna 🔄  │
│  Cambiare provider  │ Pulsante radio nella sez. Agente AI  │
│  Testare Riep. AI   │ Apri reg. → Genera riepilogo         │
└────────────────────────────────────────────────────────────┘

Capitoli correlati

  • Cap. 31: Trascrizione in tempo reale · Cap. 32: Estrazione AI · Cap. 33: Modelli di riepilogo AI · Cap. 34: Modifica dei risultati AI — tutti alimentati dalla vostra chiave Gemini
  • Capitolo 35: Abbonamento e fatturazione — gestione del piano e portale di fatturazione
  • Capitolo 37: Copilot — usare GitHub Copilot CLI come Agente AI
  • Capitolo 38: Sincronizzazione GitHub — la sincronizzazione tra dispositivi inclusa con il vostro piano BYOK Pro

Ultimo aggiornamento: 2026-06-04

← Capitolo 35: Abbonamento e fatturazione | Capitolo 37: Copilot →

Published:

Previous
Abbonamento e fatturazione - Sblocca SeaMeet AI
Next
Fornitore GitHub Copilot - Usare Copilot come Agente AI