Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Met de Microsoft Foundry-agentextensie voor de Azure Developer CLI (azd) kunt u agents genereren, inrichten en implementeren naar Microsoft Foundry vanuit uw terminal of editor. Het combineert de mogelijkheden van Foundry-agents met azd levenscyclusopdrachten voor een consistente lokale naar-cloud-werkstroom. U kunt van een voorbeeldagent naar een geïmplementeerd, aanroepbaar eindpunt gaan met een paar opdrachten.
In dit artikel wordt de extensie geïntroduceerd. Zie de documentatie over door Microsoft Foundry gehoste agents voor volledige stapsgewijze instructies.
Belangrijkste kenmerken
| Feature | Description |
|---|---|
| Projectstructuur opzetten | Hiermee stelt u volledige agentprojecten in, waaronder infrastructuur als codesjablonen, agentdefinities en configuratie, zodat u meteen kunt beginnen met herhalen. |
| Declaratieve configuratie | Definieert services, resources en modelimplementaties in een azure.yaml bestand voor consistente omgevingen. |
| Geïntegreerde inrichting en implementatie | Voer azd up uit om containers te bouwen, images te pushen, resources te maken, modellen te implementeren en de agent in één stap te publiceren. |
| Agentdefinitiebeheer | Hiermee importeert u agentdefinities uit catalogi, GitHub of lokale paden en wijst u vereiste parameters toe aan omgevingsvariabelen. |
| Standaard beveiligd | Hiermee stelt u beheerde identiteiten en basislijnbeveiliging automatisch in zonder referenties handmatig te verwerken. |
| Schaalbare beschikbaarstelling van modellen | Hiermee geeft u modelnamen, versies en capaciteit op en implementeert u ze consistent in omgevingen. |
De werkstroom verkennen
De extensie volgt een bekende azd levenscyclus, van het opzetten van de basisstructuur tot een live agent:
- Scaffold: Initialiseer een voorbeeldagentproject, inclusief infrastructuur als code, een agentdefinitie en configuratie.
- Inrichten en implementeren: Maak het Foundry-account en -project, implementeer modellen, bouw en push de agentcontainer en publiceer de agent.
- Lokaal uitvoeren: De agent iteratief ontwikkelen op uw lokale computer terwijl deze is verbonden met externe Azure-resources.
- Aanroepen en bewaken: verzend prompts naar de geïmplementeerde agent en stream livelogboeken.
- Losmaken: verwijder alle ingerichte resources wanneer u klaar bent.
Probeer het
Probeer een voorbeeldagent te implementeren met de minimale werkstroom. In dit voorbeeld wordt het basic Agent Framework-voorbeeld uit de Microsoft Foundry-documentatie gebruikt.
Genereer een voorbeeldproject voor een agent in een lege map:
azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yamlRicht resources in en implementeer de agent in één stap:
azd upTip
U kunt deze stap ook splitsen in
azd provisionenazd deployvoor meer controle over elke fase.Verwijder alle ingerichte hulpbronnen wanneer u klaar bent:
azd downWaarschuwing
azd downverwijdert elke resource in de resourcegroep definitief. Gebruik deze met zorg in gedeelde of productieomgevingen.
Zie quickstart: Uw eerste gehoste agent implementeren voor vereisten, modelselectie, lokaal testen en probleemoplossing.
Wanneer gebruikt u de agentextensie?
Microsoft Foundry ondersteunt verschillende manieren om gehoste agents te bouwen en implementeren, waaronder de Python SDK, Visual Studio Code en de portal. De azd agentextensie is het meest geschikt als u het volgende wilt doen:
- Werk voornamelijk vanuit de terminal of editor met een scriptbare, herhaalbare werkstroom.
-
Beheer infrastructuur en agents samen met behulp van declaratieve
azure.yamlen Bicep bestanden onder broncodebeheer. -
Ga consistent van lokaal naar de cloud met dezelfde
azdlevenscyclusopdrachten (azd init,azd up,azd down) die u al gebruikt voor andere Azure-apps. - Standaardiseer implementaties in omgevingen (dev, test en productie) en automatiseer ze in CI/CD.
Voor een begeleide portalervaring of voor het ontwerpen van agents met de Python SDK begint u met de documentatie voor gehoste Microsoft Foundry-agents.