Példa: Egyéni Form Recognizer-képesség létrehozása (archiválva)

Ez a példa archiválva van, és nem támogatott. Elmagyarázta, hogyan hozhat létre egyéni Form Recognizer-készséget a C# és a Visual Studio használatával.

Előfeltételek

Visual Studio (bármely kiadás).
Legalább öt azonos típusú forma. Az útmutatóban megadott mintaadatokat használhatja.

Űrlap-felismerő erőforrás létrehozása

Lásd: Űrlap-felismerő erőforrás létrehozása

A modell betanítása

Az Űrlap-felismerő modell betanítására van szükség a bemeneti űrlapjaival, mielőtt használni tudja ezt a funkciót. Az Űrlap-felismerő modellek használata elmagyarázza, hogyan lehet egy modellt betanítani. Használhat mintaadatokat, vagy saját adatokat is megadhat.

A modell betanítása után másolja az azonosító értékét egy biztonságos helyre.

Az egyéni képesség beállítása

Ez az oktatóanyag az AnalyzeForm projektet használja az Azure Search Power Skills GitHub-adattárban. Klónozza ezt az adattárat a helyi gépre, és lépjen a Vision/AnalyzeForm/ webhelyre a projekt eléréséhez. Ezután nyissa meg AnalyzeForm.csproj a Visual Studióban. Ez a projekt létrehoz egy Azure-függvényerőforrást, amely megfelel az egyéni képességi felületnek, és használható az Azure Cognitive Search bővítéséhez. Bemenetként űrlapdokumentumokat használ, és a megadott kulcs-érték párokat (szövegként) adja ki.

Először vegyen fel projektszintű környezeti változókat. Keresse meg az AnalyzeForm projektet a bal oldali panelen, kattintson rá a jobb gombbal, és válassza a Tulajdonságoklehetőséget. A Tulajdonságok ablakban válassza a Hibakeresés lapot, majd keresse meg a Környezeti változók mezőt. Válassza a lehetőséget, majd a hozzáadása gombot a következő változók hozzáadásához:

FORMS_RECOGNIZER_ENDPOINT_URL a végpont URL-jére beállított értékkel.
FORMS_RECOGNIZER_API_KEY az előfizetési kulcsodhoz rendelt értékkel.
FORMS_RECOGNIZER_MODEL_ID az értéket a betanított modell azonosítójára állítva.
FORMS_RECOGNIZER_RETRY_DELAY 1000 értékre van állítva. Ez az érték az az idő ezredmásodpercben, amelyet a program megvár a lekérdezés újrapróbálkozása előtt.
FORMS_RECOGNIZER_MAX_ATTEMPTS 100 értékre van állítva. Ez az érték az a szám, amikor a program lekérdezi a szolgáltatást, miközben sikeres választ próbál kapni.

Ezután nyissa meg a AnalyzeForm.cs, és keresse meg a fieldMappings változót, amely a field-mappings.json fájlra hivatkozik. Ez a fájl (és az arra hivatkozó változó) határozza meg az űrlapokból kinyerni kívánt kulcsok listáját és az egyes kulcsok egyéni címkéjét. A { "Address:", "address" }, { "Invoice For:", "recipient" } értéke például azt jelenti, hogy a szkript csak az észlelt Address: és Invoice For: mezők értékeit menti, és ezeket az értékeket "address" és "recipient"címkével fogja megjelölni.

Végül jegyezze fel a contentType változót. Ez a szkript az URL-cím alapján hivatkozott távoli dokumentumokon futtatja az adott Form Recognizer-modellt, így a tartalomtípus application/json. Ha a helyi fájlokat úgy szeretné elemezni, hogy a bájt adatfolyamokat bele szeretné foglalni a HTTP-kérelmekbe, akkor a contentType-át a fájlhoz megfelelő MIME-típusra kell módosítania.

A függvény tesztelése a Visual Studióból

Miután szerkesztette a projektet, mentse, és állítsa be a AnalyzeForm projektet indítási projektként a Visual Studióban (ha még nincs beállítva). Ezután nyomja le F5 a függvény helyi környezetben való futtatásához. A függvény meghívásához használjon olyan REST-szolgáltatást, mint Postman.

HTTP-kérés

A következő kérést kell megtennie a függvény meghívásához.

POST http://localhost:7071/api/analyze-form

Kérelem tartalma

Kezdés a kérelem törzssablonjával

{
    "values": [
        {
            "recordId": "record1",
            "data": { 
                "formUrl": "<your-form-url>",
                "formSasToken": "<your-sas-token>"
            }
        }
    ]
}

