Configurar o Goose: API Key, Base URL e modelos

Conecte o Goose ao BetterToken pelo provedor OpenAI. Nos testes em macOS com um modelo GPT, o Goose 1.55.0 concluiu solicitações de texto e chamadas de ferramentas para leitura de arquivos por /v1/responses.

Configurações principais

Campo	Valor
API Key	BetterToken API Key em OPENAI_API_KEY
Base URL	https://bettertoken.ai em OPENAI_HOST, sem /v1
Modelo	YOUR_MODEL_ID em GOOSE_MODEL
Provedor	GOOSE_PROVIDER=openai

Pré-requisitos

• Um terminal macOS ou Linux para os comandos abaixo
• Uma BetterToken API Key: cadastre-se e obtenha uma
• Um ID de modelo copiado da model plaza

Instalar

Use o instalador oficial do Goose:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
goose --version

Configuração manual

Substitua YOUR_API_KEY e YOUR_MODEL_ID antes de executar:

export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="YOUR_MODEL_ID"
export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_HOST="https://bettertoken.ai"

OPENAI_HOST recebe o endereço raiz do site. Não inclua /v1 nesse campo, mesmo usando o provedor OpenAI.

Para acessar arquivos, execute goose configure, escolha Toggle Extensions e ative developer. A extensão developer fornece ferramentas de arquivos e de shell.

Verificar a conexão

Execute este comando no mesmo terminal:

goose run --no-session --max-turns 4 -t "Reply with only: OK"

Confira se a resposta final é OK. Para verificar o acesso a arquivos separadamente, execute o Goose no projeto e peça que leia um arquivo conhecido; confira tanto o resultado da ferramenta quanto a resposta final.

Trocar de modelo

Defina GOOSE_MODEL com outro ID de modelo exato da model plaza e inicie uma nova execução.

Erros comuns

Sintoma	O que verificar
Falha na autenticação	Confira OPENAI_API_KEY no terminal que executa o Goose.
URL de solicitação incorreta	Defina OPENAI_HOST como https://bettertoken.ai, sem /v1 nem o sufixo de um endpoint.
Ferramentas de arquivos indisponíveis	Ative a extensão integrada developer com goose configure.
As solicitações ainda usam Responses	Nos testes com Goose 1.55.0, nem mesmo OPENAI_BASE_PATH=v1/chat/completions mudou a rota do modelo testado, que continuou em /v1/responses. Confira o caminho real da solicitação.

Conteúdo relacionado

• Compare as ferramentas compatíveis
• Erros da API e limites de requisições
• Variáveis de ambiente do Goose

Detalhes técnicos

As solicitações de texto e de leitura de arquivos testadas usaram /v1/responses. Os nomes do provedor e das variáveis de ambiente, por si só, não determinam qual protocolo o Goose seleciona para outro modelo.