Desarrollo de skills

Las skills son unidades reutilizables de capacidad de agente en Brazosd. Una skill normalmente describe el conocimiento de negocio, los pasos operativos, las reglas de uso de herramientas y los límites de riesgo para una clase de tareas. Los usuarios pueden vincular skills a agentes para que el agente cargue el contenido correspondiente cuando gestione una tarea relevante.

Las skills son útiles para conservar conocimiento experto dentro de una organización. En lugar de poner todas las reglas en el prompt de un agente, las skills pueden separarse por tema de negocio, mantenerse de forma independiente y reutilizarse en varios agentes.

Cómo afectan las skills a los agentes

Durante la ejecución, un agente ve la lista de skills vinculadas, incluyendo el ID, el nombre y la descripción de cada skill. Cuando una tarea coincide con la descripción de una skill, el agente puede usar la herramienta integrada read_skill para leer el cuerpo completo de la skill.

Este mecanismo reduce la cantidad de contenido en el contexto por defecto. El agente no necesita cargar todos los cuerpos de skills en cada ejecución. Puede leer el contenido relevante por ID de skill solo cuando lo necesita.

Vincular una skill cambia el comportamiento del agente en ejecuciones posteriores. Antes de añadir una skill a un agente, confirme que el alcance, los límites de autorización y las reglas de uso de herramientas de la skill coinciden con las responsabilidades del agente.

Contenido de una skill

Una skill contiene nombre, descripción y cuerpo.

El nombre debe describir claramente el tema de la skill. La descripción debe ayudar al agente a decidir cuándo necesita leerla. El cuerpo debe definir el flujo concreto de la tarea, las convenciones de entrada y salida, las herramientas que deben llamarse, las acciones que requieren confirmación del usuario y los límites de negocio que no deben cruzarse.

El cuerpo de la skill no debería contener solo principios abstractos. Para agentes expertos de nivel empresarial, es más valioso dividir los flujos de negocio en pasos ejecutables y explicar qué hacer ante excepciones, permisos insuficientes, información faltante o fallos de sistemas externos.

Skills del sistema y skills de organización

Brazosd proporciona skills del sistema que describen capacidades integradas de la plataforma y flujos básicos de operación. Las skills del sistema son administradas por el inicializador de Brazosd, y los usuarios no deberían editarlas ni eliminarlas en la consola.

Las organizaciones también pueden crear sus propias skills. Las skills de organización son adecuadas para procesos internos, conocimiento sectorial, experiencia de proyectos con clientes y reglas de uso de herramientas privadas. Las skills de organización pueden vincularse a agentes propiedad de la organización, incluidos agentes del sistema propiedad de la organización.

Edición de skills

Las skills se editan directamente. Los cambios afectan a los agentes vinculados cuando se actualiza su configuración, así que mantenga estable el alcance y el comportamiento de la skill antes de usarla en agentes de producción.

Publicación y reutilización

Las skills pueden reutilizarse como activos internos de la organización. Antes de vincular una skill ampliamente, evite incluir información que solo aplique a un cliente, a un proyecto temporal o a contenido que no debería exponerse a todos los agentes que usan esa skill.

Para capacidades que dependen fuertemente de datos privados de la empresa, manténgalas como skills internas de la organización y combínelas con el agent drive, materiales del cloud drive y brazosd_ctrl para construir agentes expertos orientados al negocio.