Quickstart: Multi-turn CLU-modellen met entiteitsveldopvulling

In dit artikel gaat u aan de slag met het bouwen van een CLU-model dat gebruikmaakt van entiteitsslotvulling om gesprekken met meerdere beurten mogelijk te maken. Met deze benadering kan uw model informatie geleidelijk verzamelen in meerdere gesprekken, in plaats van dat gebruikers alle details in één interactie moeten opgeven om taken op natuurlijke en efficiënte wijze uit te voeren.

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.

Opmerking

Sleufvulling met meerdere beurtentiteiten is alleen beschikbaar in Microsoft Foundry (klassiek). In deze quickstart wordt de klassieke portal bij https://ai.azure.com/ gebruikt. Zie Wat is Microsoft Foundry? voor meer informatie over de portals.

Belangrijk

Bij het implementeren en gebruiken van modellen kunnen kosten in rekening worden gebracht in uw Azure-abonnement.

Vereiste voorwaarden

  • Azure-abonnement : als u er nog geen hebt, kunt u er gratis een maken.

  • Vereiste machtigingen : zorg ervoor dat de persoon die het account en project tot stand brengen de rol Eigenaar van het Azure AI-account heeft op abonnementsniveau. De rol van Bijdrager of Cognitive Services-bijdrager op abonnementsniveau voldoet ook aan deze vereiste. Zie Rolgebaseerde toegang tot taalbeheer en Azure-rollen toewijzen voor meer informatie.

  • Azure Language in Foundry Tools-resource - maak een taalresource in de Azure portal.

    Opmerking

    U hebt de rol van eigenaar toegewezen aan de resourcegroep om een taalresource te maken.

  • Microsoft Foundry-project - Een project maken in Foundry. Zie Een Foundry-project maken voor meer informatie.

  • Geïmplementeerd OpenAI-model - Een OpenAI-model implementeren in Foundry, zoals beschreven in de sectie Een OpenAI-model implementeren .

Rollen, machtigingen en instellingen configureren

Begin met het configureren van uw Azure-resources met de juiste rollen en machtigingen.

Rollen toevoegen voor uw taalresource

  1. Navigeer naar de pagina Taalresource in Azure Portal en selecteer Toegangsbeheer (IAM) in het linkernavigatiedeelvenster.

  2. Selecteer Roltoewijzingen toevoegen> enwijs de rol Cognitive Services-taaleigenaar of Cognitive Services-inzender toe voor uw taalresource.

  3. Selecteer onder Toegang toewijzen de optie Gebruiker, groep of service-principal.

  4. Selecteer Leden selecteren.

  5. Kies uw gebruikersnaam in de lijst. U kunt zoeken naar gebruikersnamen in het veld Selecteren . Herhaal deze stap voor alle vereiste rollen.

  6. Herhaal deze stappen voor alle gebruikersaccounts die toegang tot deze resource vereisen.

Azure Language-resource verbinden met Foundry

Als u beveiligde toegang wilt inschakelen, maakt u een verbinding tussen uw taalresource en Foundry. Deze verbinding biedt beveiligd identiteitsbeheer, verificatie en gecontroleerde toegang tot uw gegevens.

Opmerking

De multi-turn functie is momenteel alleen beschikbaar in het Foundry (klassieke) portaal.

Zie Foundry Tools gebruiken in de Foundry-portal voor meer informatie over het verbinden van resources.

  1. Navigeer naar Foundry (klassiek).

  2. Open uw bestaande Foundry-project voor deze zelfstudie.

  3. Selecteer Beheercentrum in het linkernavigatiemenu.

  4. Selecteer Verbonden resources in de sectie Hub van het menu Beheercentrum .

  5. Selecteer + Nieuwe verbinding in het hoofdvenster.

  6. Selecteer Taal in het venster Een verbinding met externe assets toevoegen .

  7. Selecteer Verbinding toevoegen en selecteer Vervolgens Sluiten.

    Schermopname van het verbindingsvenster in Foundry.

