Installera och kör formulär igenkännings behållare (tas ur bruk)Install and run Form Recognizer containers (Retiring)

Varning

  • Formulär identifieraren v 1.0-behållaren dras tillbaka.The Form Recognizer v1.0 container is being retired. Den här artikeln är endast för referens.This article is for reference only.
  • Du kan komma åt den senaste versionen av API: et med REST API och SDK.You can access the latest version of the API with the REST API and SDK.

Azure formulär tolken använder Machine Learning-teknik för att identifiera och extrahera nyckel/värde-par och tabeller från formulär.Azure Form Recognizer applies machine learning technology to identify and extract key-value pairs and tables from forms. Den associerar värden och tabell poster med nyckel/värde-par och matar sedan ut strukturerade data som innehåller relationerna i original filen.It associates values and table entries with the key-value pairs and then outputs structured data that includes the relationships in the original file.

För att minska komplexiteten och enkelt integrera en anpassad formulär igenkännings modell i automatiserings processen för arbets flödet eller ett annat program, kan du anropa modellen med hjälp av en enkel REST API.To reduce complexity and easily integrate a custom Form Recognizer model into your workflow automation process or other application, you can call the model by using a simple REST API. Endast fem formulär dokument behövs, så att du kan få resultat snabbt, exakt och skräddarsys efter ditt eget innehåll.Only five form documents are needed, so you can get results quickly, accurately, and tailored to your specific content. Ingen kraftig manuell åtgärd eller omfattande data vetenskaps expertis krävs.No heavy manual intervention or extensive data science expertise is necessary. Och det kräver inte data etiketter eller data anteckningar.And it doesn't require data labeling or data annotation.

