SDK de Geyser · 0.2.0

Crea apps que pongan a trabajar a los Agents

Añade Agents al software que tu equipo o tus clientes ya usan, para que puedan estudiar una solicitud, redactar un resumen o sugerir un cambio y devolver un resultado con el que tu aplicación pueda trabajar.

“Dime el trabajo, el formato en que lo quieres de vuelta y un límite que no deba superar. Te enviaré un resultado que tu app pueda usar.”

Otis

Ayuda a soporte con un ticket complicado

Ayuda a alguien de tu equipo de soporte a entender un ticket difícil y a redactar una respuesta. El ejemplo de soporte ordena los datos del ticket que le pasas, pide a un Agent que investigue los antecedentes y comprueba las fuentes que cita.

Tu app se encarga de la conexión con el servicio de atención y pasa los registros. El ejemplo redacta un borrador, y una persona decide si es correcto y si se envía.

Prueba el ejemplo de soporte

Convierte la investigación en un resumen que la gente pueda usar

Crea algo que ayude a un equipo de ventas a preparar una llamada con un cliente, o que ayude a una persona investigadora a ponerse al día en un tema. Pasa las notas y los documentos y pide a un Agent un resumen con referencias.

Empieza con los ejemplos de revisión de Agents y de comprobación de fuentes. Detectan referencias que faltan o inventadas, pero seguirás necesitando tu propio proceso de revisión para comprobar los datos.

Prueba los bloques de construcción de investigación

Añadir un paso de aprobación a una herramienta de operaciones

Deja que un Agent proponga un cambio en un registro, muestre a una persona lo que va a pasar y espere su decisión. Encaja en herramientas internas donde el personal debe revisar los cambios antes de que se apliquen.

Los ejemplos de registros aprobados se ejecutan contra una base de datos de muestra o un espacio de trabajo desechable de un Agent. Cubren la aprobación y la recuperación tras una respuesta interrumpida. Cualquier conexión con un sistema real de la empresa la aporta tu app.

Prueba una actualización aprobada

Crea herramientas a la medida de cómo trabaja tu equipo

Crea un asistente de propuestas o una herramienta de traspaso de proyectos que siga las instrucciones de tu equipo. Reúne los pasos y el contexto que necesita para poder reutilizar el enfoque en el próximo trabajo.

Un Agent Bundle empaqueta instrucciones, habilidades y contexto portátil. Cada ejecución sigue los permisos actuales del espacio de trabajo y pide una nueva aprobación antes de una acción importante.

Empaqueta un flujo de trabajo reutilizable
¿Por qué construir sobre Geyser?

Dedica tu tiempo a la app mientras Geyser sigue el trabajo

Tu app es dueña de la interfaz y de sus conexiones con otros servicios. Geyser guarda en un solo lugar, dentro del espacio de trabajo del cliente, el progreso, el presupuesto, los permisos, las solicitudes de aprobación y el resultado de la tarea del Agent.

Si se corta la conexión, puedes volver a conectarte a la misma tarea. También puedes mostrar el trabajo que espera una decisión y recibir los resultados en el formato que tu app espera. Estos controles valen la pena cuando un trabajo tiene varios pasos o necesita supervisión; para una simple transformación de texto, quizá baste una llamada directa a un modelo o una función normal.

Crea una aplicación con el SDK
  1. 1
    Asígnale un trabajo

    Indica la información que tienes permiso para usar, el formato en que la quieres de vuelta y los límites de tiempo y de gasto.

  2. 2
    Inicia la tarea

    Reutiliza el mismo ID de operación para que tu app pueda encontrar de nuevo la tarea si se corta la conexión.

  3. 3
    Sigue el trabajo

    Lee el progreso y muestra a las personas cualquier solicitud de aprobación o de ayuda para recuperar una acción interrumpida.

  4. 4
    Usa el resultado

    Recupera el resultado guardado del espacio de trabajo del cliente y compruébalo antes de usarlo.

Empieza con un ejemplo pequeño que funcione

Ejecuta tu primera herramienta en tu propia máquina

Escribe una herramienta en Python que reciba JSON, ejecútala con las entradas de ejemplo y mira lo que sale. La guía de inicio rápido ejecuta tu código real en un entorno restringido, con una prueba que rechaza entradas no válidas, y no necesitas una cuenta.

Necesitarás Python 3.11 o posterior para la guía de inicio rápido del código fuente etiquetado, además de un sandbox compatible: sandbox-exec de macOS, o bubblewrap de Linux con espacios de nombres de usuario permitidos. Una vez instalado, el controlador no usa un modelo, acceso a la red ni credenciales.

Entiende el contrato de extensiones
Versión 0.2.0 etiquetada · ejecución local
git clone --branch v0.2.0 --depth 1 https://github.com/geyserlabs/geyser-open.git
cd geyser-open
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ./sdk/python -e ./cli
geyser init tool word-count
geyser test word-count
geyser --json dev word-count
Autoridad y disponibilidad, explicadas con claridad

Dónde se ejecuta cada cosa y cuánto cuesta

Cada proyecto selecciona un Agent, y sus credenciales quedan vinculadas a ese proyecto y a su Customer Cell actual. Un paquete JSON firmado solo se activa cuando el Agent asignado ha verificado los bytes exactos y el paquete ha superado sus pruebas en un entorno aislado.

Las extensiones de JSON puro no pueden usar archivos del host, red, subprocesos ni credenciales heredadas. Las tareas abiertas de los Agents usan los modelos y las herramientas configurados en tu espacio de trabajo. El SDK en sí tiene licencia MIT, y el uso remoto de modelos y de cómputo se factura a través de tu cuenta. No prometemos un cupo gratuito de cómputo ni un SLA de disponibilidad durante la vista previa.

SDK/CLI 0.2.0 está publicado en PyPI y GitHub. La instalación con Homebrew funciona en macOS con Apple Silicon y en Linux AMD64, y los controladores locales en Python también necesitan Python 3.11 o posterior. Hoy puedes ejecutarlo en local. La ejecución remota necesita que la Cell del cliente y el software del Agent coincidan, así que consulta la página de desarrolladores de la consola para ver si está listo antes de enviar una tarea remota. Los paquetes mantienen la autoridad existente tal como está, y los perfiles de modelo eligen un modelo que ya está configurado. Las bifurcaciones públicas de inspección no ejecutan herramientas; reproducir una ejecución es una operación aparte.

SDK de Python en PyPICLI en PyPIDescargar SDK/CLI 0.2.0Lee los cambios y las notas de migración
Empieza

Empieza con un trabajo que tu app podría facilitar

Elige un ejemplo, adáptalo a la forma de trabajar de tu equipo y comprueba si te ahorra construir tú mismo la gestión de tareas. Los ejemplos son puntos de partida para tu aplicación, y no hemos publicado resultados de adopción independientes.