Genie Code uitbreiden met agentvaardigheden

Genie Code wordt geleverd met ingebouwde vaardigheden die vooraf zijn geconfigureerd voor algemene Azure Databricks werkstromen, zoals het schrijven van code in Azure Databricks notebooks, het verkennen van gegevens in Unity Catalog, het bouwen van dashboards, het maken van pijplijnen en het werken met MLflow. U kunt ook uw eigen vaardigheden maken om Genie Code uit te breiden in de agentmodus met speciale mogelijkheden voor uw domeinspecifieke taken. Op deze pagina wordt uitgelegd hoe u vaardigheden kunt maken en optimaliseren.

Wat zijn vaardigheden?

Maak vaardigheden om Genie Code uit te breiden met gespecialiseerde mogelijkheden. Vaardigheden volgen de open standaard van agentvaardigheden. Domeinspecifieke kennis en werkstromen van vaardighedenpakket die Genie Code kan laden wanneer dit relevant is voor het uitvoeren van specifieke taken. Vaardigheden kunnen richtlijnen, best practices, herbruikbare code en uitvoerbare scripts omvatten.

Vaardigheden moeten worden afgestemd op domeinspecifieke taken. Met vaardigheden kunt u meer context bieden (zoals scripts, voorbeelden en andere resources) voor een taak dan met instructies. In tegenstelling tot aangepaste instructies, die wereldwijd worden toegepast, worden vaardigheden automatisch geladen en alleen in de relevante context. In de agentmodus laadt Genie Code automatisch vaardigheden indien relevant, op basis van uw aanvraag en de beschrijving van de vaardigheid. U kunt ook handmatig vaardigheden aanroepen door @ ze te vermelden. Dit onderhoudt een efficiënt contextvenster en vermindert de noodzaak om dezelfde context te bieden voor meerdere chats.

Er zijn twee soorten vaardigheden:

  • Werkruimtevaardigheden: beschikbaar voor iedereen in de werkruimte. Werkruimtebeheerders kunnen werkruimtevaardigheden maken en anderen toegang verlenen tot de vaardighedenmap zodat ze meer kunnen toevoegen. Gebruik werkruimtevaardigheden voor werkstromen die in grote lijnen nuttig zijn voor uw team, zoals machine learning-werkstromen of domeinspecifieke processen.
  • Gebruikersvaardigheden: alleen beschikbaar voor u. Gebruik gebruikersvaardigheden voor persoonlijke werkstromen die niet relevant zijn voor andere leden van de werkruimte.

Opmerking

Vaardigheden worden alleen ondersteund in Agent modus van Genie Code.

Een vaardigheid maken

Vaardigheden leven in een .assistant/skills/ directory. Elke vaardigheid moet een eigen map en een SKILL.md bestand in die map hebben. De locatie is afhankelijk van het vaardigheidstype:

  • Werkruimtevaardigheden: Workspace/.assistant/skills/
  • Gebruikersvaardigheden: /Users/{username}/.assistant/skills/

Ga als volgt te werk om een nieuwe vaardigheid te maken:

  1. Maak een nieuwe vaardigheidsmap op het juiste pad voor uw type vaardigheid.

    Na het maken hebt u snel toegang tot uw vaardighedenmap in het deelvenster Genie Code. Klik op Tandwielpictogram. Instellingen en klik vervolgens op Pijl in Pictogram. Open de map Vaardigheden.

  2. Maak een speciale map voor uw vaardigheid in de map vaardigheden. Elke vaardigheid moet een eigen map hebben. Voorbeeld:

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

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

  3. Maak in uw vaardigheidsmap een SKILL.md bestand. Dit bestand is vereist en definieert de vaardigheid. Vaardigheden volgen de specificaties van agentvaardigheden.

  4. Voeg de vereiste voorinformatie toe voor je vaardigheid:

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

  5. Voeg de instructies voor vaardigheden toe in Markdown-indeling na de frontmatter. Het is raadzaam om de volgende secties op te nemen:

    • Stapsgewijze instructies: Duidelijke procedurele richtlijnen
    • Voorbeelden: Voorbeeldinvoer en verwachte uitvoer
    • Edge-gevallen: veelvoorkomende variaties en uitzonderingen

  6. (Optioneel) Voor complexere vaardigheden kunt u aanvullende bronnen opgeven en ernaar verwijzen:

    • Scripts met uitvoerbare code die door de agent kan worden uitgevoerd.
    • Bestanden met aanvullende documentatie waarnaar moet worden verwezen, zoals best practices en sjablonen.

    Wanneer u naar andere bestanden verwijst, gebruikt u relatieve paden uit de hoofdvaardigheid.

    Een vaardigheid voor machine learning-werkstromen op de werkplek en een vaardigheid voor persoonlijke werkstromen kunnen bijvoorbeeld de volgende structuur hebben:

    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 haalt automatisch uw vaardigheden op wanneer u deze de volgende keer in de agentmodus gebruikt. U kunt ook @ vaardigheden vermelden om ervoor te zorgen dat Genie Code ze gebruikt.

Beste praktijken

Volg deze richtlijnen om effectieve vaardigheden te schrijven:

  • Kies het juiste vaardigheidstype. Werkruimtevaardigheden gebruiken voor werkstromen die veel gebruikers ten goede komen, zoals gedeelde machine learning-pijplijnen of domeinspecifieke processen. Gebruik gebruikersvaardigheden voor persoonlijke werkstromen die niet relevant zijn voor anderen.
  • Houd vaardigheden gefocust. Vaardigheden werken het beste wanneer ze zich richten op één taak of werkstroom. Een beperkt bereik maakt het eenvoudiger voor Genie Code om te herkennen wanneer een vaardigheid van toepassing is.
  • Gebruik duidelijke namen en beschrijvingen. Een beknopte, beschrijvende naam en samenvatting helpen Genie Code de juiste vaardigheid aan te passen aan de juiste aanvraag.
  • Wees expliciet en voorbeeldgestuurd. Beschrijf stap voor stap werkstromen en voeg concrete voorbeelden of patronen toe die Genie Code kan hergebruiken.
  • Vermijd onnodige context. Neem alleen informatie op die vereist is voor de taak. Extra details kunnen vaardigheden moeilijker maken om betrouwbaar toe te passen.
  • Herhalen in de loop van de tijd. Vaardigheden behandelen als levende werkstromen. Kleine updates op basis van echt gebruik kunnen de resultaten aanzienlijk verbeteren.
  • Scheid de richtlijnen van automatisering. Gebruik Markdown om intentie en best practices en scripts voor herhaalbare acties uit te leggen. Door deze zorgen uniek te houden, kunnen vaardigheden gemakkelijker worden onderhouden en hergebruikt.
  • Versiebeheer uw vaardigheden. Ondersteun je vaardighedenmap met Databricks Git-mappen om wijzigingen bij te houden, samen te werken met teamgenoten en zo nodig terug te draaien.

Zie ook

  • Last updated on