Skapa ett finjusteringsprojekt

2025-09-15

En clu-finjusteringsuppgift (Conversational Language Understanding) är ett arbetsyteprojekt där du anpassar en språkmodell för att identifiera användaravsikter och extrahera nyckelinformation (entiteter) från användarindata (yttranden). På den här arbetsytan definierar du de avsikter och entiteter som är relevanta för ditt program, märker exempelanvändaryttranden i enlighet med detta och använder dessa etiketterade data för att finjustera modellen. Den här processen skräddarsyr modellen för att bättre förstå de specifika behoven och nyanserna i ditt konversationsprogram. I den här guiden går vi igenom hur du konfigurerar en finjusteringsarbetsyta i Azure AI Foundry eller använder REST-API:et.

Note

Om du redan har en Azure AI Language- eller multitjänstresurs – oavsett om den används på egen hand eller via Language Studio – kan du fortsätta att använda de befintliga språkresurserna i Azure AI Foundry-portalen. Mer information finns i Använda Azure AI-tjänster i Azure AI Foundry-portalen.
I Azure AI Foundry fungerar en finjusterande uppgift som din arbetsyta när du anpassar DIN CLU-modell. Tidigare kallades en finjusteringsaktivitet för ett CLU-projekt. Du kan stöta på båda termerna som används omväxlande i äldre CLU-dokumentation.
Vi rekommenderar starkt att du använder en Azure AI Foundry-resurs i AI Foundry. Du kan dock också följa dessa instruktioner med hjälp av en språkresurs.

Prerequisites

Ett Azure-abonnemang. Om du inte har en kan du skapa en kostnadsfritt.
Nödvändiga behörigheter. Kontrollera att personen som upprättar kontot och projektet har tilldelats rollen som Azure AI-kontoägare på prenumerationsnivå. Alternativt kan du inneha rollen Deltagare eller Cognitive Services-deltagare på prenumerationsnivå. Mer information finns iRollbaserad åtkomstkontroll (RBAC).
En Azure AI Foundry-resurs. Mer information finns iKonfigurera en Azure AI Foundry-resurs. Alternativt kan du använda en Azure AI Language-resurs.
Ett Foundry-projekt som skapats i Azure AI Foundry. Mer information finns iSkapa ett AI Foundry-projekt.

Finjustera en CLU-modell

Om du vill skapa en CLU-finjusteringsmodell konfigurerar du först din miljö och skapar sedan ett finjusteringsprojekt som fungerar som arbetsyta för att anpassa DIN CLU-modell.

Azure AI Foundry
REST-API:er

Gå till Azure AI Foundry.
Om du inte redan är inloggad uppmanar portalen dig att göra det med dina Azure-autentiseringsuppgifter.
När du har loggat in kan du skapa eller komma åt dina befintliga projekt i Azure AI Foundry.
Om du inte redan befinner dig i ditt projekt för den här uppgiften, välj det.
Välj Finjustering i den vänstra navigeringspanelen.
I huvudfönstret väljer du fliken AI-tjänstens finjustering och sedan knappen + Finjustera .
I fönstret Skapa tjänstens finjustering väljer du fliken För att förstå konversationsspråk och väljer sedan Nästa.
I aktivitetsfönstret Skapa CLU-finjustering fyller du i fälten Namn och Språk . Om du planerar att finjustera en modell med det kostnadsfria standardträningsläget väljer du Engelska för språkfältet.
Välj knappen Skapa. Det kan ta några minuter innan skapandeåtgärden har slutförts.
Note
- Standardträning möjliggör snabbare träningstider och snabbare iterationer. men det är bara tillgängligt för engelska.
- Avancerad utbildning omfattar längre utbildningstid och stöds för engelska, andra språk och flerspråkiga projekt.
- Mer information finns iTräningslägen.
När uppgiften har skapats väljer du uppgiften från fönstret för finjustering av AI-tjänsten för att komma igång med finjusteringssidan .

Skicka en PATCH begäran med hjälp av följande URL, rubriker och JSON-brödtext för att skapa ett nytt projekt.

Begärande-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Placeholder	Value	Example
`{ENDPOINT}`	Slutpunkten för att autentisera din API-begäran.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	`myProject`
`{API-VERSION}`	Den version av API:et som du anropar.	`2023-04-01`

Headers

Använd följande rubrik för att autentisera din begäran.

Key	Value
`Ocp-Apim-Subscription-Key`	Nyckeln till resursen. Används för att autentisera dina API-begäranden.
`Content-Type`	`application/merge-patch+json`

