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.
In deze zelfstudie van 5 minuten zonder code maakt u kennis met AI op Azure Databricks. U gebruikt de AI Playground om het volgende te doen:
- Query's uitvoeren op grote taalmodellen (LLM's) en resultaten naast elkaar vergelijken
- Een prototype bouwen van een agent die tools aanroept
- Uw agent exporteren naar Databricks-apps of naar een notebook
- Optioneel: Prototype maken van een vraag-antwoord chatbot met behulp van retrieval-augmented generation (RAG)
Voordat u begint
Zorg ervoor dat uw werkruimte toegang heeft tot het volgende:
- Unity Catalogus.
- Aangepaste agents. Zie Functies met beperkte regionale beschikbaarheid.
Stap 1: Queryen van LLM's met AI Playground
Gebruik de AI Playground om query's uit te voeren op LLM's in een chatinterface.
- Selecteer In uw werkruimte Playground in het linkernavigatiedeelvenster onder AI/ML.
- Typ een vraag zoals 'Wat is RAG?'
Voeg een nieuwe LLM toe om antwoorden naast elkaar te vergelijken:
- Selecteer + rechtsboven om een model voor vergelijking toe te voegen.
- Selecteer in het nieuwe deelvenster een ander model met behulp van de vervolgkeuzelijstkiezer.
- Schakel de selectievakjes Synchroniseren in om de query's te synchroniseren.
- Probeer een nieuwe prompt, zoals 'Wat is een samengesteld AI-systeem?' om de twee antwoorden naast elkaar te zien.
Blijf testen en vergelijken met verschillende LLM's om u te helpen bepalen wat het beste is om een agent te bouwen.
Stap 2: een prototype maken van een agent voor het aanroepen van hulpprogramma's
Met hulpprogramma's kunnen LLM's meer doen dan taal genereren. Hulpprogramma's kunnen externe gegevens opvragen, code uitvoeren en andere acties uitvoeren. AI Playground biedt u een optie zonder code voor het prototype van agents voor het aanroepen van hulpprogramma's:
Kies in Playground een model met het label Tools ingeschakeld.
Selecteer Hulpprogramma's>+ Hulpprogramma toevoegen en selecteer de ingebouwde Unity Catalog-functie,
system.ai.python_exec.Met deze functie kan uw agent willekeurige Python-code uitvoeren.
Andere hulpprogrammaopties zijn:
- UC-functie: Selecteer een Unity Catalog-functie die door uw agent moet worden gebruikt.
- Functiedefinitie: Definieer een aangepaste functie die uw agent moet aanroepen.
- AI Search: geef een AI Search-index op. Als uw agent gebruikmaakt van een AI Search-index, worden de gebruikte bronnen in het antwoord ervan weergegeven.
- MCP: Geef MCP-servers op voor het gebruik van beheerde Databricks MCP-servers of externe MCP-servers.
Stel een vraag waarbij Python-code wordt gegenereerd of uitgevoerd. U kunt verschillende variaties op uw promptformulering proberen. Als u meerdere hulpprogramma's toevoegt, selecteert de LLM het juiste hulpprogramma om een antwoord te genereren.
Optioneel: Prototype maken van een RAG-vraag-antwoordbot
Als u een AI Search-index hebt ingesteld in uw werkruimte, kunt u een prototype maken van een vraag-antwoordbot. Dit type agent gebruikt documenten in een AI Search-index om vragen op basis van deze documenten te beantwoorden.
Klik op Hulpprogramma's>+ hulpprogramma toevoegen. Selecteer vervolgens uw AI Search-index.
Stel een vraag met betrekking tot uw documenten. De agent kan de index gebruiken om relevante informatie op te zoeken en citeert alle documenten die in het antwoord worden gebruikt.
Zie Een AI Search-index maken om een AI Search-index in te stellen.
Stap 3: Uw agent exporteren
Nadat u uw agent in AI Playground hebt getest, exporteert u deze zodat u deze buiten de speeltuin kunt implementeren, evalueren en herhalen. AI Playground biedt twee exportpaden:
-
Exporteren naar Databricks-apps (aanbevolen): hiermee installeert u een implementeerbare agent-app vanuit de
agent-openai-agents-sdksjabloon, waaronder een ingebouwde chatinterface, MCP-hulpprogramma bedrading en verificatie. Kies dit pad voor nieuwe agents. - Create agent notebook (verouderd): genereert een Python notebook waarmee de agent wordt gedefinieerd en geïmplementeerd in een Model Serving-eindpunt. Kies dit pad als Databricks Apps niet beschikbaar is in uw werkruimte of regio.
Exporteren naar apps (aanbevolen)
Met de optie Exporteren naar Databricks-apps wordt een geïmplementeerde agent-app gegenereerd waarmee u kunt chatten. De app maakt gebruik van hetzelfde model, dezelfde systeemprompt en hulpprogramma's (inclusief MCP-servers en vectorzoekopdrachten) die u hebt geconfigureerd in de Playground.
Voordat u exporteert, moet u ervoor zorgen dat uw werkruimte voldoet aan de volgende vereisten:
- Databricks Apps moeten ingeschakeld zijn in uw werkruimte. Zie Uw Databricks Apps-werkruimte en -ontwikkelomgeving instellen.
- Het eindpunt dat in stap 2 is geselecteerd, moet hulpprogramma's ondersteunen.
- De preview-versie van beheerde MCP-servers moet zijn ingeschakeld in uw werkruimte. Zie Azure Databricks previews beheren.
De agent exporteren:
Klik in de Playground op Code ophalen>Exporteren naar Databricks-apps.
Stel in het dialoogvenster Exporteren naar Databricks-apps het volgende in:
-
App-naam: Een unieke naam die begint met
agent-en alleen kleine letters, cijfers en afbreekstreepjes bevat (bijvoorbeeldagent-research-assistant). - App-beschrijving: Een korte beschrijving van wat de agent doet.
- MLflow-experiment: selecteer een bestaand MLflow-experiment dat u wilt gebruiken voor tracering en evaluatie of maak een nieuw experiment.
-
App-naam: Een unieke naam die begint met
Klik op Exporteren. Azure Databricks doet het volgende:
- Valideert of de naam van de app beschikbaar is.
- Installeert het
agent-openai-agents-sdk-sjabloon in uw werkruimte en verleent de app de machtigingen voor de resources die deze nodig heeft. Deze resources omvatten het MLflow-experiment, het leveren van eindpunten en eventuele MCP-servers, Unity Catalog-functies, Genie Agents of vectorzoekindexen die u als hulpprogramma's hebt toegevoegd. - Hiermee wordt
agent_server/agent.pygegenereerd vanuit uw Playground-configuratie, zodat de geïmplementeerde agent overeenkomt met wat u hebt getest.
Wanneer het dialoogvenster voor succes wordt weergegeven, klikt u op Agent weergeven om de geïmplementeerde app te openen en chatten met behulp van de ingebouwde gebruikersinterface.
Als u de agentcode wilt aanpassen, verificatie wilt configureren, evaluatie wilt toevoegen of opnieuw wilt implementeren met Databricks Asset Bundles (DABs), raadpleegt u Een agent ontwerpen en implementeren in Databricks Apps.
Notitieblok voor agents maken (verouderd)
Nadat u de agent in AI Playground hebt getest, klikt u op Code ophalen>Agentnotebook maken om uw agent te exporteren naar een Python-notebook.
Nadat u de agentcode hebt geëxporteerd, slaat Azure Databricks een map met een stuurprogrammanotitieblok op in uw werkruimte. Dit stuurprogramma definieert een tool-aanroepende ResponseAgent, test de agent lokaal, maakt gebruik van logboekregistratie op basis van code, registreert en implementeert de agent met behulp van aangepaste agents.
Opmerking
Het geëxporteerde notebook maakt momenteel gebruik van een verouderd proces voor het maken van agents waarmee de agent wordt uitgerold in Model Serving. Databricks raadt in plaats daarvan het ontwerpen van agents aan met Behulp van Databricks Apps. Zie Een agent ontwerpen en implementeren in Databricks-apps.
Tip
Als je wilt dat Azure Databricks de agent-loop voor je uitvoert, kun je de Supervisor API (Beta) (verouderd) gebruiken in plaats van je eigen API te schrijven. De Supervisor-API ondersteunt Azure Databricks gehoste hulpprogramma's (Unity Catalog-functies, Genie Agents, MCP-servers) en hulpprogramma's aan de clientzijde die worden uitgevoerd in uw toepassingscode. Kies deze optie wanneer u geen aangepaste Python logica nodig hebt tussen aanroepen van hulpprogramma's.
Als u het wilt proberen vanuit uw Playground-configuratie, controleert u of u ten minste één hulpprogramma hebt toegevoegd in stap 2 en klikt u vervolgens op Code>curl-API ophalen. Wanneer de Playground-implementatie hulpprogramma's heeft en een supervisor-compatibel model gebruikt, is de curl een Supervisor-API-aanvraag POST voor /mlflow/v1/responses uw model, prompt en gehoste hulpprogramma's. Voor de optie is ook vereist dat de preview-versie van de Supervisor-API is ingeschakeld. Zie Azure Databricks previews beheren.
Om een Supervisor API-agent te implementeren op Databricks Apps, raadpleeg Een aangepaste agent bouwen met de Supervisor API (Beta) (verouderd).
Volgende stappen
Zie Een agent ontwerpen en implementeren in Databricks-apps om agents te ontwerpen met behulp van een code-first benadering.