Escolha pela tarefa
Um modelo precisa ser avaliado pelo trabalho que deve realizar. Extração de dados, análise de imagem e revisão de código exigem capacidades diferentes. Um modelo que recebe apenas texto não passa a enxergar imagens porque o pedido é bem escrito.
Defina uma tarefa pequena e os critérios de qualidade antes de comparar alternativas. Considere erros, tempo, custo e necessidade de revisão. A alternativa mais barata por unidade pode exigir tantas correções que o processo completo fique mais caro.
Por que aprender
A comparação deixa de depender de rankings genéricos. Você passa a avaliar o custo e a qualidade da entrega que realmente precisa produzir.
✓ Fazer
Carregar credenciais fora dos arquivos versionados.
✗ Evitar
Copiar uma chave para um exemplo público.
Conceitos-chave
Separe conta, modelo e interface
A interface é o programa com que você interage. O provedor oferece o serviço, e o modelo executa a tarefa. Uma assinatura de produto e o uso de uma API podem ter cobranças e limites diferentes. Verifique isso na conta utilizada.
Integrações com provedores alternativos, como DeepSeek ou MIMO, dependem da compatibilidade suportada pela ferramenta. Não presuma que trocar apenas um nome seja suficiente. Endpoint, autenticação, recursos de ferramentas e limites precisam ser compatíveis.
Por que aprender
Entender as camadas ajuda a localizar falhas e evita atribuir a um modelo um problema de autenticação, rede ou configuração da interface.
Um caminho para aplicar
- Registre configuração atual e critérios da tarefa.
- Teste acesso e capacidades em uma entrada pequena.
- Compare resultados e mantenha uma reversão documentada.
Conceitos-chave
Crie perfis sem segredos
Um perfil descreve configurações, mas não deve servir como depósito de credenciais. Use nomes de variáveis de ambiente para indicar onde a chave será carregada. Um arquivo de exemplo precisa funcionar como documentação, sem conter valores reais.
Antes de alterar uma configuração existente, salve uma cópia e confirme qual arquivo a versão instalada utiliza. Algumas ferramentas permitem perfis ou opções por execução; outras exigem arquivos específicos. Consulte a ajuda atual em vez de renomear arquivos por tentativa.
Por que aprender
Separar configuração e credencial facilita compartilhar exemplos sem expor acesso. Preservar a configuração original torna o teste reversível.
{
"nome": "perfil-de-exemplo",
"provedor": "preencher-conforme-documentacao",
"modelo": "identificador-validado",
"chave_env": "PROVEDOR_API_KEY",
"tarefa_teste": "extrair-pedidos"
}
Este é um esquema didático, não um arquivo de configuração de uma CLI específica.
Conceitos-chave
Faça um teste de conectividade e função
Comece com uma solicitação pequena, sem documentos importantes. Confirme se a autenticação funciona e se a resposta usa o modelo esperado. Depois teste a capacidade necessária: formato estruturado, ferramentas ou imagem, conforme a tarefa.
Uma resposta “olá” confirma parte do caminho, mas não demonstra que uma integração suporta todas as funções de um agente. Se a ferramenta precisa chamar operações, teste uma operação simples e reversível antes de iniciar um fluxo maior.
Por que aprender
A verificação em etapas separa problemas de conexão de limitações funcionais. Você evita descobrir incompatibilidades depois de já ter iniciado uma tarefa longa.
✓ Fazer
Comparar os mesmos pedidos e critérios.
✗ Evitar
Escolher só pelo menor preço anunciado.
Conceitos-chave
Compare com a mesma régua
Use o mesmo conjunto de entradas e registre resultados por critério. Para extração de pedidos, conte campos corretos, lacunas preservadas e erros de formato. Meça tempo e consumo quando a ferramenta fornecer esses dados, sem estimar números que não foram observados.
Faça mais de uma execução quando a variabilidade for relevante. Uma única resposta excelente não demonstra estabilidade. A decisão pode ser usar um modelo para rascunho e outro para uma etapa específica, desde que a complexidade adicional se justifique.
Por que aprender
Uma matriz comparável mostra vantagens e limitações sem transformar preferência em evidência. Ela também permite repetir a avaliação quando o serviço mudar.
| Critério | Evidência esperada |
|---|---|
| Fidelidade | Não inventa dados ausentes. |
| Compatibilidade | Executa as funções exigidas. |
| Reversão | O perfil anterior pode ser recuperado. |
Conceitos-chave
Prática: prepare uma comparação
Defina uma tarefa de extração de três pedidos e compare dois perfis fictícios. No exercício, você não precisa contratar serviços: use a matriz para registrar resultados simulados claramente identificados.
Explique por que a opção mais rápida pode não ser a melhor se inventar prazos. Depois escreva o procedimento de retorno ao perfil original. O objetivo é aprender a comparar e reverter, não recomendar um provedor por fama ou preço de um exemplo.
Por que aprender
O exercício produz um protocolo de avaliação que pode ser aplicado com serviços reais depois. Ele impede que uma mudança de configuração seja confundida com uma melhoria demonstrada.
Seu exercício
Dados simulados: perfil A responde em 4 segundos e inventa um prazo; perfil B responde em 8 segundos e preserva todos os dados. Qual escolher para uma tabela que será usada como compromisso com clientes?
Baixar ficha da práticaConferir resposta comentada
Escolher B neste teste, porque fidelidade é um critério obrigatório e A falhou nele. O tempo menor de A não compensa o compromisso inventado. Registrar que os tempos são simulados e que a conclusão vale para esse conjunto de entradas, não para todas as tarefas.
Cheque sua compreensão
Uma resposta curta funcionou. Isso prova compatibilidade completa com um agente?
Conceitos-chave
O que fica deste módulo
Uma matriz de comparação e um perfil de exemplo sem credenciais.
- ✓ Não inventa dados ausentes.
- ✓ Executa as funções exigidas.
- ✓ O perfil anterior pode ser recuperado.
O progresso registra sua leitura. A prática fica concluída quando você confere a entrega.