Registrera och hantera agenter i Azure API Center

Den här artikeln visar hur du registrerar AI-agenter, inklusive A2A-agenter, i API Center, gör dem identifierbara för användare och uppdaterar och hanterar dem.

Förutsättningar

• En Azure API Center-instans
• En agent som beskrivs av ett agentkort i JSON-format eller en agentdefinition i Markdown-format
• Lämpliga behörigheter för att redigera API:er i API Center

Registrera agent

1. Logga in på Azure-portalen och gå till API-centret.

2. I sidomenyn under Inventering väljer du Tillgångar.

3. Välj + Registrera en tillgång>Agent.

   

4. I formuläret Registrera en agent anger du den information som beskrivs i följande tabell:

   Fält	Description
   Titel	Ange ett beskrivande namn för agenten, till exempel supportavdelningen.
   Identifikation	API Center genererar automatiskt en identifierare baserat på rubriken, till exempel supportavdelningen. Du kan redigera den här identifieraren om det behövs.
   Kort sammanfattning	Ange en kort enradsbeskrivning av vad agenten gör som visas i API Center-portalen och andra platser.
   Description	Du kan också ange en mer detaljerad beskrivning av kompetensens funktioner, användningsfall och beteende.
   Version
   Versionsrubrik	Ange valfri versionsrubrik, till exempel v1.
   Versionsidentifiering	API Center genererar automatiskt en identifierare baserat på versionsrubriken. Du kan redigera den här identifieraren om det behövs.
   Versionslivscykel	Välj den aktuella fasen i agentversionens livscykel på den nedrullningsbara menyn. Läs mer om versioner i API Center.
   Agentinformation
   Agentdefinition	Ange en URL eller Välj en fil för att ladda upp en agentdefinition. Agentdefinitionen ska vara i Markdown-format och innehålla information om agentens funktioner, färdigheter och annan relevant information.
   Protocol	Om tillämpligt väljer du A2A-protokollet om agenten följer det.
   Agentkort	Du kan också ange en URL eller Välj en fil för att ladda upp ett A2A-agentkort i JSON-format.

   

5. Välj Skapa för att lägga till agenten.

Efter registreringen visas agenten i ditt lager på sidan Lagertillgångar>.

Uppdatera en registrerad agent

Du kan uppdatera agentinformation när som helst.

1. I Azure-portalen går du till ditt API-center.
2. I sidomenyn under Inventering väljer du Tillgångar.
3. I tabellen väljer du agentnamnet i kolumnen Rubrik .
4. Välj knappen Redigera för att öppna sidan Redigera i arbetsfönstret.
5. Gör dina ändringar och välj Spara.

Synkronisera agenter från API-källor

Om du vill automatisera agentregistreringen och hålla ditt lager uppdaterat kan du integrera följande överordnade källor med ditt API Center:

• Azure API Management: Om du hanterar A2A-agenter i Azure API Management kan du aktivera automatisk synkronisering för att hålla API Center uppdaterat. Mer information finns i Synkronisera API:er från Azure API Management-instansen.

• Git-lagringsplats: För A2A-agenter och andra AI-tillgångar som lagras på en Git-lagringsplats kan du aktivera automatisk synkronisering för att hålla DITT API Center uppdaterat. Mer information finns i Synkronisera API-tillgångar från en Git-lagringsplats.

Identifiera agenter i API Center-portalen

Konfigurera API Center-portalen så att utvecklare och andra intressenter i din organisation kan identifiera agenter i API-inventeringen. Från API Center-portalen kan användarna:

• Bläddra och filtrera agenter i inventariet.
• Visa detaljerad information om varje agent.

Utvärdera AI-tillgångar

API Center kan utvärdera kvaliteten på AI-tillgångar, till exempel färdigheter och agenter som är registrerade i ditt API Center. API Center levereras med standardutvärderingskriterier direkt och utvärderar tillgångar över fördefinierade dimensioner. Företagsplattformsadministratörer kan utöka dessa standardvärden ytterligare genom att definiera anpassade utvärderingskriterier som är skräddarsydda för organisationens specifika standarder, efterlevnadskrav och styrningsprinciper.

Så här aktiverar du automatiserade utvärderingar av AI-tillgångar i ditt lager:

1. I Azure-portalen går du till ditt API-center.

2. I sidomenyn. gå till Styrning>AI-utvärdering.

3. Välj fliken Färdigheter för att konfigurera utvärderingar för kunskaper eller välj fliken Agenter för att konfigurera utvärderingar för agenter.

4. I Utvärderingsstatus väljer du Aktiverad.

5. Ange en beskrivning för utvärderingen.

6. I Utvärderingskriterier gör du något av följande:

   • Acceptera standardvillkoren som tillhandahålls av API Center. Du kan också ta bort standardvillkor som inte är relevanta för din organisation.

   Följande skärmbild visar standardvillkor för färdigheter:

   

   • Lägg till ett eller flera anpassade villkor.
     1. Välj + Lägg till villkor.
     2. Ange ett namn och valfri utvärderingsinstruktion för kriteriet.
     3. Ange Lägsta poäng och Högsta poäng för poängen (till exempel 1 och 5).
     4. Ange ett tröskelvärde för passering (till exempel 3) som anger den lägsta godtagbara poängen för kriteriet.
     5. Ange ett viktvärde som anger kriteriets bidrag till den totala utvärderingen (till exempel en vikt på 0,3 multiplar poängen med 0,3, vilket bidrar med 30% till den totala utvärderingen).
     6. Upprepa föregående steg för att lägga till fler villkor efter behov.

7. Välj Spara.

Du kan sedan visa utvärderingsresultat i API Center-portalen. Du kan till exempel visa utvärderingsresultat för varje färdighet på kunskapsinformationssidan.

Relaterat innehåll

• Synkronisera API-tillgångar från en Git-lagringsplats
• Registrera och identifiera MCP-servrar i API-inventeringen
• Konfigurera API Center-portalen
• Viktiga begrepp i Azure API Center