FunktionFunction FunktionerFeatures
FormigenkänningForm Recognizer
  • Bearbetar PDF-, PNG-och JPG-filerProcesses PDF, PNG, and JPG files
  • Tågen anpassade modeller med minst fem former av samma layoutTrains custom models with a minimum of five forms of the same layout
  • Extraherar nyckel/värde-par och tabell informationExtracts key-value pairs and table information
  • Använder Identifiera text funktionen Azure Cognitive Services API för visuellt innehåll för att identifiera och extrahera utskriven text från bilder i formulärUses the Azure Cognitive Services Computer Vision API Recognize Text feature to detect and extract printed text from images inside forms
  • Kräver inte anteckningar eller etiketterDoesn't require annotation or labeling
  • Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

    FörutsättningarPrerequisites

    Innan du använder formulär igenkännings behållare måste du uppfylla följande krav:Before you use Form Recognizer containers, you must meet the following prerequisites:

    ObligatoriskRequired SyftePurpose
    Docker-motornDocker Engine Du behöver Docker-motorn installerad på en värddator.You need the Docker Engine installed on a host computer. Docker innehåller paket som konfigurerar Docker-miljön på macOS, Windows och Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. En introduktion till grunderna för Docker och containrar finns i Docker-översikt.For a primer on Docker and container basics, see the Docker overview.

    Docker måste konfigureras för att tillåta att behållarna ansluter till och skicka fakturerings data till Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

    I Windows måste Docker också konfigureras för att stödja Linux-behållare.On Windows, Docker must also be configured to support Linux containers.

    Bekant med DockerFamiliarity with Docker Du bör ha grundläggande kunskaper om Docker-koncept, till exempel register, databaser, behållare och behållar avbildningar samt kunskaper om grundläggande docker kommandon.You should have a basic understanding of Docker concepts, such as registries, repositories, containers, and container images, and knowledge of basic docker commands.
    Azure CLIThe Azure CLI Installera Azure CLI på värden.Install the Azure CLI on your host.
    API för visuellt innehåll resursComputer Vision API resource Om du vill bearbeta skannade dokument och avbildningar behöver du en Visuellt innehåll-resurs.To process scanned documents and images, you need a Computer Vision resource. Du kan komma åt Identifiera text-funktionen antingen som en Azure-resurs (REST API eller SDK) eller en kognitiv-tjänster-Recognizer-text - behållare.You can access the Recognize Text feature as either an Azure resource (the REST API or SDK) or a cognitive-services-recognize-text container. De vanliga fakturerings avgifterna gäller.The usual billing fees apply.

    Skicka både API-nyckeln och slut punkterna för din Visuellt innehåll resurs (Azure-moln eller Cognitive Services-behållare).Pass in both the API key and endpoints for your Computer Vision resource (Azure cloud or Cognitive Services container). Använd den här API-nyckeln och slut punkten som {COMPUTER_VISION_API_KEY} och {COMPUTER_VISION_ENDPOINT_URI}.Use this API key and the endpoint as {COMPUTER_VISION_API_KEY} and {COMPUTER_VISION_ENDPOINT_URI}.

    Om du använder funktionen kognitiv-Services-recognize-text , se till att:If you use the cognitive-services-recognize-text container, make sure that:

    Din Visuellt innehåll nyckel för formulär tolkens behållare är den nyckel som anges i kommandot Visuellt innehåll docker run för filen kognitiv-Services-recognize-text .Your Computer Vision key for the Form Recognizer container is the key specified in the Computer Vision docker run command for the cognitive-services-recognize-text container.
    Din fakturerings slut punkt är behållarens slut punkt (till exempel http://localhost:5000 ).Your billing endpoint is the container's endpoint (for example, http://localhost:5000). Om du använder både Visuellt innehåll container-och formulär igenkännings behållare på samma värd, kan de inte startas både med standard porten 5000.If you use both the Computer Vision container and Form Recognizer container together on the same host, they can't both be started with the default port of 5000.
    Formulär igenkännings resursForm Recognizer resource Om du vill använda dessa behållare måste du ha:To use these containers, you must have:

    En Azure formulär igenkännings resurs för att hämta den associerade API-nyckeln och slut punkts-URI: n.An Azure Form Recognizer resource to get the associated API key and endpoint URI. Båda värdena är tillgängliga på sidorna igenkännings översikt och nycklar för Azure Portal formulär och båda värdena krävs för att starta behållaren.Both values are available on the Azure portal Form Recognizer Overview and Keys pages, and both values are required to start the container.

    {FORM_RECOGNIZER_API_KEY}: en av de två tillgängliga resurs nycklarna på sidan nycklar{FORM_RECOGNIZER_API_KEY}: One of the two available resource keys on the Keys page

    {FORM_RECOGNIZER_ENDPOINT_URI}: slut punkten enligt vad som anges på sidan Översikt{FORM_RECOGNIZER_ENDPOINT_URI}: The endpoint as provided on the Overview page

    Anteckning

    Visuellt innehåll resurs namnet måste vara ett enda ord, utan bindestreck - eller andra specialtecken.The Computer Vision resource name should be a single word, without a hyphen - or any other special characters. Den här begränsningen är på plats för att säkerställa att formulär tolkare och Identifiera text behållar kompatibilitet.This restriction is in place to ensure Form Recognizer and Recognize Text container compatibility.

    Nödvändiga parametrar samlas inGathering required parameters

    Det finns tre primära parametrar för alla Cognitive Services behållare som krävs.There are three primary parameters for all Cognitive Services' containers that are required. Licens avtalet för slutanvändare (EULA) måste vara närvarande med värdet accept .The end-user license agreement (EULA) must be present with a value of accept. Dessutom behövs både en slut punkts-URL och API-nyckel.Additionally, both an Endpoint URL and API Key are needed.

    Slut punkts-URI {COMPUTER_VISION_ENDPOINT_URI} och {FORM_RECOGNIZER_ENDPOINT_URI}Endpoint URI {COMPUTER_VISION_ENDPOINT_URI} and {FORM_RECOGNIZER_ENDPOINT_URI}

    URI-värdet för slut punkten är tillgängligt på sidan Azure Portal Översikt för motsvarande kognitiva tjänst resurs.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Gå till sidan Översikt , Hovra över slut punkten och en Copy to clipboard ikon visas.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Kopiera och använd vid behov.Copy and use where needed.

    Samla in slut punkts-URI för senare användning

    Nycklar {COMPUTER_VISION_API_KEY} och {FORM_RECOGNIZER_API_KEY}Keys {COMPUTER_VISION_API_KEY} and {FORM_RECOGNIZER_API_KEY}

    Den här nyckeln används för att starta behållaren och är tillgänglig på sidan Azure Portals nycklar för motsvarande kognitiva tjänst resurser.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Gå till sidan nycklar och klicka på Copy to clipboard ikonen.Navigate to the Keys page, and click on the Copy to clipboard icon.

    Hämta en av de två nycklarna för senare användning

    Viktigt

    Dessa prenumerations nycklar används för att få åtkomst till ditt kognitiva tjänst-API.These subscription keys are used to access your Cognitive Service API. Dela inte dina nycklar.Do not share your keys. Lagra dem på ett säkert sätt, till exempel med hjälp av Azure Key Vault.Store them securely, for example, using Azure Key Vault. Vi rekommenderar också att du återskapar nycklarna regelbundet.We also recommend regenerating these keys regularly. Endast en nyckel krävs för att göra ett API-anrop.Only one key is necessary to make an API call. När du återskapar den första nyckeln kan du använda den andra nyckeln för fortsatt åtkomst till tjänsten.When regenerating the first key, you can use the second key for continued access to the service.

    VärddatornThe host computer

    Värden är en x64-baserad dator som kör Docker-behållaren.The host is a x64-based computer that runs the Docker container. Det kan vara en dator på din lokala dator eller en Docker-värd tjänst i Azure, till exempel:It can be a computer on your premises or a Docker hosting service in Azure, such as:

    Krav och rekommendationer för behållareContainer requirements and recommendations

    De minsta och rekommenderade processor kärnor och minne som ska allokeras för varje formulär igenkännings behållare beskrivs i följande tabell:The minimum and recommended CPU cores and memory to allocate for each Form Recognizer container are described in the following table:

    ContainerContainer MinimumMinimum RekommenderasRecommended
    FormigenkänningForm Recognizer 2 kärnor, 4 GB minne2 core, 4-GB memory 4 kärnor, 8 GB minne4 core, 8-GB memory
    Identifiera textRecognize Text 1 kärna, 8 GB minne1 core, 8-GB memory 2 kärnor, 8 GB minne2 cores, 8-GB memory
    • Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.Each core must be at least 2.6 gigahertz (GHz) or faster.
    • Core och minne motsvarar --cpus --memory inställningarna och som används som en del av docker run kommandot.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

    Anteckning

    De lägsta och rekommenderade värdena baseras på Docker-gränser och inte värd datorns resurser.The minimum and recommended values are based on Docker limits and not the host machine resources.

    Du behöver både formulär tolken och Identifiera text behållare, Observera att identifiera text containern beskrivs utanför den här artikeln.You will need both the Form Recognizer and Recognize Text containers, please note that the Recognize Text container is detailed outside of this article.

    Tips

    Du kan använda kommandot Docker images för att visa en lista över hämtade behållar avbildningar.You can use the docker images command to list your downloaded container images. Följande kommando visar till exempel ID, lagrings plats och tagg för varje Hämtad behållar avbildning, formaterad som en tabell:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

    docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
    
    IMAGE ID         REPOSITORY                TAG
    <image-id>       <repository-path/name>    <tag-name>
    

    Använda behållarenHow to use the container

    När behållaren är på värddatornanvänder du följande process för att arbeta med behållaren.After the container is on the host computer, use the following process to work with the container.

    1. Kör behållarenmed de fakturerings inställningar som krävs.Run the container, with the required billing settings. Fler exempeldocker run kommandot är tillgängliga.More examples of the docker run command are available.
    2. Fråga behållarens förutsägelse slut punkt.Query the container's prediction endpoint.

    Kör behållaren med kommandot Docker RunRun the container by using the docker run command

    Använd kommandot Docker Run för att köra behållaren.Use the docker run command to run the container. Läs om hur du samlar in obligatoriska parametrar för information om hur du hämtar {COMPUTER_VISION_ENDPOINT_URI} {COMPUTER_VISION_API_KEY} värdena, {FORM_RECOGNIZER_ENDPOINT_URI} och {FORM_RECOGNIZER_API_KEY} .Refer to gathering required parameters for details on how to get the {COMPUTER_VISION_ENDPOINT_URI}, {COMPUTER_VISION_API_KEY}, {FORM_RECOGNIZER_ENDPOINT_URI} and {FORM_RECOGNIZER_API_KEY} values.

    Exempeldocker run kommandot är tillgängliga.Examples of the docker run command are available.

    FormigenkänningForm Recognizer

    Anteckning

    Katalogerna som används --mount i de här exemplen är sökvägar i Windows-katalogen.The directories use for --mount in these examples are Windows directory paths. Om du använder Linux eller macOS ändrar du parametern för din miljö.If you're using Linux or macOS, change the parameter for your environment.

    docker run --rm -it -p 5000:5000 --memory 8g --cpus 2 \
    --mount type=bind,source=c:\input,target=/input  \
    --mount type=bind,source=c:\output,target=/output \
    containerpreview.azurecr.io/microsoft/cognitive-services-form-recognizer \
    Eula=accept \
    Billing={FORM_RECOGNIZER_ENDPOINT_URI} \
    ApiKey={FORM_RECOGNIZER_API_KEY} \
    FormRecognizer:ComputerVisionApiKey={COMPUTER_VISION_API_KEY} \
    FormRecognizer:ComputerVisionEndpointUri={COMPUTER_VISION_ENDPOINT_URI}
    

    Det här kommandot:This command:

    • Kör en formulär tolks behållare från behållar avbildningen.Runs a Form Recognizer container from the container image.
    • Allokerar 2 processor kärnor och 8 GB minne.Allocates 2 CPU cores and 8 gigabytes (GB) of memory.
    • Exponerar TCP-port 5000 och allokerar en pseudo-TTY för behållaren.Exposes TCP port 5000 and allocates a pseudo-TTY for the container.
    • Tar automatiskt bort behållaren när den har avslut ATS.Automatically removes the container after it exits. Behållar avbildningen är fortfarande tillgänglig på värddatorn.The container image is still available on the host computer.
    • Monterar en/input och en/output-volym till behållaren.Mounts an /input and an /output volume to the container.

    Kör flera behållare på samma värdRun multiple containers on the same host

    Om du tänker köra flera behållare med exponerade portar ska du se till att köra varje behållare med en annan exponerad port.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Kör till exempel den första behållaren på port 5000 och den andra behållaren på port 5001.For example, run the first container on port 5000 and the second container on port 5001.

    Du kan ha den här behållaren och en annan Azure Cognitive Services-behållare som körs på värden tillsammans.You can have this container and a different Azure Cognitive Services container running on the HOST together. Du kan också ha flera behållare av samma Cognitive Services-behållare som kör.You also can have multiple containers of the same Cognitive Services container running.

    Kör separata behållare som separata Docker-körnings kommandonRun separate containers as separate docker run commands

    Använd följande två exempel på Docker CLI-kommandon för formulär igenkännings-och text igenkännings kombinationen som finns lokalt på samma värd:For the Form Recognizer and Text Recognizer combination that's hosted locally on the same host, use the following two example Docker CLI commands:

    Kör den första behållaren på port 5000.Run the first container on port 5000.

    docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
    --mount type=bind,source=c:\input,target=/input  \
    --mount type=bind,source=c:\output,target=/output \
    containerpreview.azurecr.io/microsoft/cognitive-services-form-recognizer \
    Eula=accept \
    Billing={FORM_RECOGNIZER_ENDPOINT_URI} \
    ApiKey={FORM_RECOGNIZER_API_KEY}
    FormRecognizer:ComputerVisionApiKey={COMPUTER_VISION_API_KEY} \
    FormRecognizer:ComputerVisionEndpointUri={COMPUTER_VISION_ENDPOINT_URI}
    

    Kör den andra behållaren på port 5001.Run the second container on port 5001.

    docker run --rm -it -p 5001:5000 --memory 4g --cpus 1 \
    containerpreview.azurecr.io/microsoft/cognitive-services-recognize-text \
    Eula=accept \
    Billing={COMPUTER_VISION_ENDPOINT_URI} \
    ApiKey={COMPUTER_VISION_API_KEY}
    

    Varje efterföljande behållare bör finnas på en annan port.Each subsequent container should be on a different port.

    Kör separata behållare med Docker ComposeRun separate containers with Docker Compose

    För formulär tolken och text igenkännings kombinationen som finns lokalt på samma värd, se följande exempel Docker Compose YAML-fil.For the Form Recognizer and Text Recognizer combination that's hosted locally on the same host, see the following example Docker Compose YAML file. Text tolken {COMPUTER_VISION_API_KEY} måste vara densamma för både formrecognizer ocr behållaren och.The Text Recognizer {COMPUTER_VISION_API_KEY} must be the same for both the formrecognizer and ocr containers. {COMPUTER_VISION_ENDPOINT_URI}Används endast i ocr behållaren, eftersom formrecognizer behållaren använder ocr namnet och porten.The {COMPUTER_VISION_ENDPOINT_URI} is used only in the ocr container, because the formrecognizer container uses the ocr name and port.

    version: '3.3'
    services:   
      ocr:
        image: "containerpreview.azurecr.io/microsoft/cognitive-services-recognize-text"
        deploy:
          resources:
            limits:
              cpus: '2'
              memory: 8g
            reservations:
              cpus: '1'
              memory: 4g
        environment:
          eula: accept
          billing: "{COMPUTER_VISION_ENDPOINT_URI}"
          apikey: "{COMPUTER_VISION_API_KEY}"
    
      formrecognizer:
        image: "containerpreview.azurecr.io/microsoft/cognitive-services-form-recognizer"
        deploy:
          resources:
            limits:
              cpus: '2'
              memory: 8g
            reservations:
              cpus: '1'
              memory: 4g
        environment:
          eula: accept
          billing: "{FORM_RECOGNIZER_ENDPOINT_URI}"
          apikey: "{FORM_RECOGNIZER_API_KEY}"
          FormRecognizer__ComputerVisionApiKey: {COMPUTER_VISION_API_KEY}
          FormRecognizer__ComputerVisionEndpointUri: "http://ocr:5000"
          FormRecognizer__SyncProcessTaskCancelLimitInSecs: 75
        links:
          - ocr
        volumes:
          - type: bind
            source: c:\output
            target: /output
          - type: bind
            source: c:\input
            target: /input
        ports:
          - "5000:5000"
    

    Viktigt

    Eula, Billing , Och ApiKey , samt FormRecognizer:ComputerVisionApiKey FormRecognizer:ComputerVisionEndpointUri alternativen och måste anges för att köra behållaren, annars startar inte behållaren.The Eula, Billing, and ApiKey, as well as the FormRecognizer:ComputerVisionApiKey and FormRecognizer:ComputerVisionEndpointUri options, must be specified to run the container; otherwise, the container won't start. Mer information finns i fakturering.For more information, see Billing.

    Köra frågor mot containerns förutsägelseslutpunktQuery the container's prediction endpoint

    ContainerContainer SlutpunktEndpoint
    formulär-tolkform-recognizer http://localhost:5000

    FormigenkänningForm Recognizer

    Behållaren innehåller WebSocket-baserade frågor om slut punkts-API: er som du kommer åt via dokumentation för formulär igenkännings tjänstens SDK.The container provides websocket-based query endpoint APIs, which you access through Form Recognizer services SDK documentation.

    Som standard använder formulär igenkännings-SDK onlinetjänster.By default, the Form Recognizer SDK uses the online services. Om du vill använda behållaren måste du ändra initierings metoden.To use the container, you need to change the initialization method. Se exemplen nedan.See the examples below.

    För C #For C#

    Ändra från att använda det här Azure-moln initierings anropet:Change from using this Azure-cloud initialization call:

    var config =
        FormRecognizerConfig.FromSubscription(
            "YourSubscriptionKey",
            "YourServiceRegion");
    

    till det här anropet, som använder behållarens slut punkt:to this call, which uses the container endpoint:

    var config =
        FormRecognizerConfig.FromEndpoint(
            "ws://localhost:5000/formrecognizer/v1.0-preview/custom",
            "YourSubscriptionKey");
    

    För pythonFor Python

    Ändra från att använda det här Azure-moln initierings anropet:Change from using this Azure-cloud initialization call:

    formrecognizer_config =
        formrecognizersdk.FormRecognizerConfig(
            subscription=formrecognizer_key, region=service_region)
    

    till det här anropet, som använder behållarens slut punkt:to this call, which uses the container endpoint:

    formrecognizer_config = 
        formrecognizersdk.FormRecognizerConfig(
            subscription=formrecognizer_key,
            endpoint="ws://localhost:5000/formrecognizer/v1.0-preview/custom"
    

    FormigenkänningForm Recognizer

    Behållaren innehåller API: er för REST-slutpunkt, som du hittar på referens sidan [Forms igenkännings-API] https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-1-preview-3/operations/AnalyzeWithCustomForm) .The container provides REST endpoint APIs, which you can find on the [Form Recognizer API]https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v2-1-preview-3/operations/AnalyzeWithCustomForm) reference page.

    Verifiera att en behållare körsValidate that a container is running

    Det finns flera sätt att verifiera att behållaren körs.There are several ways to validate that the container is running. Leta reda på den externa IP- adressen och den exponerade porten för den aktuella behållaren och öppna din favorit webbläsare.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Använd de olika URL: erna för begäran nedan för att verifiera att behållaren körs.Use the various request URLs below to validate the container is running. URL: erna för exempel begär Anden som anges nedan är http://localhost:5000 , men din speciella behållare kan variera.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tänk på att du är beroende av behållarens externa IP -adress och exponerad port.Keep in mind that you're to rely on your container's External IP address and exposed port.

    URL för begäranRequest URL SyftePurpose
    http://localhost:5000/ Containern tillhandahåller en startsida.The container provides a home page.
    http://localhost:5000/ready Begärd med GET, detta ger en verifiering av att behållaren är redo att acceptera en fråga mot modellen.Requested with GET, this provides a verification that the container is ready to accept a query against the model. Den här begäran kan användas för Kubernetes Live och beredskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/status Begärd med GET, kontrollerar detta om den API-nyckel som används för att starta behållaren är giltig utan att orsaka en slut punkts fråga.Also requested with GET, this verifies if the api-key used to start the container is valid without causing an endpoint query. Den här begäran kan användas för Kubernetes Live och beredskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
    http://localhost:5000/swagger Containern tillhandahåller en fullständig uppsättning dokumentation för slutpunkterna samt en Prova-funktion.The container provides a full set of documentation for the endpoints and a Try it out feature. Med den här funktionen kan du ange dina inställningar i ett webbaserat HTML-formulär och göra frågan utan att behöva skriva någon kod.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. När frågan returnerar visas ett exempel på ett spiral kommando som visar de HTTP-rubriker och det text format som krävs.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

    Behållarens start sida

    Stoppa containernStop the container

    Om du vill stänga av behållaren går du till kommando rads miljön där behållaren körs och väljer CTRL + C.To shut down the container, in the command-line environment where the container is running, select Ctrl+C.

    FelsökningTroubleshooting

    Om du kör behållaren med en utgående montering och loggning aktive rad genererar behållaren loggfiler som är till hjälp vid fel sökning av problem som inträffar när du startar eller kör behållaren.If you run the container with an output mount and logging enabled, the container generates log files that are helpful to troubleshoot issues that happen while starting or running the container.

    Tips

    Mer felsöknings information och vägledning finns i Cognitive Services behållare vanliga frågor och svar.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

    FaktureringBilling

    Formulär identifierarens behållare skickar fakturerings information till Azure med hjälp av en formulär igenkännings resurs på ditt Azure-konto.The Form Recognizer containers send billing information to Azure by using a Form Recognizer resource on your Azure account.

    Frågor till behållaren debiteras enligt pris nivån för den Azure-resurs som används för ApiKey .Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

    Azure Cognitive Services-behållare är inte licensierade för att köras utan att vara anslutna till avläsnings-/fakturerings slut punkten.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. Du måste göra det möjligt för behållarna att kommunicera fakturerings information med fakturerings slut punkten hela tiden.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services behållare skickar inte kund information, till exempel den bild eller text som analyseras, till Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

    Anslut till AzureConnect to Azure

    Containern behöver de fakturerings argument värden som ska köras.The container needs the billing argument values to run. Dessa värden tillåter att behållaren ansluter till fakturerings slut punkten.These values allow the container to connect to the billing endpoint. Behållar rapporteringen visar var 10 till 15: e minut.The container reports usage about every 10 to 15 minutes. Om behållaren inte ansluter till Azure inom den tillåtna tids perioden fortsätter behållaren att köras men hanterar inte frågor förrän fakturerings slut punkten återställs.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Anslutnings försöket görs 10 gånger med samma tidsintervall 10 till 15 minuter.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Om den inte kan ansluta till fakturerings slut punkten inom 10 försök slutar behållaren att betjäna begär Anden.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests. Se vanliga frågor och svar om Cognitive Services container för att få ett exempel på den information som skickas till Microsoft för fakturering.See the Cognitive Services container FAQ for an example of the information sent to Microsoft for billing.

    Fakturerings argumentBilling arguments

    docker run Kommandot startar behållaren när alla tre av följande alternativ finns med giltiga värden :The docker run command will start the container when all three of the following options are provided with valid values:

    AlternativOption BeskrivningDescription
    ApiKey API-nyckeln för den Cognitive Services resurs som används för att spåra fakturerings information.The API key of the Cognitive Services resource that's used to track billing information.
    Värdet för det här alternativet måste anges till en API-nyckel för den etablerade resurs som anges i Billing .The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
    Billing Slut punkten för den Cognitive Services resursen som används för att spåra fakturerings information.The endpoint of the Cognitive Services resource that's used to track billing information.
    Värdet för det här alternativet måste anges till slut punkts-URI för en etablerad Azure-resurs.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
    Eula Anger att du har accepterat licensen för behållaren.Indicates that you accepted the license for the container.
    Värdet för det här alternativet måste vara inställt på acceptera.The value of this option must be set to accept.

    Mer information om dessa alternativ finns i Configure containers.For more information about these options, see Configure containers.

    SammanfattningSummary

    I den här artikeln har du lärt dig begrepp och arbets flöde för att ladda ned, installera och köra formulär igenkännings behållare.In this article, you learned concepts and workflow for downloading, installing, and running Form Recognizer containers. Sammanfattningsvis:In summary:

    • Formulär tolken innehåller en Linux-behållare för Docker.Form Recognizer provides one Linux container for Docker.
    • Behållar avbildningar laddas ned från det privata behållar registret i Azure.Container images are downloaded from the private container registry in Azure.
    • Behållar avbildningar körs i Docker.Container images run in Docker.
    • Du kan använda antingen REST API eller REST SDK för att anropa åtgärder i formulär igenkännings behållare genom att ange behållarens värd-URI.You can use either the REST API or the REST SDK to call operations in Form Recognizer container by specifying the host URI of the container.
    • Du måste ange fakturerings information när du instansierar en behållare.You must specify the billing information when you instantiate a container.

    Viktigt

    Cognitive Services behållare är inte licensierade att köras utan att vara anslutna till Azure för mätning.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Kunderna behöver göra det möjligt för behållarna att kommunicera fakturerings information med mät tjänsten hela tiden.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services behållare skickar inte kund information (till exempel den bild eller text som analyseras) till Microsoft.Cognitive Services containers do not send customer data (for example, the image or text that is being analyzed) to Microsoft.

    Nästa stegNext steps