Qué herramienta MCP corresponde a cada trabajo

Un asistente que usa el conector está haciendo llamadas normales a la API. Saber cuál es cuál convierte una caja negra en algo sobre lo que puedes razonar.

Seis herramientas, y caen en tres grupos según lo que te cuestan.

Las dos que leen el catálogo

Listar las herramientas y listar los modelos leen un catálogo y no cobran nada.

Existen para que el asistente trabaje con lo que de verdad hay disponible en lugar de con algo que recuerda.

Eso importa más de lo que suena. Una lista memorizada produce peticiones seguras de herramientas que nunca fueron ejecutables.

Son también las primeras llamadas correctas cuando algo no funciona, porque demuestran la conexión sin gastar nada.

Recibir una lista significa que la URL y la clave son correctas. Todo lo posterior es un problema de trabajo y no de configuración.

Las dos devuelven los mismos catálogos que devuelven los puntos finales de la documentación de la API pública, con la misma forma.

La que prepara un archivo

Subir una imagen toma una foto y devuelve una dirección pública. No se cobran créditos por ello.

Existe por un problema de fontanería. Una foto adjunta en una ventana de chat no es algo a lo que se pueda apuntar una herramienta.

Así que el archivo se prepara primero, y la dirección que vuelve es la que usa el trabajo real.

Verás que esto ocurre sin pedirlo siempre que adjuntes una imagen. Es un paso, no un trabajo.

La misma dirección puede usarse como entrada de una edición o como referencia de una generación, y por eso es una herramienta y no dos.

También significa que una foto preparada una vez sirve más de una vez. Probar dos herramientas distintas sobre la misma imagen no necesita subirla dos veces.

Las dos que cuestan créditos

Editar una imagen ejecuta una de las herramientas sobre una foto. Generar una imagen crea una nueva desde una descripción y un modelo.

Son las dos únicas que gastan algo, y cuestan exactamente lo que cuesta el mismo trabajo en cualquier otro sitio.

• Editar corresponde a un trabajo de herramienta, con su identificador y sus opciones.
• Generar corresponde a un trabajo de generación, con un identificador de modelo y un texto.
• Los dos reservan créditos al crearse y cobran solo si terminan bien.
• Los dos rechazan una opción no admitida con un error que lista lo que sí se admite.

Ese comportamiento de rechazo conviene conocerlo porque aparece como el asistente corrigiéndose a mitad de tarea. No se cobró nada, y el error le dijo qué usar en su lugar.

Verlo pasar tranquiliza más que alarma. La alternativa sería ejecutar en silencio algo parecido a lo que pediste.

Los créditos se reservan al crear el trabajo y vuelven enteros si falla, así que una petición equivocada no cuesta nada más allá del tiempo.

El conjunto ejecutable coincide exactamente con el de la API, así que todo lo que puedes hacer en un script puedes pedirlo en un chat.

Qué herramienta encaja con qué foto es otra pregunta, y navegar el directorio de herramientas es más rápido que pedirle a un asistente que describa dieciocho estilos de boceto.

La que termina el trabajo

Consultar un trabajo lee el estado de lo que sigue corriendo. No cobra nada.

Las generaciones son asíncronas, así que una lenta devuelve un identificador en lugar de una imagen, y así es como el asistente la recoge.

Aquí hay un detalle que pilla a la gente. Consultar una generación es también lo que la hace avanzar.

Un trabajo que nadie consulta no sigue en segundo plano en silencio. Se atasca y puede quedar abandonado.

Así que una generación que parece colgada suele ser una por la que se dejó de preguntar. Pedirle al asistente que la consulte es el arreglo de verdad y no un apaño.

Los trabajos de edición sufren menos esto porque suelen terminar lo bastante rápido como para volver de una vez.

Son las generaciones, donde el trabajo es más largo, las que enseñan este comportamiento con más claridad.

Si una generación lleva un rato callada, preguntar por ella directamente es lo correcto en lugar de empezar otra.

Empezar de nuevo gasta créditos en trabajo que la primera todavía puede entregar.

Dos generaciones corriendo para una sola petición es la forma más común de tirar créditos aquí, y la paciencia es todo el remedio.

Una edición que vuelve al momento no necesita consulta ninguna, y por eso la mayoría de la gente nunca ve esta herramienta trabajar.

Solo aparece cuando el trabajo tarda lo suficiente como para no caber en una sola respuesta.

Un script tiene la misma obligación, y el bucle de consulta que la cumple está descrito en API pública frente al estudio de la web.

Dos lecturas gratis, un paso de preparación gratis, dos trabajos de pago y una consulta gratis. Ese es todo el mapa.