Agents registreren en beheren in Azure API-centrum

In dit artikel leest u hoe u AI-agents, waaronder A2A-agents, registreert in API Center, ze detecteerbaar maakt voor gebruikers en hoe u ze bijwerkt en beheert.

Vereiste voorwaarden

• Een Azure API Center-exemplaar
• Een agent die wordt beschreven door een agentkaart in JSON-indeling of een agentdefinitie in Markdown-indeling
• Juiste machtigingen voor het bewerken van API's in uw API Center

Agent registreren

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

2. Selecteer Assets in het zijbalkmenu onder Inventaris.

3. Selecteer + Een asset registreren>Agent.

   

4. Voer in het formulier Een agent registreren de informatie in die wordt beschreven in de volgende tabel:

   Veld	Description
   Title	Voer een beschrijvende naam in voor de agent, zoals helpdeskagent.
   Identificatie	API Center genereert automatisch een id op basis van de titel, zoals helpdeskagent. U kunt deze id indien nodig bewerken.
   Korte samenvatting	Voer een korte beschrijving van één regel in van wat de agent doet die wordt weergegeven in de API Center-portal en andere locaties.
   Description	Voer desgewenst een gedetailleerdere beschrijving in van de mogelijkheden, gebruiksvoorbeelden en het gedrag van de vaardigheid.
   Version
   Versietitel	Voer een versietitel van uw keuze in, zoals v1.
   Versie-identificatie	API Center genereert automatisch een id op basis van de versietitel. U kunt deze id indien nodig bewerken.
   Levenscyclus van versie	Selecteer de huidige fase van de levenscyclus van de agentversie in de vervolgkeuzelijst. Meer informatie over versies in API Center.
   Agentdetails
   Agentdefinitie	Voer een URL in of selecteer een bestand om een agentdefinitie te uploaden. De agentdefinitie moet de Markdown-indeling hebben en informatie bevatten over de mogelijkheden, vaardigheden en andere relevante informatie van de agent.
   Protocol	Selecteer indien van toepassing het A2A-protocol als de agent zich hieraan houdt.
   Agentkaart	Voer desgewenst een URL in of selecteer een bestand om een A2A-agentkaart te uploaden in JSON-indeling.

   

5. Selecteer Maken om de agent toe te voegen.

Na registratie verschijnt de agent in uw inventaris op de pagina Inventaris>Assets.

Een geregistreerde agent bijwerken

U kunt agentgegevens op elk gewenst moment bijwerken.

1. Ga in Azure Portal naar uw API-centrum.
2. Selecteer Assets in het zijbalkmenu onder Inventaris.
3. Selecteer in de tabel de naam van de agent in de kolom Titel .
4. Selecteer de knop Bewerken om de pagina Bewerken in het werkvenster te openen.
5. Breng uw wijzigingen aan en selecteer Opslaan.

Agents uit API-bronnen synchroniseren

Als u de registratie van agents wilt automatiseren en uw inventaris up-to-date wilt houden, kunt u de volgende upstream-bronnen integreren met uw API-centrum:

• Azure API Management: Als u A2A-agents beheert in Azure API Management, kunt u automatische synchronisatie inschakelen om uw API-centrum up-to-date te houden. Zie voor meer informatie API's synchroniseren vanaf een Azure API Management instantie.

• Git-opslagplaats: Voor A2A-agents en andere AI-assets die zijn opgeslagen in een Git-opslagplaats, kunt u automatische synchronisatie inschakelen om uw API-centrum up-to-date te houden. Zie API-assets synchroniseren vanuit een Git-opslagplaats voor meer informatie.

Zoek agents in de API Center-portal

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

• Blader door en filter agenten in de inventaris.
• Bekijk gedetailleerde informatie over elke agent.

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
• MCP-servers registreren en detecteren in uw API-inventaris
• Uw API Center-portal instellen
• Belangrijkste concepten in Azure API Center