Hulpprogramma's toevoegen aan Azure AI-agent

  • 5 minuten

Met hulpprogramma's van Microsoft Agent Framework kan uw AI-agent bestaande API's en services gebruiken om taken uit te voeren die niet zelfstandig konden worden uitgevoerd. Hulpprogramma's werken via functie-aanroepen, waardoor AI automatisch specifieke functies kan aanvragen en gebruiken. Het framework stuurt de aanvraag naar de juiste functie in uw codebasis en retourneert de resultaten terug naar het LLM (Large Language Model), zodat er een definitief antwoord kan worden gegenereerd.

Als u het aanroepen van automatische functies wilt inschakelen, moeten hulpprogramma's details opgeven die beschrijven hoe ze werken. De invoer, uitvoer en het doel van de functie moeten worden beschreven op een manier die de AI kan begrijpen, anders kan de AI de functie niet correct aanroepen.

Hulpprogramma's gebruiken met Microsoft Foundry Agent

Microsoft Agent Framework ondersteunt zowel aangepaste functiehulpprogramma's als ingebouwde hulpprogramma's die kant-en-klaar zijn voor gebruik.

Ingebouwde hulpprogramma's

Microsoft Foundry Agents worden geleverd met verschillende ingebouwde hulpprogramma's die u onmiddellijk kunt gebruiken:

  • Code-interpreter : voert Python-code uit voor berekeningen, gegevensanalyse en meer
  • Bestanden zoeken - documenten doorzoeken en analyseren
  • Webzoekopdrachten - haalt informatie op van internet

Deze hulpprogramma's zijn automatisch beschikbaar en vereisen geen extra installatie.

Aangepaste functiegereedschappen

Wanneer u aangepaste hulpprogramma's voor uw Microsoft Foundry Agent maakt, moet u een aantal belangrijke concepten begrijpen:

  1. Functiedefinitie en aantekeningen

    Maak uw hulpprogramma door een reguliere Python-functie te definiëren met de juiste typeaantekeningen. Gebruik Annotated en Field van Pydantic om gedetailleerde beschrijvingen te bieden waarmee de AI het doel van de functie begrijpt en hoe u de parameters ervan kunt gebruiken. Hoe beschrijvender uw aantekeningen, hoe beter de AI begrijpt wanneer en hoe u uw functie aanroept.

  2. Hulpprogramma's toevoegen aan uw agent

    Geef uw aangepaste functies door aan de ChatAgent tijdens het maken met behulp van de tools parameter. U kunt één functie of een lijst met meerdere functies toevoegen. Het framework registreert deze functies automatisch en maakt ze beschikbaar voor de AI die moet worden aangeroepen.

  3. Aanroepen van hulpprogramma's via gesprek

    Zodra uw hulpprogramma's zijn geregistreerd bij de agent, hoeft u ze niet handmatig aan te roepen. Stel in plaats daarvan vragen aan de agent of geef deze taken die natuurlijk de functionaliteit van uw hulpprogramma vereisen. De AI bepaalt automatisch wanneer u uw hulpprogramma's aanroept op basis van de gesprekscontext en de beschrijvingen van de hulpprogramma's die u hebt opgegeven.

  4. Meerdere hulpprogramma's en orkestratie

    U kunt meerdere hulpprogramma's toevoegen aan één agent en de AI kiest automatisch welk hulpprogramma moet worden gebruikt op basis van de aanvraag van de gebruiker. Het framework verwerkt de indeling, het aanroepen van de juiste functies en het combineren van hun resultaten om een uitgebreid antwoord te bieden.

Aanbevolen procedures voor het ontwikkelen van hulpprogramma's

  • Duidelijke beschrijvingen: schrijf duidelijke, gedetailleerde beschrijvingen voor uw functies en parameters om de AI te helpen hun doel te begrijpen
  • Typeaantekeningen: gebruik de juiste Python-typehints om verwachte invoer- en uitvoertypen op te geven
  • Foutafhandeling: Implementeer de juiste foutafhandeling in uw hulpprogrammafuncties om onverwachte invoer correct af te handelen
  • Nuttige gegevens retourneren: zorg ervoor dat uw functies gegevens retourneren die de AI effectief kan gebruiken in de antwoorden
  • Houd functies gefocust: ontwerp elk hulpprogramma om een specifieke taak af te handelen in plaats van te veel dingen te doen in één functie

Door deze concepten te volgen, kunt u uw Microsoft Foundry Agent uitbreiden met zowel ingebouwde als aangepaste hulpprogramma's, zodat deze kan communiceren met API's en geavanceerde taken kan uitvoeren. Deze aanpak maakt uw AI krachtiger en geschikter voor het efficiënt verwerken van echte toepassingen.