Desarrollo de agentes

Brazosd es una plataforma de agentes que proporciona muchas capacidades para agentes y que ofrecerá más infraestructura con el tiempo. Los usuarios pueden construir agentes potentes utilizando las capacidades que ofrece la plataforma.

Cloud Drive

Los agentes pueden usar los cloud drives de Brazosd. Actualmente los cloud drives tienen varios scopes: organization drive, channel drive, session drive y user drive.

Un organization drive se comparte dentro de una organización. Los materiales de negocio, artefactos generados y contexto reutilizable específicos de un agente se almacenan en @brazosd://org.drive/<org-id>/agents/<agent-id>/.

Un channel drive se comparte entre todos los miembros de un canal. Cuando un agente es miembro de un canal, puede acceder al drive de ese canal.

Un session drive es un espacio de almacenamiento persistente asociado a una sesión, para adjuntos y entregables. Los agentes guardan los resultados en el session drive actual de forma predeterminada, o en otra ubicación indicada por el usuario. El archivado por inactividad o manual conserva los archivos para que el usuario los gestione y elimine; el sandbox de trabajo sí se destruye. Una bifurcación comienza con un drive nuevo y vacío, mientras que los archivos existentes siguen accesibles en sus rutas originales según los permisos del usuario.

Un user drive pertenece al usuario. Una sesión de agente actúa con los permisos de Cloud Drive del usuario actual y puede operar el drive de ese usuario, sus session drives, el organization drive y los channel drives de los que el usuario es miembro.

El repositorio de fábrica de un agente es un recurso especial. El agente en ejecución puede leer su propio repositorio, pero solo puede escribir en él mientras presta servicio a la organización que lo creó. Cuando una organización incorpora un agente de terceros, el repositorio propio de ese agente es de solo lectura y el usuario consumidor no puede acceder directamente a él. Esta excepción no elimina el acceso del usuario de la sesión a otros repositorios de agentes creados por su organización.

La herramienta brazosd_ctrl

La herramienta brazosd_ctrl permite que un agente acceda a todas las funciones de Brazosd usando la identidad del usuario.

Forma parte del conjunto de herramientas predeterminado de todos los agentes. Las rutas de operaciones API enumeradas en /openapi.yaml se montan bajo /api/v1; por ejemplo, la ruta /agents debe invocarse como /api/v1/agents.

Con esta herramienta, un agente puede operar la propia plataforma como un sistema de negocio, por ejemplo leyendo información de sesiones, gestionando contexto de canales, administrando recursos de la plataforma o componiendo otras capacidades de la plataforma dentro de su propio flujo de negocio.

Variables seguras

Los agentes usan variables seguras mediante formas con caracteres especiales. Cuando el kernel de Brazosd intercepta llamadas a herramientas, traduce esos caracteres especiales a las variables correspondientes.

Las variables seguras se almacenan en almacenamiento cifrado. Después de establecer el valor de una variable, el valor en texto claro no puede verse en Brazosd.

Si un agente necesita solicitar información sensible, como un código de verificación o una contraseña, puede iniciar una llamada a una herramienta integrada y pedir al usuario que la complete. Después de que el usuario la completa, Brazosd puede proporcionar esa información como una variable segura para llamadas posteriores a herramientas, en lugar de exponer el texto claro al agente o al contexto del modelo de lenguaje.

Memoria del agente

Desarrollar agentes de propósito general no es actualmente un objetivo de Brazosd, y Brazosd no ofrece por ahora un mecanismo oficial de memoria de agente.

Brazosd está diseñado como una plataforma para construir agentes expertos de nivel empresarial, y favorece el desarrollo de agentes para dominios de negocio específicos. Los usuarios pueden crear módulos de memoria orientados al negocio almacenando el contexto del agente en su directorio del organization drive y accediendo a información de sesiones mediante brazosd_ctrl.

Sandbox

Cada sesión tiene un sandbox de trabajo aislado basado en máquina virtual. Después de un periodo sin uso, el sandbox de trabajo entra en reposo, y solo se cobra una pequeña cantidad por el espacio de almacenamiento ya utilizado.

Para destruir completamente un sandbox, la sesión debe archivarse. Las sesiones archivadas no pueden continuarse con preguntas de seguimiento.

Los sandboxes se crean de forma perezosa. Esto significa que, después de crear una nueva sesión, si no se ejecuta ningún comando de sandbox, el sandbox no se crea. Para sesiones cortas despertadas por eventos, evitar la creación del sandbox puede reducir la duración de la tarea y el coste de gestión del almacenamiento.

Dispositivos

Los agentes pueden operar dispositivos conectados mediante el túnel cifrado de Brazosd.

Los agentes pueden operar varios dispositivos y sandboxes al mismo tiempo. Brazosd soportará gradualmente más dispositivos inteligentes, como Android, macOS e iOS, en versiones futuras, y proporcionará un framework RPA para dispositivos con GUI.

Tareas en segundo plano en dispositivos

Los agentes pueden usar los comandos exec_command y write_stdin para abrir procesos PTY en dispositivos y ejecutar tareas en segundo plano.

Si un dispositivo no soporta PTY, como versiones antiguas de Windows, el agente solo puede usar shell_command para ejecutar tareas en primer plano.

Las tareas en segundo plano de sandbox se soportarán en versiones futuras. Actualmente, solo los dispositivos soportan tareas en segundo plano administradas por el conector de dispositivos.