Een OpenAI-model implementeren in Foundry Portal

Implementeer een OpenAI-model om de basisinformatie en geavanceerde redeneringsmogelijkheden voor uw CLU-model te bieden.

  1. Selecteer Modellen en eindpunten in de sectie Mijn assets van het navigatiemenu.

    Schermopname van de pagina Modellen en eindpunten in Foundry.

  2. Selecteer + Model implementeren in het hoofdvenster.

  3. Selecteer Basismodel implementeren in de vervolgkeuzelijst.

    Schermopname van het vervolgkeuzemenu Basismodel implementeren in Foundry.

  4. Kies een model in het venster Een model selecteren. Het basismodel gpt-4 wordt aanbevolen voor dit project.

    Schermopname van het selecteren van een modelselectie in Foundry.

  5. Klik op Bevestigen.

  6. Behoud in het venster Deploy gpt-4 de standaardwaarden en selecteer Implementeren.

    Schermopname van het implementatievenster gpt-4 in Foundry.

  7. De modelimplementatie is nu voltooid.

Uw installatie controleren

Voordat u begint met het bouwen van uw multi-turn model, controleert u of aan de afhankelijkheden voor deze quickstart is voldaan.

  • Uw taalresource wordt weergegeven onderVerbonden resources>.
  • Uw OpenAI-implementatie wordt weergegeven onder Modellen en eindpunten.
  • U kunt uw Foundry-project openen in Microsoft Foundry (klassiek).

Een multi-turn model bouwen

Nu uw Taalresource, Foundry-project en OpenAI-implementatie zijn geconfigureerd, kunt u uw CLU-model bouwen.

Uw CLU-project maken

In deze sectie maakt u een reisagentmodel en implementeert u dit met behulp van Quick Deploy.

  1. Navigeer naar Foundry (klassiek).

  2. Als u nog niet bent aangemeld, wordt u in de portal gevraagd om u te verifiëren met uw Azure-referenties.

  3. Zodra u zich hebt aangemeld, maakt of opent u uw bestaande projecten in Foundry.

  4. Als u nog niet in uw project voor deze taak bent, selecteert u deze.

  5. Selecteer In de sectie Overzicht van het linkernavigatiedeelvenster de optie Afstemmen.

  6. Selecteer in het hoofdvenster het tabblad Voor het afstemmen van de AI-service en selecteer vervolgens + Afstemmen.

  7. Kies in het venster Service-afstemming maken het tabblad Gesprekstaalbegrip en selecteer vervolgens Volgende.

  8. Vul in het venster Verfijningsopdracht CLU maken de volgende velden in:

    • Verbonden service : de naam van uw taalserviceresource moet standaard worden weergegeven. Als dat niet het geval is, selecteert u het in het vervolgkeuzemenu.
    • Naam - Geef een naam op voor uw project voor taakafstemming.
    • Taal : Engels is ingesteld als de standaardinstelling en moet al in het veld worden weergegeven.
    • Beschrijving : geef desgewenst een beschrijving op of laat dit veld leeg.
  9. Klik op Creëren. De aanmaakbewerking kan enkele minuten duren. Nadat het is voltooid, verschijnt uw nieuwe CLU-project in de AI Service fine-tuning lijst.

Uw intenties toevoegen

  1. Selecteer Schema definiëren in het menu Aan de slag.

  2. Selecteer Intentie toevoegen in het hoofdvenster.

  3. Het venster Intent toevoegen bevat twee vereiste velden:

    • Naam van intentie (Pascal-hoofdletter)
    • Beschrijving van intentie (vereist voor snelle implementatie)
  4. Nadat u deze velden hebt voltooid, selecteert u + Toevoegen om uw intenties te maken.

  5. Voeg de volgende intenties toe:

    Naam van intentie Beschrijving van intentie
    BookFlight Maak een reisreservering voor een luchtvaartmaatschappijvlucht.
    VluchtTijd De geplande vertrek- en/of aankomsttijd voor een luchtvaartmaatschappij.
    FlightStatus De huidige status van een geplande vlucht.

    Schermopname van de velden Intent toevoegen.

  6. Nadat u alle intenties hebt gedefinieerd, selecteert u Intentie toevoegen.