Itt meg kell adnia egy olyan űrlap URL-címét, amely ugyanolyan típusú, mint a betanított űrlapok. Tesztelési célokra használhatja az egyik képzési űrlapot. Ha követte a cURL rövid útmutatóját, az űrlapok egy Azure Blob Storage-fiókban lesznek elhelyezve. Nyissa meg az Azure Storage Explorert, keresse meg az űrlapfájlt, kattintson rá a jobb gombbal, és válassza a Közös hozzáférésű jogosultságkód lekéréselehetőséget. A következő párbeszédpanelen megjelenik egy URL-cím és egy SAS-jogkivonat. Adja meg ezeket a karakterláncokat a kérési törzs "formUrl" és "formSasToken" mezőibe.

Ha olyan távoli dokumentumot szeretne elemezni, amely nem az Azure Blob Storage-ban található, illessze be az URL-címét a "formUrl" mezőbe, és hagyja üresen a "formSasToken" mezőt.

Jegyzet

Ha a képesség integrálva van egy képességkészletbe, az URL-címet és a jogkivonatot a Cognitive Search biztosítja.

Válasz

A következő példához hasonló választ kell látnia:

{
    "values": [
        {
            "recordId": "record1",
            "data": {
                "address": "1111 8th st. Bellevue, WA 99501 ",
                "recipient": "Southridge Video 1060 Main St. Atlanta, GA 65024 "
            },
            "errors": null,
            "warnings": null
        }
    ]
}

A függvény közzététele az Azure-ban

Ha elégedett a függvény viselkedésével, közzéteheti.

A Visual Studio Megoldáskezelőjében kattintson jobb gombbal a projektre, és válassza a Közzétételopciót. Válassza az Új létrehozása>majdközzétételelehetőséget.
Ha még nem csatlakoztatta a Visual Studiót az Azure-fiókjához, válassza a Fiók hozzáadása lehetőséget....
Kövesse a képernyőn megjelenő utasításokat. Adjon meg egy egyedi nevet az app service-nek, az Azure-előfizetésnek, az erőforráscsoportnak, az üzemeltetési csomagnak és a használni kívánt tárfióknak. Ha még nem rendelkezik ezekkel, létrehozhat egy új erőforráscsoportot, egy új üzemeltetési tervet és egy új tárfiókot. Ha végzett, válassza a Létrehozás lehetőséget.
Az üzembe helyezés befejezése után figyelje meg a webhely URL-címét. Ez az URL-cím az Azure-beli függvényalkalmazás címe. Mentse ideiglenes helyre.
Az Azure portálon navigáljon az erőforráscsoporthoz, és keresse meg a közzétett AnalyzeForm függvényt. A Kezelés szakaszban látni kell a gazdagépkulcsokat. Másolja ki a alapértelmezett gazdagépkulcsot, és mentse el egy ideiglenes helyre.

Csatlakozás a csővezetékhez

Ha ezt a képességet egy Cognitive Search-folyamatban szeretné használni, hozzá kell adnia egy képességdefiníciót a képességkészlethez. A következő JSON-blokk egy minta készségdefiníció (frissítenie kell a bemeneteket és kimeneteket, hogy tükrözze az adott forgatókönyvet és készségkészlet-környezetet). Cserélje le a AzureFunctionEndpointUrl-t a függvény URL-címére, és a AzureFunctionDefaultHostKey-et a gazdakulcsra.

{ 
  "description":"Skillset that invokes the Form Recognizer custom skill",
  "skills":[ 
    "[... your existing skills go here]",
    { 
      "@odata.type":"#Microsoft.Skills.Custom.WebApiSkill",
      "name":"formrecognizer",
      "description":"Extracts fields from a form using a pre-trained form recognition model",
      "uri":"[AzureFunctionEndpointUrl]/api/analyze-form?code=[AzureFunctionDefaultHostKey]",
      "httpMethod":"POST",
      "timeout":"PT30S",
      "context":"/document",
      "batchSize":1,
      "inputs":[ 
        { 
          "name":"formUrl",
          "source":"/document/metadata_storage_path"
        },
        { 
          "name":"formSasToken",
          "source":"/document/metadata_storage_sas_token"
        }
      ],
      "outputs":[ 
        { 
          "name":"address",
          "targetName":"address"
        },
        { 
          "name":"recipient",
          "targetName":"recipient"
        }
      ]
    }
  ]
}

Utolsó frissítés időpontja: 2023-02-01