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.
Nadat de implementatie is toegevoegd, kunt u een query uitvoeren op de implementatie om entiteiten uit uw tekst te extraheren op basis van het model dat u aan de implementatie hebt toegewezen. U kunt de implementatie programmatisch opvragen met behulp van de voorspellings-API of via de clientbibliotheken (Azure SDK).
Geïmplementeerd model testen
U kunt up-to-datumgegevens over uw projecten ophalen, eventuele benodigde wijzigingen aanbrengen en taken voor projectbeheer efficiënt overzien via De Azure AI Foundry.
Uw geïmplementeerde modellen testen vanuit Language Studio:
Selecteer Implementaties testen in het menu aan de linkerkant.
Selecteer de implementatie die u wilt testen. U kunt alleen modellen testen die zijn toegewezen aan implementaties.
Voor meertalige projecten selecteert u in de vervolgkeuzelijst taal de taal van de tekst die u wilt testen.
Selecteer de implementatie die u wilt opvragen/testen in de vervolgkeuzelijst.
U kunt de tekst invoeren die u wilt indienen bij de aanvraag of een
.txtbestand uploaden dat u wilt gebruiken.Selecteer De test uitvoeren in het bovenste menu.
Op het tabblad Resultaat ziet u de geëxtraheerde entiteiten uit uw tekst en de bijbehorende typen. U kunt het JSON-antwoord ook bekijken op het tabblad JSON .
Een aangepaste NER-taak verzenden
Gebruik deze POST-aanvraag om een tekstclassificatietaak te starten.
{ENDPOINT}/language/analyze-text/jobs?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 | 
{API-VERSION} | 
De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies. | 2022-05-01 | 
Kopteksten
| Sleutel | Weergegeven als | 
|---|---|
| Ocp-Apim-Subscription-Key | Uw sleutel die toegang biedt tot deze API. | 
Hoofdtekst
{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomEntityRecognition",
      "taskName": "Entity Recognition",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}
| Sleutel | Tijdelijke aanduiding | Weergegeven als | Opmerking | 
|---|---|---|---|
displayName | 
{JOB-NAME} | 
Uw taaknaam. | MyJobName | 
documents | 
[{},{}] | Lijst met documenten waarop taken moeten worden uitgevoerd. | [{},{}] | 
id | 
{DOC-ID} | 
Documentnaam of id. | doc1 | 
language | 
{LANGUAGE-CODE} | 
Een tekenreeks die de taalcode voor het document opgeeft. Als deze sleutel niet is opgegeven, wordt door de service uitgegaan van de standaardtaal van het project dat is geselecteerd tijdens het maken van het project. Zie taalondersteuning voor een lijst met ondersteunde taalcodes. | en-us | 
text | 
{DOC-TEXT} | 
Documenteer de taak waarop de taken moeten worden uitgevoerd. | Lorem ipsum dolor sit amet | 
tasks | 
Lijst met taken die we willen uitvoeren. | [] | 
|
taskName | 
CustomEntityRecognition | 
De taaknaam | CustomEntityRecognition | 
parameters | 
Lijst met parameters die aan de taak moeten worden doorgegeven. | ||
project-name | 
{PROJECT-NAME} | 
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | myProject | 
deployment-name | 
{DEPLOYMENT-NAME} | 
De naam van uw implementatie. Deze waarde is hoofdlettergevoelig. | prod | 
Respons
U ontvangt een 202-antwoord dat aangeeft dat uw taak is verzonden. Pak in de antwoordheaders het uitoperation-location.
              operation-location is als volgt opgemaakt:
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
U kunt deze URL gebruiken om de voltooiingsstatus van de taak op te vragen en de resultaten op te halen wanneer de taak is voltooid.
Taakresultaten ophalen
Gebruik de volgende GET-aanvraag om de status/resultaten van de aangepaste entiteitsherkenningstaak op te vragen.
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?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 | 
{API-VERSION} | 
De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies. | 2022-05-01 | 
Kopteksten
| Sleutel | Weergegeven als | 
|---|---|
| Ocp-Apim-Subscription-Key | Uw sleutel die toegang biedt tot deze API. | 
Hoofdtekst van antwoord
Het antwoord is een JSON-document met de volgende parameters
{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxx-xxxxx-xxxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "EntityRecognitionLROResults",
        "taskName": "Recognize Entities",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "entities": [
                {
                  "category": "Event",
                  "confidenceScore": 0.61,
                  "length": 4,
                  "offset": 18,
                  "text": "trip"
                },
                {
                  "category": "Location",
                  "confidenceScore": 0.82,
                  "length": 7,
                  "offset": 26,
                  "subcategory": "GPE",
                  "text": "Seattle"
                },
                {
                  "category": "DateTime",
                  "confidenceScore": 0.8,
                  "length": 9,
                  "offset": 34,
                  "subcategory": "DateRange",
                  "text": "last week"
                }
              ],
              "id": "1",
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}
Eerst moet u uw resourcesleutel en eindpunt ophalen:
Uw sleutel en eindpunt ophalen
Vervolgens hebt u de sleutel en het eindpunt van de resource nodig om uw toepassing te verbinden met de API. Verderop in de quickstart plakt u uw sleutel en eindpunt in de code.
Nadat de taalresource is geïmplementeerd, klikt u onder Volgende stappen op de knop Naar de resource gaan.
Selecteer Sleutels en Eindpunt in het linkerdeelvenster op het scherm voor uw resource. U gebruikt een van uw sleutels en uw eindpunt in de onderstaande stappen.
Download en installeer het clientbibliotheekpakket voor uw gewenste taal:
Taal Versie van het pakket .NET 5.2.0-beta.3 Java 5.2.0-beta.3 JavaScript 6.0.0-beta.1 Python 5.2.0b4 Nadat u de clientbibliotheek hebt geïnstalleerd, gebruikt u de volgende voorbeelden op GitHub om de API aan te roepen.
Zie de volgende referentiedocumentatie voor meer informatie: