Extensión del Asistente con aptitudes del agente

Cree aptitudes para ampliar Databricks Assistant 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 el Asistente con funcionalidades especializadas. Las aptitudes siguen el estándar abierto de aptitudes del agente. Los paquetes de aptitudes encapsulan conocimientos y flujos de trabajo específicos del dominio, que el Asistente puede cargar cuando sea relevante 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 de agente, el Asistente carga automáticamente las aptitudes cuando sea pertinente, en función de la solicitud y la descripción de la aptitud. Esto mantiene una ventana de contexto eficaz y reduce la necesidad de proporcionar el mismo contexto en varios chats.

Nota:

Las habilidades solo son compatibles en el modo de agente de Databricks Assistant.

Crear una aptitud

Las habilidades se encuentran en el /Users/{username}/.assistant/skills/ directorio. Cada aptitud debe tener su propia carpeta y un SKILL.md archivo dentro de esa carpeta.

Para crear una nueva aptitud:

1. En la carpeta del área de trabajo de usuario, cree una carpeta de aptitudes. La ruta de acceso de la carpeta debe ser: /Users/{username}/.assistant/skills/.

   Después de la creación, puede acceder rápidamente a esta carpeta en el panel Asistente. Haga clic en Configuración y, a continuación, haga clic 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, si estás creando una habilidad para flujos de trabajo personales, tu estructura de carpetas podría ser:

   /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, puede tener una habilidad de flujo de trabajo personal que haga referencia a prácticas recomendadas de ETL, plantillas de paneles y scripts para la configuración y despliegue de canalizaciones. La carpeta de la habilidad podría incluir los siguientes archivos:

   /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
            └── model-deploy.py     # Model deployment automation
   

Databricks Assistant recoge automáticamente sus aptitudes la próxima vez que la use en modo de agente.

procedimientos recomendados

Siga estas instrucciones para escribir aptitudes eficaces:

• 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 el Asistente reconozca cuándo se aplica una aptitud.
• Use nombres y descripciones claros. Un nombre conciso, descriptivo y resumen ayudan al Asistente 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 el Asistente 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.