Body

Använd följande JSON-exempel som brödtext.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Key	Placeholder	Value	Example
`projectName`	`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	`EmailApp`
`language`	`{LANGUAGE-CODE}`	En sträng som anger språkkoden för de yttranden som används i projektet. Om projektet är ett flerspråkigt projekt väljer du språkkoden för de flesta yttrandena.	`en-us`
`multilingual`	`true`	Ett booleskt värde som gör att du kan ha dokument på flera språk i datauppsättningen. När din modell har distribuerats kan du fråga modellen på valfritt språk som stöds (inte nödvändigtvis i dina träningsdokument). Mer information om flerspråkigt stöd finns i Språkstöd.	`true`

Det var allt! Du kan komma igång med ditt finjusteringsprojekt. Mer information finns iNästa steg.

Visa och hantera projektinformation

Du kan hämta uppdaterad information om dina projekt, göra nödvändiga ändringar och effektivt övervaka projektledningsuppgifter genom Azure AI Foundry- eller REST API-slutpunkterna.

Azure AI Foundry
REST-API:er

Översiktssidan för Azure AI Foundry-projektet visar information om ditt finjusterande aktivitetsprojekt, inklusive dess namn, prenumeration, resursgrupp och anslutna resurser. Du kan också komma åt projektets resurser i Azure-portalen genom att välja Hantera i Azure-portalen på översiktssidan.

På projektets startsida finns information om projektet i avsnittet Projektinformation .
Om du vill visa projektinställningar väljer du Hanteringscenter längst ned i det vänstra navigeringsfönstret och väljer sedan någon av följande flikar:
- Översikt för att visa projektinformation.
- Användare för att hantera användare och roller.
- Modeller + slutpunkter för att hantera distributioner av dina modeller och tjänster.
- Anslutna resurser för att hantera anslutna resurser för projektet.

Du kan komma åt, visa och hantera all projektinformation via REST-API:et.

Om du vill hämta projektinformationen skickar du en GET begäran med hjälp av följande URL och rubriker. Ersätt platshållarvärdena med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Placeholder	Value	Example
`{ENDPOINT}`	Slutpunkten för att autentisera din API-begäran.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	`myProject`
`{API-VERSION}`	Den version av API:et som du anropar.	`2023-04-01`

Headers

Använd följande rubrik för att autentisera din begäran.

Key	Value
`Ocp-Apim-Subscription-Key`	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

Svarstext

När du har skickat begäran får du följande svar:

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation project.",
  "language": "{LANGUAGE-CODE}"
}

När du har skickat din API-begäran får du ett 200 svar som anger att det lyckades och innehåller en JSON-svarstext med projektinformationen.

Importera ett befintligt Azure AI-projekt

Genom att importera konfigurationsfilen kan du ta med dina befintliga inställningar direkt till plattformen, vilket gör det enklare att konfigurera och anpassa din tjänst baserat på dina fördefinierade inställningar.

Azure AI Foundry
REST-API:er

Om du vill importera ett befintligt Azure AI-tjänstprojekt med Azure AI Foundry måste du skapa en anslutning till Azure AI-tjänstresursen i ditt Azure AI Foundry-projekt. Mer information finns iAnsluta Azure AI Services-projekt till Azure AI Foundry

Du kan importera din CLU-config.json-fil med hjälp av REST-API:et

Skicka en POST begäran med hjälp av följande URL, rubriker och JSON-brödtext för att importera projektet.

Begärande-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

Placeholder	Value	Example
`{ENDPOINT}`	Slutpunkten för att autentisera din API-begäran.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt och måste matcha projektnamnet i JSON-filen som du importerar.	`EmailAppDemo`
`{API-VERSION}`	Den version av API:et som du anropar.	`2023-04-01`

Headers

Använd följande rubrik för att autentisera din begäran.

Key	Value
`Ocp-Apim-Subscription-Key`	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

Body

JSON-kroppen som du skickar ser ut som följande exempel. Mer information om JSON-objektet finns i referensdokumentationen.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Key	Placeholder	Value	Example
`{API-VERSION}`	Den version av API:et som du anropar.	`2023-04-01`
`projectName`	`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	`EmailAppDemo`
`language`	`{LANGUAGE-CODE}`	En sträng som anger språkkoden för de yttranden som används i projektet. Om projektet är ett flerspråkigt projekt väljer du språkkoden för de flesta yttrandena.	`en-us`
`multilingual`	`true`	Ett booleskt värde som gör att du kan ha dokument på flera språk i datauppsättningen. När din modell har distribuerats kan du fråga modellen på valfritt språk som stöds, inklusive språk som inte ingår i dina träningsdokument.	`true`
`dataset`	`{DATASET}`	Information om hur du delar upp dina data mellan en test- och träningsuppsättning finns i Märka dina yttranden i AI Foundry. Möjliga värden för det här fältet är `Train` och `Test`.	`Train`

