Extensión de Genie Code con aptitudes de agente

Genie Code incluye capacidades integradas para flujos de trabajo habituales de Azure Databricks: escribir código en notebooks, explorar datos en Unity Catalog, crear cuadros de mando, crear pipelines y trabajar con MLflow. Cree aptitudes personalizadas para ampliar el modo agente de código de Genie con funcionalidades especializadas para las tareas específicas del dominio del equipo. En esta página se explica cómo crearlos y optimizarlos.

¿Qué son las aptitudes?

Cree aptitudes para ampliar Genie Code con funcionalidades especializadas. Las aptitudes siguen el estándar abierto de aptitudes del agente. Paquete de habilidades, conocimientos y procesos de trabajo específicos del dominio que Genie Code puede cargar cuando sean pertinentes para realizar tareas específicas. Las aptitudes pueden incluir instrucciones, procedimientos recomendados, código reutilizable y scripts ejecutables.

Las aptitudes deben adaptarse a las tareas específicas del dominio. Con habilidades, puede proporcionar un mayor contexto (como guiones, ejemplos y otros recursos) para una tarea que con las instrucciones. A diferencia de las instrucciones personalizadas, que se aplican globalmente, las aptitudes se cargan automáticamente y solo en el contexto pertinente. En el modo agente, Genie Code carga automáticamente las aptitudes cuando sea pertinente, en función de la solicitud y la descripción de la aptitud. También puede invocar manualmente las aptitudes @ mencionándolas. Esto mantiene una ventana de contexto eficaz y reduce la necesidad de proporcionar el mismo contexto en varios chats.

Hay dos tipos de aptitudes:

  • Aptitudes del área de trabajo: disponibles para todos en el área de trabajo. Los administradores del espacio de trabajo pueden crear habilidades del espacio de trabajo y conceder a otros usuarios acceso a la carpeta de habilidades para agregar más. Use habilidades del espacio de trabajo para aplicar estándares en toda la organización, ofrecer resultados coherentes para todos los usuarios (por ejemplo, una habilidad para gestionar PII que enmascara las columnas confidenciales) o dar servicio a diferentes equipos (por ejemplo, plantillas de canalizaciones para ingenieros de datos y guías de entrenamiento de modelos para usuarios de la plataforma de ML).
  • Aptitudes del usuario: disponible solo para usted. Use aptitudes de usuario para preferencias personales, como bibliotecas preferidas, estilo de codificación o contexto de rol y de fondo. Las aptitudes del usuario también son útiles para crear prototipos de una aptitud antes de promocionarla al nivel del área de trabajo.

Nota:

Las habilidades solo están disponibles en modo agente de Genie.

Crear una aptitud

Las habilidades residen en un .assistant/skills/ directorio. Cada aptitud debe tener su propia carpeta y un SKILL.md archivo dentro de esa carpeta. La ubicación depende del tipo de aptitud:

  • Aptitudes del área de trabajo: Workspace/.assistant/skills/
  • Aptitudes del usuario: /Users/{username}/.assistant/skills/

Para crear una nueva aptitud:

  1. Cree una carpeta de habilidades en la ruta de acceso adecuada para tu tipo de habilidad.

    Después de la creación, puede acceder rápidamente a la carpeta de aptitudes en el panel Genie Code. Haga clic en Icono de engranaje. Configuración y, a continuación, haga clic en Flecha en el icono. Abra la carpeta skills.

  2. Cree una carpeta dedicada para su skill dentro de la carpeta skills. Cada aptitud debe tener su propia carpeta. Por ejemplo:

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. Dentro de la carpeta de aptitudes, cree un SKILL.md archivo. Este archivo es necesario y define la aptitud. Las aptitudes siguen las especificaciones de Las aptitudes del agente.

  4. Agregue el encabezado necesario para su habilidad:

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Agregue las instrucciones de habilidad en formato Markdown después del frontmatter. Se recomienda incluir las secciones siguientes:

    • Instrucciones paso a paso: Instrucciones claras de procedimientos
    • Ejemplos: entradas de ejemplo y salidas esperadas
    • Casos perimetrales: variaciones y excepciones comunes

  6. (Opcional) Para aptitudes más complejas, puede proporcionar y hacer referencia a recursos adicionales:

    • Scripts que contienen código ejecutable que el agente puede ejecutar.
    • Archivos que contienen documentación adicional para hacer referencia, como procedimientos recomendados y plantillas.

    Al hacer referencia a otros archivos, use rutas relativas desde la raíz de la habilidad.

    Por ejemplo, una aptitud de flujo de trabajo de aprendizaje automático del área de trabajo y una aptitud de flujo de trabajo personal podría tener la estructura siguiente:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         └── pipeline-setup.sh   # Environment setup scripts

Genie Code recoge automáticamente sus aptitudes la próxima vez que la use en modo agente. También @ puede mencionar habilidades para asegurarse de que Genie Code las usa.

Al editar una habilidad existente, inicia un nuevo hilo de chat para que se apliquen los cambios. Las modificaciones no se aplican en los hilos activos. Si una habilidad sigue apareciendo desactualizada, por ejemplo, si muestra un comportamiento antiguo o una descripción obsoleta, fuerce la recarga de la pestaña del navegador para borrar los metadatos de la habilidad almacenados en caché.

procedimientos recomendados

Siga estas instrucciones para escribir aptitudes eficaces:

  • Elija el tipo de aptitud adecuado. Use aptitudes del área de trabajo para codificar estándares compartidos (como el control de PII, las convenciones de nomenclatura o las plantillas específicas del equipo) para que cada usuario obtenga resultados coherentes. Use aptitudes de usuario para las preferencias personales y para crear prototipos de una aptitud antes de promocionarla al área de trabajo.
  • Mantén las habilidades enfocadas. Las aptitudes funcionan mejor cuando se centran en una sola tarea o flujo de trabajo. El ámbito estrecho facilita que Genie Code reconozca cuándo se aplica una aptitud.
  • Use nombres y descripciones claros. Un nombre conciso, descriptivo y resumen ayuda a Genie Code a hacer coincidir la aptitud correcta con la solicitud correcta.
  • Ser explícito y basado en ejemplos. Describir los flujos de trabajo paso a paso e incluir ejemplos o patrones concretos que Genie Code puede reutilizar.
  • Evite el contexto innecesario. Incluya solo la información necesaria para la tarea. Los detalles adicionales pueden hacer que las aptitudes sean más difíciles de aplicar de forma confiable.
  • Iteración con el tiempo. Trate las aptitudes como flujos de trabajo vivos. Las pequeñas actualizaciones basadas en el uso real pueden mejorar significativamente los resultados.
  • Crear habilidades con Genie Code. Usa Genie Code para redactar y perfeccionar habilidades. Ponga a prueba las habilidades nuevas o actualizadas en tareas representativas para detectar en qué falla el agente y, a continuación, actualice las instrucciones para subsanar esas carencias.
  • Instrucciones independientes de la automatización. Use Markdown para explicar las intenciones y los procedimientos recomendados, así como scripts para acciones repetibles. Mantener estas preocupaciones distintas hace que las aptitudes sean más fáciles de mantener y reutilizar.
  • Versiona tus habilidades. Respaldar su carpeta de conocimientos con carpetas de Databricks Git para realizar un seguimiento de los cambios, colaborar con compañeros de equipo y revertir cuando sea necesario.

Consulte también

  • Last updated on