Elige según la tarea
Un modelo debe evaluarse por el trabajo que tiene que realizar. La extracción de datos, el análisis de imagen y la revisión de código exigen capacidades diferentes. Un modelo que solo recibe texto no aprende a ver imágenes porque el pedido está bien redactado.
Define una tarea pequeña y los criterios de calidad antes de comparar alternativas. Considera errores, tiempo, costo y la necesidad de revisión. La alternativa más barata por unidad puede requerir tantas correcciones que el proceso completo salga más caro.
Por qué aprender
La comparación deja de depender de rankings genéricos. Pasas a evaluar el costo y la calidad de la entrega que realmente necesitas producir.
✓ Hacer
Cargar credenciales fuera de los archivos versionados.
✗ Evitar
Copiar una clave para un ejemplo público.
Conceptos clave
Separa cuenta, modelo e interfaz
La interfaz es el programa con el que interactúas. El proveedor ofrece el servicio, y el modelo ejecuta la tarea. Una suscripción de producto y el uso de una API pueden tener cobros y límites diferentes. Verifica esto en la cuenta que usas.
Las integraciones con proveedores alternativos, como DeepSeek o MIMO, dependen de la compatibilidad soportada por la herramienta. No presumas que con cambiar solo un nombre basta. El endpoint, la autenticación, los recursos de herramientas y los límites necesitan ser compatibles.
Por qué aprender
Entender las capas ayuda a localizar fallas y evita atribuirle a un modelo un problema de autenticación, red o configuración de la interfaz.
Un camino para aplicar
- Registra la configuración actual y los criterios de la tarea.
- Prueba el acceso y las capacidades en una entrada pequeña.
- Compara resultados y mantén una reversión documentada.
Conceptos clave
Crea perfiles sin secretos
Un perfil describe configuraciones, pero no debe usarse como depósito de credenciales. Usa nombres de variables de entorno para indicar dónde se cargará la clave. Un archivo de ejemplo debe funcionar como documentación, sin contener valores reales.
Antes de cambiar una configuración existente, guarda una copia y confirma qué archivo usa la versión instalada. Algunas herramientas permiten perfiles u opciones por ejecución; otras requieren archivos específicos. Consulta la ayuda actual en vez de renombrar archivos a prueba y error.
Por qué aprender
Separar configuración y credencial facilita compartir ejemplos sin exponer el acceso. Preservar la configuración original hace que la prueba sea reversible.
{
"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.
Conceptos clave
Haz una prueba de conectividad y función
Empieza con una solicitud pequeña, sin documentos importantes. Confirma que la autenticación funciona y que la respuesta usa el modelo esperado. Luego prueba la capacidad necesaria: formato estructurado, herramientas o imagen, según la tarea.
Una respuesta “hola” confirma parte del camino, pero no demuestra que una integración soporte todas las funciones de un agente. Si la herramienta necesita llamar operaciones, prueba una operación simple y reversible antes de iniciar un flujo más grande.
Por qué aprender
La verificación por etapas separa problemas de conexión de limitaciones funcionales. Evitas descubrir incompatibilidades después de haber iniciado ya una tarea larga.
✓ Hacer
Compara las mismas solicitudes y criterios.
✗ Evitar
Elegir solo por el precio más bajo anunciado.
Conceptos clave
Compara con la misma regla
Usa el mismo conjunto de entradas y registra los resultados por criterio. Para la extracción de solicitudes, cuenta campos correctos, espacios en blanco preservados y errores de formato. Mide el tiempo y el consumo cuando la herramienta proporcione esos datos, sin estimar números que no se hayan observado.
Haz más de una ejecución cuando la variabilidad sea relevante. Una sola respuesta excelente no demuestra estabilidad. La decisión podría ser usar un modelo para borradores y otro para una etapa específica, siempre que la complejidad adicional se justifique.
Por qué aprender
Una matriz comparable muestra ventajas y limitaciones sin convertir la preferencia en evidencia. También permite repetir la evaluación cuando el servicio cambie.
| Criterio | Evidencia esperada |
|---|---|
| Fidelidad | No inventa datos ausentes. |
| Compatibilidad | Ejecuta las funciones exigidas. |
| Reversión | Se puede recuperar el perfil anterior. |
Conceptos clave
Práctica: prepara una comparación
Define una tarea de extracción de tres solicitudes y compara dos perfiles ficticios. En el ejercicio, no necesitas contratar servicios: usa la matriz para registrar resultados simulados claramente identificados.
Explica por qué la opción más rápida puede no ser la mejor si se inventan plazos. Luego escribe el procedimiento para volver al perfil original. El objetivo es aprender a comparar y revertir, no recomendar un proveedor por fama o por precio de un ejemplo.
Por qué aprender
El ejercicio produce un protocolo de evaluación que se puede aplicar con servicios reales después. Evita que un cambio de configuración se confunda con una mejora demostrada.
Tu ejercicio
Datos simulados: el perfil A responde en 4 segundos e inventa un plazo; el perfil B responde en 8 segundos y preserva todos los datos. ¿Cuál elegir para una tabla que se usará como compromiso con clientes?
Descargar ficha de la prácticaRevisar respuesta comentada
Elige B en esta prueba, porque la fidelidad es un criterio obligatorio y A falló en eso. El menor tiempo de A no compensa el compromiso inventado. Registra que los tiempos son simulados y que la conclusión vale para ese conjunto de entradas, no para todas las tareas.
Comprueba tu comprensión
Una respuesta corta funcionó. ¿Eso demuestra compatibilidad completa con un agente?
Conceptos clave
Lo que queda de este módulo
Una matriz de comparación y un perfil de ejemplo sin credenciales.
- ✓ No inventa datos ausentes.
- ✓ Ejecuta las funciones exigidas.
- ✓ El perfil anterior puede recuperarse.
El progreso registra tu lectura. La práctica queda concluida cuando revisas la entrega.