Efter en lyckad begäran innehåller API-svaret en operation-location rubrik med en URL som du kan använda för att kontrollera status för importjobbet. Rubriken är formaterad som i det här exemplet:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

Exportera ett finjusteringsprojekt

När du exporterar konfigurationsfilen kan du spara det aktuella tillståndet för projektets inställningar och struktur, vilket gör det enkelt att säkerhetskopiera eller överföra projektet efter behov.

Azure AI Foundry
REST-API:er

Du kan ladda ned ett finjusteringsprojekt i Azure Foundry som en config.json fil:

Gå till startsidan för projektet.
Längst upp på sidan väljer du projektet i menyfliksområdet till höger.
Välj Ladda ned konfigurationsfil.

Du kan exportera ett CLU-projekt som en config.json fil.

Skapa en POST begäran med hjälp av följande URL, rubriker och JSON-brödtext för att exportera projektet.

Begärande-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Placeholder	Value	Example
`{ENDPOINT}`	Slutpunkten för att autentisera din API-begäran.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	`EmailApp`
`{API-VERSION}`	Den version av API:et som du anropar.	`2023-04-01`

Headers

Använd följande rubrik för att autentisera din begäran.

Key	Value
`Ocp-Apim-Subscription-Key`	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

När du har skickat din API-begäran får du ett 202 svar som anger att det lyckades. Extrahera operation-location-värdet i svarshuvudena. Värdet är formaterat som i det här exemplet:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID används för att identifiera din begäran eftersom den här åtgärden är asynkron. Använd den här URL:en för att hämta det exporterade projektets JSON med hjälp av samma autentiseringsmetod.

Ta bort ett projekt

Om du tar bort ett projekt ser du till att det och alla dess associerade data tas bort permanent från systemet.

Azure AI Foundry
REST-API:er

Om du inte längre behöver projektet kan du ta bort det från Azure AI Foundry.

Gå till startsidan för Azure AI Foundry . Initiera autentiseringsprocessen genom att logga in, såvida du inte redan har slutfört det här steget och sessionen är aktiv.
Välj det projekt som du vill ta bort från Keep building with Azure AI Foundry (Fortsätt att skapa med Azure AI Foundry)
Välj Hanteringscenter.
Välj Ta bort projekt.

Så här tar du bort hubben tillsammans med alla dess projekt:

Gå till fliken Översikt i avsnittet Hubb .
Till höger väljer du Ta bort hubb.
Länken öppnar Azure-portalen där du kan ta bort hubben.

Om projektet inte längre krävs kan du ta bort det med hjälp av REST-API:et. Gå vidare genom att gå till REST-API:et och följa de dokumenterade stegen för borttagning av projekt för att slutföra den här åtgärden.

Skapa en DELETE begäran med hjälp av följande URL, rubriker och JSON-brödtext för att ta bort ett projekt för förståelse av konversationsspråk.

Begärande-URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Placeholder	Value	Example
`{ENDPOINT}`	Slutpunkten för att autentisera din API-begäran.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	`myProject`
`{API-VERSION}`	Den version av API:et som du anropar.	`2023-04-01`

Headers

Använd följande rubrik för att autentisera din begäran.

Key	Value
`Ocp-Apim-Subscription-Key`	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

När du har skickat din API-begäran får du ett 202 svar som anger att projektet lyckades, vilket innebär att projektet har tagits bort.

Nästa steg

När du har skapat din finjusteringsarbetsyta startar du finjusteringsaktiviteten genom att definiera dina avsikter och entiteter och lägga till dem i schemat:

Feedback

Var den här sidan till hjälp?

Dela via

Skapa ett finjusteringsprojekt

Prerequisites

Finjustera en CLU-modell

Visa och hantera projektinformation

Importera ett befintligt Azure AI-projekt

Exportera ett finjusteringsprojekt

Ta bort ett projekt

Nästa steg

Feedback

Ytterligare resurser