Uw entiteiten toevoegen

  1. Selecteer het tabblad Entiteiten en selecteer vervolgens Entiteit toevoegen.

  2. Het venster Een entiteit toevoegen bevat twee vereiste velden:

    • Entiteitnaam (Pascal case)
    • Entiteitsbeschrijving
  3. Nadat u de entiteitsvelden hebt voltooid, selecteert u Een entiteit toevoegen.

  4. Voeg de volgende entiteiten toe:

    Naam entiteit Entiteitsbeschrijving
    FlightNumber Vluchtnummer voor geplande vlucht.
    VluchttijdVertrek Vertrektijd voor geplande vlucht.
    Reisdatum Gewenste reisdatum.

    Schermopname van de velden Entiteiten toevoegen.

  5. Voor algemene gegevenstypen voegt u vooraf gedefinieerde entiteitsonderdelen toe:

    • Selecteer uw TravelDate-entiteit :

      • Onder de sectie Vooraf gedefinieerd, selecteer Vooraf samengesteld toevoegen.
      • Selecteer DateTime in de vervolgkeuzelijst en selecteer Toevoegen.
    • Selecteer de entiteit FlightDepartureTime :

      • Onder de sectie Vooraf gedefinieerd, selecteer Vooraf samengesteld toevoegen.
      • Selecteer DateTime in de vervolgkeuzelijst en selecteer Toevoegen.

    Schermopname van de sectie Vooraf gemaakte onderdelen toevoegen.

Uw intenties koppelen aan entiteiten

  1. Selecteer het tabblad Koppelingen .

  2. Selecteer elke intentie en koppel deze aan de vereiste entiteiten in de sectie Beschikbare entiteiten . Deze stap zorgt ervoor dat het model weet welke sleuven voor elke intentie moeten worden ingevuld.

  3. Alle entiteiten moeten een koppeling hebben met ten minste één intentie. Nadat u de koppelingen hebt geconfigureerd, selecteert u Koppelingen bijwerken.

    Intentie Vereniging
    BookFlight Reisdatum
    VluchtTijd VluchVertrektijd, ReizDatum
    FlightStatus Vlachtnummer, Vluchttijd, Reisdatum

Nu alle entiteiten koppelingen hebben, kunt u doorgaan met Quick Deploy met behulp van een LLM (Large Language Model).

Snelle implementatie gebruiken met LLM

  1. Selecteer Model trainen in het menu Aan de slag.

  2. Selecteer in de sectie Uw model trainende optie Snelle implementatie met LLM.

  3. Voltooi de snelle implementatie met llm-venstervelden :

    • Implementatienaam : geef een naam op voor de implementatie.
    • Selecteer Azure OpenAI-modelimplementatie : kies de Azure OpenAI-modelimplementatie die u voor dit project hebt gemaakt.
    • Implementatieregio's : selecteer de regio die is gekoppeld aan uw Azure Language-resource.
  4. Klik op Creëren. Foundry beheert de configuratie- en implementatieprocessen via back-endbewerkingen.

    Nadat de implementatie is voltooid, heeft uw CLU-project een implementatie die u kunt selecteren in de testomgeving.

