Compartir a través de

Extensión de Genie Code con aptitudes de agente

Cree 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.

Nota:

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

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 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, 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

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:

  • 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.

Consulte también

  • Last updated on