Configuração de Coding Agents

Configurar GitHub Copilot: API Key, Base URL e modelos

Instale o GitHub Copilot, configure a Base URL e a API Key da BetterToken, escolha um modelo disponível e corrija erros comuns. Com exemplos.

Para conectar o GitHub Copilot à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
URL completa da solicitação	`https://bettertoken.ai/v1/chat/completions`
Modelo	Um ID de modelo atual da model plaza

Pré-requisitos

A versão atual da ferramenta está instalada
Uma BetterToken API Key: cadastre-se e crie uma
Um ID de modelo da model plaza

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Requisitos adicionais

A versão mais recente do VS Code está instalada
GitHub Copilot / Copilot Chat está instalado e conectado
Copie o Model ID exato da model plaza.
Um ID de modelo está disponível, por exemplo YOUR_MODEL_ID

Instalação

Instale ou abra o GitHub Copilot e continue com a configuração manual abaixo.

Configuração manual

Campo	Valor
API Key	BetterToken API Key
URL completa da solicitação	`https://bettertoken.ai/v1/chat/completions`
Modelo	Um ID de modelo atual da model plaza

Etapas de configuração

Abra o gerenciamento de modelos

Na área de entrada do Copilot Chat, clique no seletor de modelos e escolha Manage Language Models (ícone de engrenagem). Você também pode executar Chat: Manage Language Models na Paleta de Comandos.

Abra Manage Models no seletor de modelos do Copilot Chat.

Adicione Custom Endpoint

Em Language Models, clique em Add Models e escolha Custom Endpoint.

Clique em Add Models em Language Models e escolha Custom Endpoint.

Informe o nome do grupo

Em Group Name, informe:

BetterToken

Depois pressione Enter.

Informe BetterToken no campo Group Name.

Informe a API Key

O VS Code solicitará a API Key. Cole sua BetterToken API Key e pressione Enter.

Esse valor não aparecerá diretamente no arquivo de configuração. O VS Code o armazena como segredo local e gera uma referência como esta:

"apiKey": "${input:chat.lm.secret.xxxxx}"

Selecione o tipo de API

Em Custom Endpoint: API Type, selecione Chat Completions.

Selecione Chat Completions em Custom Endpoint API Type.

Edite a configuração JSON

O VS Code abre chatLanguageModels.json. Confirme ou atualize a configuração:

Antes de salvar, substitua os limites de tokens do exemplo pelos limites confirmados do modelo escolhido. A soma não pode exceder a janela de contexto. O exemplo mantém chamadas de ferramentas e entrada de imagens desativadas; ative cada recurso somente quando o modelo e o endpoint oferecerem suporte. O modo Agent requer chamadas de ferramentas. Consulte a referência oficial dos campos.

Configure URL do modelo BetterToken, toolCalling, vision e limites de token em chatLanguageModels.json.

[
  {
    "name": "BetterToken",
    "vendor": "customendpoint",
    "apiKey": "${input:chat.lm.secret.xxxxx}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "YOUR_MODEL_ID",
        "name": "YOUR_MODEL_ID",
        "url": "https://bettertoken.ai/v1/chat/completions",
        "toolCalling": false,
        "vision": false,
        "maxInputTokens": 1000000,
        "maxOutputTokens": 64000
      }
    ]
  }
]

Verifique estes campos:

Campo	Valor a definir
`name`	`BetterToken`
`apiType`	`chat-completions`
`id`	`YOUR_MODEL_ID` ou outro ID de modelo disponível da model plaza
`name`	Igual ao ID de modelo
`url`	`https://bettertoken.ai/v1/chat/completions`
`toolCalling`	Defina `true` somente com suporte confirmado a ferramentas; é obrigatório para o modo Agent
`vision`	Defina `true` somente com suporte confirmado a entrada de imagens
`maxInputTokens`	Substitua o exemplo pelo limite de entrada confirmado
`maxOutputTokens`	Substitua o exemplo pelo limite de saída confirmado; mantenha entrada + saída dentro da janela de contexto

Salve e recarregue o VS Code

Salve chatLanguageModels.json e execute:

Developer: Reload Window

Após recarregar, volte ao seletor de modelos do Copilot Chat e escolha YOUR_MODEL_ID.

Envie uma mensagem de teste

Envie uma mensagem simples no Copilot Chat:

Describe the model you are using in one sentence.

Se o Copilot Chat responder normalmente, o Custom Endpoint da BetterToken estará configurado com êxito.

Verifique a conexão

Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.

Alterne entre modelos

Abra o seletor de modelos ou altere o campo Model na configuração. Use o ID de modelo exato da model plaza e reinicie a sessão atual.

Erros comuns

Por que devo informar a API Key no prompt?

O VS Code armazena a API Key no armazenamento local de segredos e a referencia no JSON com ${input:chat.lm.secret...}. Isso é mais seguro do que gravar a API Key real no arquivo JSON.

Por que usar Chat Completions?

A configuração com funcionamento verificado usa Chat Completions. A URL é:

https://bettertoken.ai/v1/chat/completions

Neste exemplo de Chat Completions, mantenha apiType e a URL como mostrados; não pare em /v1.

Isso substitui a conclusão em linha do GitHub Copilot?

Não. Este Custom Endpoint é usado principalmente para chamadas de modelo de linguagem do Copilot Chat. A conclusão em linha do GitHub Copilot continua sendo fornecida pelo próprio GitHub Copilot.

O que fazer se aparecer Invalid token?

Verifique estes itens na ordem:

A API Key foi informada no prompt do VS Code
O JSON mantém a referência ${input:chat.lm.secret...}
Copie o Model ID exato da model plaza.
url is https://bettertoken.ai/v1/chat/completions
apiType is chat-completions
O ID de modelo é disponível na model plaza

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Neste exemplo de Chat Completions, o campo url do modelo exige o endereço completo https://bettertoken.ai/v1/chat/completions. O VS Code não acrescenta /chat/completions nesse campo.