Capítulo 32: Fornecedor GitHub Copilot — Usar o Copilot como Agente de IA

O Agente de IA do SeaMeet alimenta a análise de capturas de tela, consultas de IA personalizadas e fluxos de trabalho interativos de IA. Em vez de incluir um único modelo de IA, o SeaMeet permite-lhe escolher o seu fornecedor de agente — o motor de IA que trata destas tarefas. O GitHub Copilot é um dos dois fornecedores suportados, e o seu plano gratuito torna-o a forma mais fácil de começar.

Este capítulo aprofunda o fornecedor Copilot especificamente: como o SeaMeet o deteta, como mudar para ele ou afastar-se dele, e o que esperar dos seus limites de utilização.

Objetivos do Capítulo

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

Compreender como o SeaMeet usa o GitHub Copilot CLI como fornecedor
Instalar, autenticar e verificar o Copilot no SeaMeet
Atualizar a deteção do fornecedor quando o estado não se atualiza
Eliminar ou remover a integração Copilot
Alternar entre Copilot e Claude Code como fornecedor ativo
Trabalhar dentro do limite de 50 chats/mês do plano gratuito

Como o SeaMeet Usa o GitHub Copilot

O SeaMeet usa o GitHub Copilot CLI (gh copilot) como subprocesso. Quando aciona uma ação do Agente de IA — analisar uma captura de tela, fazer uma pergunta sobre uma gravação — o SeaMeet chama a ferramenta CLI, que comunica com o backend de IA do GitHub e devolve o resultado.

Isto significa:

Nenhuma chave de API para introduzir manualmente para o Copilot — a autenticação é tratada através do GitHub CLI (gh auth login)
As suas consultas vão diretamente da sua máquina para os servidores do GitHub
O papel do SeaMeet é formatar o pedido e apresentar a resposta

Deteção: Como o SeaMeet Encontra o Copilot

O SeaMeet não monitoriza o Copilot CLI continuamente. Em vez disso, deteta-o a pedido quando clica em Refresh.

O que "detected" significa:

O CLI gh está instalado e acessível no seu PATH
gh copilot está disponível (extensão Copilot instalada)
Está autenticado com gh auth login

Estados de deteção:

Indicador de estado	Significado
✅ Detected	CLI está instalado e autenticado — pronto a usar
⚠️ Not detected	CLI não encontrado, ou não está no PATH
❌ Auth required	CLI encontrado mas não autenticado — execute `gh auth login`

Como acionar a deteção:

Settings → AI → API Keys
Na secção AI Agent, encontre o tile GitHub Copilot
Clique no botão Refresh (🔄)
O SeaMeet volta a verificar e atualiza o estado

Clique em Refresh sempre que instalar, atualizar ou reautenticar o CLI.

Configuração Inicial (Resumo)

Se ainda não configurou o Copilot, os passos completos estão no Capítulo 31. Em resumo:

Instalar o GitHub CLI:
- Windows: winget install GitHub.cli
- macOS: brew install gh
- Qualquer: sudo apt install gh
Autenticar: gh auth login
Detetar no SeaMeet: Settings → AI → API Keys → tile Copilot → Refresh 🔄

Remover a Integração Copilot

Se já não quer usar o Copilot com o SeaMeet:

Settings → AI → API Keys
Encontre o tile GitHub Copilot
Clique em Delete (🗑️)

Isto remove o Copilot como fornecedor configurado no SeaMeet. Não desinstala o GitHub CLI do seu sistema — o Copilot continua a funcionar no seu terminal.

Após a eliminação, se nenhum outro fornecedor estiver configurado, as funcionalidades do Agente de IA ficarão indisponíveis até configurar um fornecedor.

Alternar Entre Copilot e Claude Code

Se tem tanto o GitHub Copilot como o Claude Code instalados, pode escolher qual o SeaMeet utiliza:

Settings → AI → API Keys
Ambos os tiles de fornecedores aparecem como detetados
Selecione o botão de opção no fornecedor que quer usar
A sua seleção é guardada imediatamente — não é necessário reiniciar

Copilot vs. Claude Code resumidamente:

	GitHub Copilot	Claude Code
Custo	Gratuito (plano GitHub Free)	Requer Claude Pro ou Max
Limite mensal	50 chats/mês (plano gratuito)	Limites superiores (Pro/Max)
Melhor para	Uso ocasional, começar	Uso regular do Agente de IA
Instalação	CLI `gh`	Instalador separado
Autenticação	`gh auth login` (conta GitHub)	`claude auth` (conta Anthropic)

Compreender o Limite de 50 Chats/Mês

O plano gratuito do GitHub Copilot inclui 50 pedidos de chat Copilot por mês. Cada ação do Agente de IA no SeaMeet — analisar uma captura de tela, fazer uma pergunta — conta como um pedido.

O que acontece quando atinge o limite:

O Copilot devolve uma resposta de erro
O SeaMeet apresenta um erro no painel do Agente de IA
Gravação, transcrição e Resumo de IA (Gemini) não são afetados — usam quota separada

Se atinge o limite frequentemente:

Faça upgrade para GitHub Copilot Pro (limite mensal superior, pago)
Ou mude para Claude Code como fornecedor do Agente de IA (Capítulo 31)

Dica: O limite de 50 pedidos reinicia no início de cada mês civil. Se atingir o limite perto do final do mês, pode esperar pelo reset ou mudar temporariamente para o Claude Code.

Resolução de Problemas

"Copilot aparece como Not Detected após instalar"

Causa mais provável: O CLI gh foi instalado mas não está no PATH do seu sistema, ou a sessão do terminal não foi recarregada.

Tente:

Abra uma nova janela de terminal e execute gh --version
Se falhar, o CLI não está no PATH — reinstale ou adicione o diretório de instalação ao PATH manualmente
Se gh --version funcionar, clique em Refresh no SeaMeet novamente

"Auth Required"

Causa: O CLI está instalado mas não iniciou sessão.

Solução: Abra um terminal e execute gh auth login. Siga os prompts do navegador para se autenticar com o GitHub.

"Pedidos do agente falham a meio do mês"

Causa: Usou os seus 50 pedidos de chat Copilot do mês.

Solução: Mude para o CLI Claude Code como fornecedor ativo (Settings → AI → API Keys → selecione o botão de opção Claude Code), ou espere até o limite mensal reiniciar.

Referência Rápida

┌────────────────────────────────────────────────────────────┐
│               FORNECEDOR GITHUB COPILOT                    │
│                   Referência Rápida                        │
├────────────────────────────────────────────────────────────┤
│  Instalar (Windows) │ winget install GitHub.cli            │
│  Instalar (macOS)   │ brew install gh                      │
│  Autenticar         │ gh auth login                        │
│  Detetar no SeaMeet │ Settings → AI → API Keys → Refresh 🔄│
├────────────────────────────────────────────────────────────┤
│  Limite gratuito    │ 50 chats/mês                         │
│  Reinicia           │ Primeiro dia de cada mês civil       │
│  Excedeu limite?    │ Mude para Claude Code, ou upgrade    │
├────────────────────────────────────────────────────────────┤
│  Remover            │ API Keys → tile Copilot → Delete 🗑️  │
│  Mudar fornecedor   │ API Keys → botão de opção            │
├────────────────────────────────────────────────────────────┤
│  O que alimenta     │ Análise de capturas, consultas IA    │
│  O que não alimenta │ Resumo de IA (isso é Gemini)         │
└────────────────────────────────────────────────────────────┘

Last updated: 2026-03-20

← Capítulo 31: Guia de Configuração BYOK

Fornecedor GitHub Copilot - Usar o Copilot como Agente de IA