Uw model testen in de speeltuin

  1. Selecteer Uw model implementeren in het menu Aan de slag.

  2. Selecteer uw model in het hoofdvenster.

  3. Selecteer Uitproberen in speeltuin.

  4. Selecteer in de speeltuin de tegel Conversational Language Understanding .

  5. Controleer in het menu Configuratie aan de linkerkant of de volgende velden juist zijn voltooid:

    • Projectnaam : zorg ervoor dat dit overeenkomt met het project dat u voor deze CLU-taak hebt gemaakt.
    • Implementatienaam : controleer of deze overeenkomt met de naam die u hebt toegewezen aan uw OpenAI-model.
  6. Schakel het selectievakje Meerdere beurten begrijpen in.

  7. Simuleer een dialoogvenster met meerdere paden door het volgende gesprek in te voeren:

    User: Hello, I would like to book a flight.
    Agent: Hello! On which day do you intend to travel?
    User: Tomorrow.
    Agent: What departure time would you prefer for your flight?   
    User: Anytime after 5:00 PM.
    
  8. Selecteer Voeruit.

  9. Het model retourneert een antwoord in zowel Text - als JSON-indelingen .

    Schermopname van het modelantwoord in test- en json-indelingen.

  10. Controleer in het deelvenster Details aan de rechterkant de belangrijkste intentie en gedetecteerde entiteiten.

    Schermopname van het antwoordvenster Details.

U hebt met succes een CLU-model met meerdere keren dialoog gemaakt met mogelijkheden voor het vullen van entiteitsvakken om benodigde informatie gedurende meerdere dialoogbeurten te verzamelen. Zie Gesprekken met meerdere beurten voor meer informatie over hoe CLU entiteitssleuven verwerkt in gesprekswisselingen.

Probleemoplossingsproces

Probleem Oorzaak Resolutie / Besluit
Je ziet de Connected service niet in de stroom voor het maken van een CLU-project. De taalresource is niet verbonden met uw Foundry-hub of u hebt geen toegang. Controleer of de taalresource wordt weergegeven in het beheercentrum bij >, en verifieer vervolgens of u de rol van Cognitive Services Language Owner of Cognitive Services Contributor hebt op de taalresource.
U kunt uw OpenAI-implementatie niet selecteren tijdens snelle implementatie met LLM. Het model wordt niet geïmplementeerd in uw Foundry-project of u hebt geen toegang tot de implementatie. Ga naar Modellen en eindpunten en controleer of de implementatie bestaat. Implementeer het model indien nodig opnieuw en probeer het opnieuw.
Je ziet de multi-turn optie niet in de speeltuin. U gebruikt Microsoft Foundry (klassiek) niet of u zit niet in de juiste CLU-speeltuinervaring. Verzeker uzelf ervan dat u zich op het klassieke portaal bevindt door https://ai.azure.com/, open vervolgens de CLU-speeltuin en selecteer de optie Multi-turn understanding.
Er wordt een autorisatiefout weergegeven bij het verbinden van resources of het implementeren van modellen. Ontbrekende Azure-roltoewijzingen. Controleer uw Azure-roltoewijzingen voor het abonnement en de taalresource. Wacht vervolgens enkele minuten totdat de rol is doorgegeven en probeer het opnieuw.

De hulpbronnen opschonen

Als u het Foundry-project dat voor deze quickstart is gemaakt niet meer nodig hebt, verwijdert u het om doorlopende kosten voor geïmplementeerde modellen te voorkomen.

Als u voor deze quickstart een OpenAI-implementatie hebt gemaakt, verwijdert u eerst de implementatie:

  1. Ga in Microsoft Foundry (klassiek) naar Modellen en eindpunten.
  2. Selecteer de implementatie die u hebt gemaakt.
  3. Selecteer Implementatie verwijderen.

Zie Modellen implementeren in Foundry voor meer informatie.

Het Foundry-project verwijderen:

  1. Ga naar Microsoft Foundry (klassiek).
  2. Selecteer het project dat u wilt verwijderen.
  3. Selecteer Beheercentrum.
  4. Selecteer Project verwijderen.

Als u Azure-resources wilt verwijderen, verwijdert u de afzonderlijke resource of de hele resourcegroep. Als u de resourcegroep verwijdert, worden alle ingesloten resources verwijderd.

Aanbeveling

Als u van plan bent om een resource met modelimplementaties te verwijderen, verwijdert u eerst de implementaties.