Vaardigheden registreren en ontdekken in uw API-inventaris

In dit artikel wordt beschreven hoe u Azure API Center gebruikt om agentvaardigheden te registreren als onderdeel van uw API-inventaris. Vaardigheden zijn herbruikbare mogelijkheden die AI-agents kunnen detecteren en gebruiken om hun functionaliteit uit te breiden.

Door vaardigheden te registreren in uw API-centrum, maakt u een gecentraliseerd register dat uw organisatie helpt:

• Ontdek beschikbare vaardigheden en hun mogelijkheden
• Toegang tot broncode en documentatie voor de vaardigheden

Vereiste voorwaarden

• Een API-centrum. Als u nog geen API-centrum hebt, raadpleegt u de quickstart voor het maken van een API-centrum.
• Een of meer vaardigheden die u wilt registreren, meestal gehost in een opslagplaats met broncode, zoals GitHub.

Een vaardigheid registreren

Een vaardigheid registreren in uw API-centrum:

1. Meld u aan bij Azure Portal en ga naar uw API-centrum.

2. Selecteer Assets in het zijbalkmenu onder Inventaris.

3. Selecteer + Registreer een asset>Vaardigheid.

   

4. Geef in het formulier Een vaardigheid registreren de informatie op in de volgende tabel:

   Veld	Beschrijving
   Titel	Voer een beschrijvende naam in voor de vaardigheid (bijvoorbeeld Code Review Skill).
   Identificatie	API Center genereert automatisch een id op basis van de titel (bijvoorbeeld code-review-skill). U kunt dit indien nodig bewerken.
   Samenvatting	Geef een korte beschrijving van één regel op wat de vaardigheid doet (bijvoorbeeld geautomatiseerde codebeoordelingen uitvoeren met behulp van statische analyse).
   Beschrijving	Voer een gedetailleerdere beschrijving in van de mogelijkheden, gebruiksvoorbeelden en het gedrag van de vaardigheid.
   Levenscyclusfase	Selecteer de huidige fase van de levenscyclus van de vaardigheid in de vervolgkeuzelijst.
   bron
   Bron-URL	Voer de URL van de Git-opslagplaats in voor de broncode van de vaardigheid (bijvoorbeeld https://github.com/<org>/<repo>/tree/main/skills/<skill-name>).
   Compatibiliteit	Beschrijf de vereisten, afhankelijkheden en vereisten voor het gebruik van de vaardigheid (bijvoorbeeld vereiste software of hulpprogramma's zoals git, docker, programmeertalen; systeemvereisten; vereisten voor netwerktoegang; API-sleutels of verificatievereisten).
   Toegestane tools	Selecteer + Hulpprogramma toevoegen om de API's of MCP-servers op te geven uit uw API-inventaris waartoe deze vaardigheid toegang heeft. Deze aanpak helpt de juiste governance en beveiliging te garanderen door expliciet te definiëren welke resources de vaardigheid kan gebruiken.
   Licentie	Selecteer + Toevoegen om licentiegegevens op te geven. Voer de licentienaam (bijvoorbeeld MIT, Apache 2.0 of Proprietary) in, geef desgewenst een licentie-URL op en voeg indien nodig een beschrijving toe om licentievoorwaarden of -beperkingen te verduidelijken.
   Contactgegevens	Selecteer + Toevoegen om contactpunten toe te voegen voor ondersteuning of vragen. Voer een naam of rol voor een contactpersoon in (bijvoorbeeld API-team of John Smith), geef contactgegevens op, zoals e-mailadres, en voeg desgewenst een beschrijving toe om te verduidelijken wanneer en waarom u contact opneemt met deze persoon of dit team.

5. Selecteer Maken om de vaardigheid in uw API-centrum te registreren.

Na registratie wordt de vaardigheid weergegeven in uw inventaris op de pagina Inventaris>Bezit.

Een geregistreerde vaardigheid bijwerken

U kunt informatie over vaardigheden op elk gewenst moment bijwerken:

1. Ga in uw API-Centrum naar Inventaris>Assets.
2. Zoek en selecteer de vaardigheid die u wilt bijwerken.
3. Selecteer Bewerken om de eigenschappen van de vaardigheid te wijzigen.
4. Breng uw wijzigingen aan en selecteer Opslaan.

Vaardigheden synchroniseren vanuit een Git-opslagplaats

Als u de registratie van vaardigheden wilt automatiseren en uw inventaris up-to-date wilt houden, kunt u een Git-opslagplaats integreren met uw API-centrum. Zie API-assets synchroniseren vanuit een Git-opslagplaats voor meer informatie.

Vaardigheden ontdekken in de API Center-portal

Stel uw API Center-portal in, zodat ontwikkelaars en andere belanghebbenden in uw organisatie vaardigheden kunnen ontdekken in uw API-inventaris. Vanuit de API Center-portal kunnen gebruikers het volgende doen:

• Blader en filter vaardigheden in de voorraad.
• Bekijk gedetailleerde informatie over elke vaardigheid.

AI-assets evalueren

API Center kan de kwaliteit van AI-assets beoordelen, zoals vaardigheden en agents die zijn geregistreerd in uw API-centrum. API Center wordt geleverd met standaardevaluatiecriteria, waarbij assets worden beoordeeld op basis van vooraf gedefinieerde dimensies. Enterprise-platformbeheerders kunnen deze standaardinstellingen verder uitbreiden door aangepaste evaluatiecriteria te definiëren die zijn afgestemd op de specifieke standaarden, nalevingsvereisten en governancebeleid van hun organisatie.

Geautomatiseerde evaluaties van AI-assets in uw inventaris inschakelen:

1. Ga in Azure Portal naar uw API-centrum.

2. In het zijbalkmenu. ga naar Governance>AI-evaluatie.

3. Selecteer het tabblad Vaardigheden om evaluaties voor vaardigheden te configureren of selecteer het tabblad Agents om evaluaties voor agents te configureren.

4. Selecteer Ingeschakeld in de evaluatiestatus.

5. Voer een beschrijving in voor de evaluatie.

6. Voer in evaluatiecriteria een van de volgende handelingen uit:

   • Accepteer de standaardcriteria van API Center. Verwijder desgewenst standaardcriteria die niet relevant zijn voor uw organisatie.

   In de volgende schermopname ziet u standaardcriteria voor vaardigheden:

   

   • Voeg een of meer aangepaste criteria toe.
     1. Selecteer + Criteria toevoegen.
     2. Voer een naam en optionele evaluatie-instructie in voor het criterium.
     3. Voer minimumscore en maximumscorewaarden in voor de score (bijvoorbeeld 1 en 5).
     4. Voer een drempelwaarde voor een wachtwoord in (bijvoorbeeld 3) die de minimum acceptabele score voor het criterium aangeeft.
     5. Voer een gewichtswaarde in die de bijdrage van het criterium aangeeft aan de totale evaluatie (bijvoorbeeld een gewicht van 0,3 veelvoudt de score met 0,3, wat 30% bijdraagt aan de totale evaluatie).
     6. Herhaal de voorgaande stappen om zo nodig meer criteria toe te voegen.

7. Selecteer Opslaan.

U kunt vervolgens evaluatieresultaten bekijken in de API Center-portal. Bekijk bijvoorbeeld evaluatieresultaten voor elke vaardigheid op de pagina met vaardigheidsgegevens.

Verwante inhoud

• API-assets synchroniseren vanuit een Git-opslagplaats
• Registreer en ontdek MCP-servers en -invoegtoepassingen in uw API-inventaris.
• Uw API Center-portal instellen
• Belangrijkste concepten in Azure API Center