Compartir vía

Extensión de Genie Code con aptitudes de agente

Genie Code incluye aptitudes integradas que están preconfiguradas para flujos de trabajo comunes de Azure Databricks, como escribir código en cuadernos de Azure Databricks, explorar datos en el Catálogo de Unity, crear paneles, crear canalizaciones y trabajar con MLflow. También puede crear sus propias aptitudes para ampliar Genie Code en modo agente con funcionalidades especializadas para las tareas específicas del dominio. En esta página se explica cómo crear y optimizar aptitudes.

¿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 aptitudes de área de trabajo para flujos de trabajo que sean ampliamente útiles en todo el equipo, como flujos de trabajo de aprendizaje automático o procesos específicos del dominio.
  • Aptitudes del usuario: disponible solo para usted. Use aptitudes de usuario para flujos de trabajo personales que no sean relevantes para otros miembros 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.

procedimientos recomendados

Siga estas instrucciones para escribir aptitudes eficaces:

  • Elija el tipo de aptitud adecuado. Use aptitudes de área de trabajo para flujos de trabajo que beneficien a muchos usuarios, como canalizaciones de aprendizaje automático compartidos o procesos específicos del dominio. Use aptitudes de usuario para flujos de trabajo personales que no sean relevantes para otros usuarios.
  • 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.
  • 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