Use a CLI para um fluxo no terminal com arquivos locais selecionados e ações locais explícitas. Use a API quando precisar do contrato publicado de requisição e resposta dentro da sua aplicação. Os clientes compartilham controles da conta, mas suas sintaxes não são intercambiáveis.
A documentação é a referência para instalação, escopos de autenticação e campos atuais dos endpoints. Comece por ela, em vez de adaptar um exemplo de outro provedor mudando apenas a URL.
Antes de começar
- A documentação atual da CLI ou API e um alias de modelo publicado pelo servidor.
- Uma credencial com escopos adequados, guardada no ambiente ou gerenciador de segredos, nunca no repositório.
- Um prompt curto sem dados sensíveis e um orçamento pequeno de saída para a primeira requisição real.
Siga as etapas
- Confira as instruções atuais de instalação e autenticação do cliente escolhido. Mantenha a credencial no servidor e fora de bundles de navegador e registros de terminal.
- Na API, copie o exemplo documentado de chat completions e revise modelo, mensagens e limite de saída. Use o alias e as capacidades atuais do catálogo.
- Na CLI, selecione explicitamente modo e arquivos. Uma operação de arquivo exige o opt-in documentado; não implica envio recursivo do repositório.
- Confira resposta, uso e identificador da requisição antes de adicionar retries ou concorrência. Um timeout não comprova que nenhum trabalho ocorreu.
- Automatize após testar falhas, cancelamento quando suportado e limites de orçamento. Siga a idempotência documentada em vez de repetir uma criação sem verificar o resultado.
Use um prompt preciso
Adapte às suas evidências
Ajude a revisar esta integração antes da primeira requisição. Confira se as credenciais ficam fora do código e do navegador, se o alias vem do catálogo atual e se o orçamento de saída está explícito. Identifique como o cliente trata timeout, limite de requisições e resultado desconhecido sem criar trabalho duplicado.
Verifique seu trabalho
- A requisição real usa o endpoint documentado e campos suportados; copiar um exemplo não comprova integração.
- Segredos não aparecem no código, nas requisições do navegador, nos logs nem nos relatórios exportados.
- Uso e erros são tratados pelas respostas reais, e a concorrência respeita os limites efetivos da conta.
Leve suas evidências para uma conversa e avance para a próxima pergunta.
Abrir chat