Lägga till verktyg i Azure AI-agenten
I Microsoft Agent Framework tillåter verktyg din AI-agent att använda befintliga API:er och tjänster för att utföra uppgifter som den inte kunde utföra på egen hand. Verktyg fungerar genom funktionsanrop så att AI automatiskt kan begära och använda specifika funktioner. Ramverket dirigerar begäran till lämplig funktion i din kodbas och returnerar resultatet tillbaka till den stora språkmodellen (LLM) så att den kan generera ett slutligt svar.
För att aktivera automatiska funktionsanrop måste verktygen ange information som beskriver hur de fungerar. Funktionens indata, utdata och syfte bör beskrivas på ett sätt som AI:n kan förstå, annars kan AI:n inte anropa funktionen korrekt.
Använda verktyg med Microsoft Foundry Agent
Microsoft Agent Framework stöder både anpassade funktionsverktyg och inbyggda verktyg som är redo att användas direkt.
Inbyggda verktyg
Microsoft Foundry-agenter har flera inbyggda verktyg som du kan använda direkt:
- Kodtolkare – kör Python-kod för beräkningar, dataanalys med mera
- Filsökning – söker igenom och analyserar dokument
- Webbsökning – hämtar information från Internet
De här verktygen är automatiskt tillgängliga och kräver ingen extra installation.
Anpassade funktionsverktyg
När du skapar anpassade verktyg för microsoft foundry-agenten måste du förstå flera viktiga begrepp:
Funktionsdefinition och anteckningar
Skapa verktyget genom att definiera en vanlig Python-funktion med rätt typanteckningar. Använd
AnnotatedochFieldfrån Pydantic för att tillhandahålla detaljerade beskrivningar som hjälper AI:n att förstå funktionens syfte och hur man använder dess parametrar. Ju mer beskrivande dina anteckningar är, desto bättre kan AI:n förstå när och hur du anropar din funktion.Lägga till verktyg i din agent
Skicka dina anpassade funktioner till ChatAgent när du skapar med hjälp av parametern
tools. Du kan lägga till en enskild funktion eller en lista över flera funktioner. Ramverket registrerar automatiskt dessa funktioner och gör dem tillgängliga för AI:n att anropa.Anropa verktyg via konversation
När dina verktyg har registrerats med agenten behöver du inte anropa dem manuellt. Ställ i stället agenten frågor eller ge den uppgifter som naturligtvis skulle kräva verktygets funktioner. AI:n avgör automatiskt när du ska anropa dina verktyg baserat på konversationskontexten och de verktygsbeskrivningar som du angav.
Flera verktyg och orkestrering
Du kan lägga till flera verktyg i en enda agent, och AI:n väljer automatiskt vilket verktyg som ska användas baserat på användarens begäran. Ramverket hanterar orkestreringen, anropar lämpliga funktioner och kombinerar deras resultat för att ge ett omfattande svar.
Metodtips för verktygsutveckling
- Tydliga beskrivningar: Skriv tydliga, detaljerade beskrivningar för dina funktioner och parametrar för att hjälpa AI:n att förstå deras syfte
- Typannoteringar: Använd Pythons typanvisningar för att ange förväntade in- och utdatatyper
- Felhantering: Implementera lämplig felhantering i verktygsfunktionerna för att hantera oväntade indata på ett korrekt sätt
- Returnera meningsfulla data: Se till att dina funktioner returnerar data som AI:n effektivt kan använda i sina svar
- Håll funktionerna fokuserade: Utforma varje verktyg för att hantera en viss uppgift i stället för att försöka göra för många saker i en funktion
Genom att följa dessa begrepp kan du utöka Din Microsoft Foundry Agent med både inbyggda och anpassade verktyg, så att den kan interagera med API:er och utföra avancerade uppgifter. Den här metoden gör din AI mer kraftfull och kan hantera verkliga program effektivt.