Projecten maken in indelingswerkstroom

Met de indelingswerkstroom kunt u projecten maken die uw toepassingen verbinden met:

• Aangepaste Language Understanding
• Vragen beantwoorden
• LUIS

Vereisten

Voordat u de indelingswerkstroom gaat gebruiken, hebt u verschillende dingen nodig:

• Een Azure-abonnement: maak er gratis een.
• Een Azure AI-taalresource

Een taalresource maken

Voordat u de indelingswerkstroom gaat gebruiken, hebt u een Azure AI Language-resource nodig.

Notitie

• U moet een eigenaarsrol hebben toegewezen aan de resourcegroep om een taalresource te maken.
• Als u van plan bent om vragen te beantwoorden, moet u het beantwoorden van vragen inschakelen bij het maken van resources

Een nieuwe resource maken vanuit Azure Portal

1. Ga naar Azure Portal om een nieuwe Azure AI-taalresource te maken.

2. Selecteer Doorgaan om uw resource te maken

3. Maak een taalresource met de volgende details.

   Instantiedetails	Vereiste waarde
   Regio	Een van de ondersteunde regio's.
   Naam	Een naam voor uw taalresource.
   Prijscategorie	Een van de ondersteunde prijscategorieën.

Een nieuwe taalresource maken vanuit Language Studio

Als u zich voor het eerst aanmeldt, ziet u een venster in Language Studio waarmee u een bestaande taalresource kunt kiezen of een nieuwe kunt maken. U kunt ook een resource maken door op het instellingenpictogram in de rechterbovenhoek te klikken, Resources te selecteren en vervolgens op Een nieuwe resource maken te klikken.

Maak een taalresource met de volgende details.

Instantiedetails	Vereiste waarde
Azure-abonnement	Uw Azure-abonnement
Azure-resourcegroep	Uw Azure-resourcegroep
Azure-resourcenaam	De naam van uw Azure-resource
Locatie	Meer informatie over ondersteunde regio's.
Prijscategorie	Meer informatie over ondersteunde prijscategorieën.

Belangrijk

• Zorg ervoor dat u Beheerde identiteit inschakelt wanneer u een taalresource maakt.
• Verantwoordelijke AI-kennisgeving lezen en bevestigen

Aanmelden bij Language Studio

Als u een nieuwe intentie wilt maken, selecteert u de knop +Toevoegen en geeft u eerst uw intentie een naam. U ziet twee opties om verbinding te maken met een project of niet. U kunt verbinding maken met projecten (LUIS, vragen beantwoorden of Conversational Language Understanding) of de optie zonder optie kiezen.

Een indelingswerkstroomproject maken

Zodra u een taalresource hebt gemaakt, maakt u een indelingswerkstroomproject.

Language Studio

1. Zoek in Language Studio de sectie met het label Begrijpen van vragen en gesprekstaal en selecteer Orchestration Workflow.

   

2. Hiermee gaat u naar de projectpagina orchestration-werkstroom. Selecteer Nieuw project maken. Als u een project wilt maken, moet u de volgende details opgeven:

Weergegeven als	Beschrijving
Naam	Een naam voor uw project.
Beschrijving	Optionele projectbeschrijving.
Primaire taal uitingen	De primaire taal van uw project. Uw trainingsgegevens moeten voornamelijk in deze taal staan.

Zodra u klaar bent, selecteert u Volgende en controleert u de details. Selecteer Project maken om het proces te voltooien. U ziet nu het scherm Schema maken in uw project.

REST-API's

Dien een PATCH-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om een nieuw project te maken.

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst

Gebruik de volgende voorbeeld-JSON als hoofdtekst.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
projectName	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	EmailApp
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor de uitingen die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de uitingen.	en-us

Een indelingswerkstroomproject importeren

Language Studio

U kunt een indelingswerkstroomproject op elk gewenst moment exporteren als een JSON-bestand door naar de pagina werkstroomprojecten voor indeling te gaan, een project te selecteren en in het bovenste menu op Exporteren te klikken.

Dat project kan opnieuw wordenimporteerd als een nieuw project. Als u een project met dezelfde naam importeert, worden de gegevens van het project vervangen door de zojuist geïmporteerde projectgegevens.

