Saltar al contenido principal
Las mismas reglas se aplican tanto si usas Glasser mediante un Agent, MCP, la CLI o HTTP.

​
De la solicitud a los datos

Glasser te conecta con datos de pago de proveedores de datos especializados. Un Endpoint es una operación de un proveedor de datos, con su propio esquema de entrada, versión y Price. Tu Glasser Key te da acceso sin necesidad de cuentas independientes de proveedores de datos.
  1. Busca un Endpoint que se ajuste a tu solicitud.
  2. Inspecciona su esquema de entrada y su Price actual.
  3. Ejecútalo para recuperar datos. Glasser registra el resultado y el cargo en un Run.
Search e Inspect son gratuitos. Para tareas predefinidas, Solutions puede seleccionar un Endpoint y asignar tu entrada por ti. Ambas rutas usan los mismos Runs y el saldo del Workspace.

​
Entender el Price

Inspect muestra cómo cobra un Endpoint:
  • Resultado correcto: un importe fijo o un importe medido (por ejemplo, por resultado o token) con un límite máximo.
  • Otros resultados: reglas independientes para ningún resultado, errores del proveedor de datos, tiempos de espera agotados y errores internos (NO_RESULT, PROVIDER_ERROR, TIMED_OUT, INTERNAL).
Un nuevo Run usa el Price vigente al admitirse y lo conserva hasta la liquidación. La versión de un Endpoint no bloquea el Price para futuros Runs. Los importes son cadenas decimales exactas en USD, como "0.005". Usa aritmética decimal, no de coma flotante, al sumarlos.

​
Estado del Run

Antes de crear un Run, Glasser comprueba el acceso y los fondos disponibles, y coloca una Hold por el cargo máximo. Una solicitud rechazada no crea ningún Run ni cargo. Cuando el Run termina, Glasser cierra la Hold y registra el cargo final. Una solicitud de detención posterior al envío no cancela el trabajo del Provider. Lee el estado devuelto y el cargo final; consulta Detener un Run.

​
Leer el resultado y el cargo

Comprueba estos campos por separado:

​
Reintentar sin un segundo cargo

Después de un tiempo de espera agotado o de perder la conexión, reintenta con la misma clave de idempotencia para recuperar el Run original sin iniciar otro ni generar otro cargo.
  • Mantén iguales provider, endpoint, input y endpoint_version.
  • Cambiar esos parámetros de ejecución con la misma clave devuelve un conflicto.
  • Usa una clave nueva solo cuando quieras iniciar otro Run.
Cambiar task_id o metadata no crea un Run nuevo ni actualiza el Run original. Las respuestas de MCP también incluyen replayed: true para reintentar; las respuestas de la API HTTP y de la CLI devuelven el Run sin este campo.

​
Claves y políticas

Una Key pertenece a un Workspace. Los Runs usan el saldo de ese Workspace. Un Endpoint debe estar permitido tanto por la Policy del Workspace como por la Policy de la Key. Search omite los Endpoints que quedan fuera de ese acceso; Inspect devuelve que no se encuentran.

​
Añadir fondos

Añade fondos en la página de saldo. La API, la CLI y MCP no pueden añadir fondos. Un Grant es saldo gratuito: no caduca y se utiliza como cualquier otro saldo. Cada nuevo Workspace empieza con un Grant de registro. Los Grants de referidos y de publicaciones tienen límites de por vida por Workspace; la consola muestra los importes y límites actuales. Los Grants aparecen en el historial del saldo con el tipo grant.

​
Un modelo, cuatro superficies

Las mismas reglas de ejecución, facturación y políticas se aplican a la API HTTP, a la CLI, al servidor MCP y al Skill del agent.