Delen via

De assistent uitbreiden met agentvaardigheden

Maak vaardigheden om Databricks Assistant uit te breiden in de agentmodus met gespecialiseerde mogelijkheden voor uw domeinspecifieke taken. Op deze pagina wordt uitgelegd hoe u vaardigheden kunt maken en optimaliseren.

Wat zijn vaardigheden?

Maak vaardigheden om de assistent uit te breiden met gespecialiseerde mogelijkheden. Vaardigheden volgen de open standaard van agentvaardigheden. Domeinspecifieke kennis en werkstromen van het vaardighedenpakket die de Assistent 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 de assistent automatisch vaardigheden indien relevant, op basis van uw aanvraag en de beschrijving van de vaardigheid. Dit onderhoudt een efficiënt contextvenster en vermindert de noodzaak om dezelfde context te bieden voor meerdere chats.

Opmerking

Vaardigheden worden alleen ondersteund in de agentmodus van Databricks Assistant.

Een vaardigheid maken

Vaardigheden leven in de /Users/{username}/.assistant/skills/ directory. Elke vaardigheid moet een eigen map en een SKILL.md bestand in die map hebben.

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

  1. Maak een nieuwe map met vaardigheden in uw gebruikerswerkruimtemap. Het pad naar de map moet zijn: /Users/{username}/.assistant/skills/.

    Na het maken hebt u snel toegang tot deze map in het deelvenster Assistent. 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. Als u bijvoorbeeld een vaardigheid voor persoonlijke werkstromen maakt, kan uw mapstructuur het volgende zijn:

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

    U hebt bijvoorbeeld een persoonlijke werkstroomvaardigheid die verwijst naar best practices voor ETL, dashboardsjablonen en scripts voor het instellen en implementeren van pijplijnen. De map van uw vaardigheid kan de volgende bestanden bevatten:

    /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 haalt automatisch uw vaardigheden op wanneer u deze de volgende keer in de agentmodus gebruikt.

Beste praktijken

Volg deze richtlijnen om effectieve vaardigheden te schrijven:

  • Houd vaardigheden gefocust. Vaardigheden werken het beste wanneer ze zich richten op één taak of werkstroom. Beperkt bereik maakt het gemakkelijker voor de assistent om te herkennen wanneer een vaardigheid van toepassing is.
  • Gebruik duidelijke namen en beschrijvingen. Een beknopte, beschrijvende naam en samenvatting helpen de assistent de juiste vaardigheid aan de juiste aanvraag te koppelen.
  • Wees expliciet en voorbeeldgestuurd. Beschrijf stap voor stap werkstromen en voeg concrete voorbeelden of patronen toe die de Assistent 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.

Zie ook

  • Last updated on