SDK de Geyser · 0.3.4

Crea apps que pongan a trabajar a los Agents

Añade Agents al software que tu equipo o tus clientes ya usan. Pueden estudiar una solicitud, redactar un resumen o sugerir un cambio, y luego 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 luego comprueba las fuentes que cita el Agent.

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 que están inventadas, aunque te convendrá hacer tu propia 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 revisa 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, y 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, y podrás reutilizar el enfoque en el próximo trabajo.

Un Agent Bundle reúne instrucciones, habilidades y contexto portátil. Cada ejecución sigue los permisos del espacio de trabajo tal como estén en ese momento, y pide una nueva aprobación antes de cualquier 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 lleva el seguimiento de la tarea del Agent en un solo lugar dentro del espacio de trabajo del cliente, incluidos su progreso, su presupuesto, sus permisos, sus solicitudes de aprobación y su resultado.

Si se corta la conexión, vuelves a conectarte a la misma tarea. Puedes mostrar a otras personas el trabajo que espera una decisión y recibir los resultados en el formato que espera tu app. Todo esto compensa cuando un trabajo tiene varios pasos o necesita supervisión. Para una simple transformación de texto, quizá te baste una llamada directa a un modelo o una función normal.

Crea una aplicación con el SDK
  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. 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. 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. 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, junto con una prueba que rechaza entradas no válidas, y no necesitas una cuenta para probarla.

La guía de inicio rápido del código fuente etiquetado necesita Python 3.11 o posterior y un sandbox compatible, que puede ser 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.3.4 etiquetada · ejecución local
git clone --branch v0.3.4 --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 trabaja a través de un Agent que eliges. Las claves del proyecto solo sirven para ese proyecto y solo en el lugar donde se guardan actualmente los datos de su espacio de trabajo. Un paquete JSON firmado solo se activa después de que ese Agent lo haya comprobado byte a byte y de que haya superado sus pruebas en un sandbox.

Una extensión de JSON puro no puede tocar los archivos de la computadora, la red, otros procesos ni ninguna credencial que pudiera heredar. Las tareas de Agent que envías mediante el SDK o la CLI 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. Durante la vista previa no hay cupo gratuito de cómputo ni SLA de disponibilidad.

SDK/CLI 0.3.4 está en PyPI y GitHub. Homebrew lo instala en Mac con Apple silicon y en Linux AMD64, y los controladores locales en Python también necesitan Python 3.11 o posterior. La ejecución local ya funciona hoy. Para ejecutar una tarea de forma remota, el software del espacio de trabajo y el del Agent tienen que coincidir, así que consulta la página Desarrolladores de la consola antes de enviar una. Un paquete no amplía lo que un Agent ya puede hacer, y un perfil de modelo elige entre modelos que ya están configurados. Las bifurcaciones públicas de inspección no ejecutan herramientas, y reproducir una ejecución es una operación aparte.

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. Cada ejemplo es un punto de partida para tu propia aplicación.