Als u een project wilt importeren, selecteert u de pijlknop naast Een nieuw project maken en selecteert u Importeren en selecteert u vervolgens het JSON-bestand.

REST-API's

U kunt een indelingswerkstroom-JSON importeren in de service

Verzend een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te importeren.

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst

Notitie

Elke intentie mag slechts van één type zijn (CLU, LUIS en qna)

Gebruik de volgende voorbeeld-JSON als hoofdtekst.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Orchestration",
    "settings": {
      "confidenceThreshold": 0
    },
    "projectName": "{PROJECT-NAME}",
    "description": "Project description",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Orchestration",
    "intents": [
      {
        "category": "string",
        "orchestration": {
          "kind": "luis",
          "luisOrchestration": {
            "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
            "appVersion": "string",
            "slotName": "string"
          },
          "cluOrchestration": {
            "projectName": "string",
            "deploymentName": "string"
          },
          "qnaOrchestration": {
            "projectName": "string"
          }
        }
      }
    ],
    "utterances": [
      {
        "text": "Trying orchestration",
        "language": "{LANGUAGE-CODE}",
        "intent": "string"
      }
    ]
  }
}

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
api-version	{API-VERSION}	De versie van de API die u aanroept. De versie die hier wordt gebruikt, moet dezelfde API-versie in de URL zijn.	2022-03-01-preview
projectName	{PROJECT-NAME}	De naam van uw project. Deze waarde is hoofdlettergevoelig.	EmailApp
language	{LANGUAGE-CODE}	Een tekenreeks die de taalcode opgeeft voor de uitingen die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de uitingen.	en-us

Project exporteren

Language Studio

U kunt een indelingswerkstroomproject op elk gewenst moment exporteren als een JSON-bestand door naar de pagina werkstroomprojecten voor indelingen te gaan, een project te selecteren en op Exporteren te drukken.

REST-API's

U kunt een indelingswerkstroomproject op elk gewenst moment exporteren als een JSON-bestand.

Maak een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te exporteren.

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	EmailApp
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat het is gelukt. Pak de operation-location waarde uit in de antwoordheaders. Deze wordt als volgt opgemaakt:

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

JOB-ID wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. Gebruik deze URL om de geëxporteerde project-JSON op te halen met dezelfde verificatiemethode.

Projectdetails voor indeling ophalen

Language Studio

1. Ga naar de pagina met projectinstellingen in Language Studio.

2. U kunt projectdetails bekijken.

3. Op deze pagina kunt u de projectbeschrijving bijwerken.

4. U kunt uw primaire resourcesleutel ook ophalen van deze pagina.

   

REST-API's

Als u de details van een indelingswerkstroomproject wilt ophalen, dient u een GET-aanvraag in met behulp van de volgende URL en headers. Vervang de tijdelijke aanduidingen door uw eigen waarden.

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst van antwoord

Zodra u de aanvraag hebt verzonden, krijgt u het volgende antwoord.

{
  "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": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration project.",
  "language": "{LANGUAGE-CODE}"
}

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 200 antwoord dat aangeeft dat de aanvraag is geslaagd en de hoofdtekst van het JSON-antwoord met de projectgegevens.

Project verwijderen

Language Studio

Wanneer u uw project niet meer nodig hebt, kunt u uw project verwijderen met Behulp van Language Studio. Selecteer Projecten in het linkernavigatiemenu, selecteer het project dat u wilt verwijderen en selecteer vervolgens Verwijderen in het bovenste menu.

REST-API's

Wanneer u uw project niet meer nodig hebt, kunt u uw project verwijderen met behulp van de API's.

Maak een DELETE-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om een conversationele taalkennisproject te verwijderen.

Aanvraag-URL

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

Tijdelijke aanduiding	Weergegeven als	Opmerking
{ENDPOINT}	Het eindpunt voor het verifiëren van uw API-aanvraag.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	De naam voor uw project. Deze waarde is hoofdlettergevoelig.	myProject
{API-VERSION}	De versie van de API die u aanroept.	2023-04-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel	Weergegeven als
Ocp-Apim-Subscription-Key	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat uw project is verwijderd.

Volgende stappen

Schema bouwen