Veelgestelde vragen Azure Cognitive Services containers

Algemene vragen

Wat is er beschikbaar?

Azure Cognitive Services-containers kunnen ontwikkelaars gebruikmaken van dezelfde intelligente API's die beschikbaar zijn in Azure, maar met de voordelen van containerisatie. Sommige containers zijn beschikbaar als een gated preview-versie waarvoor een toepassing mogelijk toegang nodig heeft. Andere containers zijn openbaar beschikbaar als een geeerde preview of zijn algemeen beschikbaar. U vindt een volledige lijst met containers en hun beschikbaarheid in het artikel Containerondersteuning in Azure Cognitive Services. U kunt de containers ook weergeven in Docker Hub.

Is er een verschil tussen de Cognitive Services cloud en de containers?

Cognitive Services containers zijn een alternatief voor de Cognitive Services cloud. Containers bieden dezelfde mogelijkheden als de bijbehorende cloudservices. Klanten kunnen de containers on-premises of in Azure implementeren. De belangrijkste AI-technologie, prijslagen, API-sleutels en API-handtekening zijn hetzelfde tussen de container en de bijbehorende cloudservices. Er zijn functies en voordelen voor het kiezen van containers boven hun cloudservice-equivalent.

Hoe kan ik toegang tot een gated preview-container en gebruikt u deze?

Voorheen werden gated preview-containers gehost in de containerpreview.azurecr.io opslagplaats. Vanaf 22 september 2020 worden deze containers gehost op de Microsoft Container Registry. Als u ze downloadt, hoeft u de opdracht niet te docker login gebruiken. U kunt een gated preview-container uitvoeren als uw Azure-resource is gemaakt met de goedgekeurde Azure-abonnements-id. U kunt de container niet uitvoeren als uw Azure-abonnement niet is goedgekeurd nadat het aanvraagformulier is voltooid.

Zijn containers beschikbaar voor alle Cognitive Services producten en wat is de volgende set containers die ik mag verwachten?

We willen graag meer Cognitive Services beschikbaar stellen als containers. Neem contact op met Microsoft-account lokale beheerder voor updates over nieuwe containerreleases en andere Cognitive Services aankondigingen.

Wat wordt de Service Level Agreement (SLA) voor Cognitive Services containers?

Cognitive Services containers hebben geen SLA.

Klanten beheren Cognitive Services containerconfiguraties van resources, zodat Microsoft geen SLA biedt voor algemene beschikbaarheid. Klanten kunnen containers on-premises implementeren en de hostomgevingen definiëren.

Belangrijk

Ga naar onze SLA-pagina voor meer Cognitive Services serviceovereenkomsten voor uw service.

Zijn deze containers beschikbaar in onafhankelijke clouds?

Niet iedereen is bekend met de term soevereine cloud, dus laten we beginnen met de definitie:

De onafhankelijke cloud bestaat uit de Azure Government, Azure Duitslanden Azure China 21Vianet clouds.

Helaas worden Cognitive Services containers niet standaard ondersteund in de onafhankelijke clouds. De containers kunnen worden uitgevoerd in deze clouds, maar ze worden uit de openbare cloud gehaald en moeten gebruiksgegevens verzenden naar het openbare eindpunt.

Versiebeheer

Hoe worden containers bijgewerkt naar de nieuwste versie?

Klanten kunnen kiezen wanneer ze de containers willen bijwerken die ze hebben geïmplementeerd. Containers worden gemarkeerd met standaard Docker-tags zoals om latest de meest recente versie aan te geven. We raden klanten aan om de nieuwste versies van containers op te halen wanneer ze worden uitgebracht. Zie webhooks voor meer informatie over hoe u een melding krijgt wanneer een afbeelding wordt bijgewerkt Azure Container Registry webhooks.

Welke versies worden ondersteund?

De huidige en laatste belangrijke versie van de container wordt ondersteund. We raden klanten echter aan op de hoogte te blijven van de nieuwste technologie.

Hoe worden updates bijgewerkt?

Belangrijke versiewijzigingen geven aan dat er een belangrijke wijziging is in de API-handtekening. We verwachten dat dit doorgaans samenvalt met belangrijke versiewijzigingen in de bijbehorende Cognitive Services cloudaanbieding. Kleine versiewijzigingen wijzen op bugfixes, modelupdates of nieuwe functies die geen belangrijke wijziging aanbrengen in de API-handtekening.

Technische vragen

Hoe kan ik potentiële fouten in mijn implementatieomgeving diagnosticeren?

Als u problemen hebt met het uitvoeren van een Cognitive Services-container, kunt u de diagnosecontainer van Microsoft gebruiken. Gebruik deze container om veelvoorkomende fouten in uw implementatieomgeving vast te stellen die kunnen verhinderen dat Cognitive Services-containers werken zoals verwacht.

Gebruik de volgende Docker pull-opdracht om de container op te halen:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Voer vervolgens de container uit, {ENDPOINT_URI} vervang door uw eindpunt en vervang door uw sleutel voor uw {API_KEY} resource:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

De container test op netwerkverbinding met het facturerings-eindpunt.

Hoe moet ik de Cognitive Services uitvoeren op IoT-apparaten?

Of u nu geen betrouwbare internetverbinding hebt, u wilt besparen op bandbreedtekosten, u hebt lage latentievereisten of u hebt te maken met gevoelige gegevens die on-site moeten worden geanalyseerd. Azure IoT Edge met Cognitive Services-containers biedt u consistentie met de cloud.

Zijn deze containers compatibel met OpenShift?

We testen geen containers met OpenShift, maar over het algemeen moeten Cognitive Services containers worden uitgevoerd op elk platform dat Docker-afbeeldingen ondersteunt. Als u OpenShift gebruikt, raden we u aan om de containers uit te schakelen als root-user .

Hoe kan ik productfeedback en functieaanbevelingen geven?

We raden klanten aan om hun zorgen openbaar te uiten en om stemmen op anderen die hetzelfde hebben gedaan als potentiële problemen overlappen. U kunt het feedbackprogramma gebruiken voor zowel productfeedback als functieaanbevelingen.

Welke statusberichten en fouten retourneren Cognitive Services containers?

Dit zijn de statusberichten en -fouten:

Status Beschrijving
Valid Uw API-sleutel is geldig. Er is geen actie nodig.
Invalid Uw API-sleutel is ongeldig. U moet een geldige API-sleutel verstrekken om de container uit te voeren. Zoek uw API-sleutel en serviceregio in Azure Portal, in de sectie Sleutels en eindpunt voor uw Cognitive Services resource.
Mismatch U hebt een API-sleutel of eindpunt opgegeven voor een ander type Cognitive Services resource. Zoek uw API-sleutel en serviceregio in Azure Portal, in de sectie Sleutels en eindpunt voor uw Cognitive Services resource.
CouldNotConnect De container kan geen verbinding maken met het facturerings-eindpunt. Controleer de Retry-After waarde en wacht tot deze periode is eindigt voordat u meer aanvragen maakt.
OutOfQuota De API-sleutel heeft het quotum overschreden. U kunt uw prijscategorie upgraden of wachten tot er extra quotum beschikbaar is. Zoek uw laag in de Azure Portal, in de sectie Prijscategorie van uw Cognitive Service-resource.
BillingEndpointBusy Het facturerings-eindpunt is momenteel bezet. Controleer de Retry-After waarde en wacht tot deze periode is eindigt voordat u meer aanvragen maakt.
ContainerUseUnauthorized De opgegeven API-sleutel is niet gemachtigd voor gebruik met deze container. U gebruikt waarschijnlijk een gated container, dus zorg ervoor dat uw Azure-abonnements-id is goedgekeurd door een onlineaanvraag in te dienen.
Unknown De server kan momenteel geen factureringsaanvragen verwerken.

Hoe kan ik ondersteuning krijgen?

Klantondersteuningskanalen zijn hetzelfde als voor de Cognitive Services cloud-API's. Alle Cognitive Services containers bevatten logboekregistratiefuncties die ons helpen en klanten van de community ondersteunen. Hier zijn opties voor meer ondersteuning:

Hoe werkt facturering?

Er worden kosten in rekening gebracht op basis van het verbruik, vergelijkbaar met het Cognitive Services cloud. De containers moeten worden geconfigureerd voor het verzenden van meetgegevens naar Azure en transacties worden dienovereenkomstig gefactureerd. Resources die worden gebruikt voor de gehoste en on-premises services, tellen mee voor het enkele quotum met gelaagde prijzen, meegerekend naar beide gebruiksgegevens. Zie de volgende pagina's met prijzen voor meer informatie:

Belangrijk

Cognitive Services containers hebben geen licentie om te worden uitgevoerd zonder dat ze zijn verbonden met Azure voor het meten. Klanten moeten de containers in staat stellen om te allen tijde factureringsgegevens te communiceren met de meetservice. Cognitive Services containers verzenden geen klantgegevens naar Microsoft.

Hier is een voorbeeld van de informatie die een container communiceert voor meting:

"usageRequestBody": {
  "id": "customer_subscriptionID",
  "apiType": "textanalytics",
  "containerType": "keyphrase",
  "containerVersion": "1.1.00864.0001",
  "containerId": "dep--keyphrase-",
  "meter": {
    "name": "CognitiveServices.TextAnalytics.Container.BatchScoring",
    "quantity": 10.0
  }

Wat is de huidige ondersteuningsgarantie voor containers?

Er is geen garantie voor previews. De standaardgarantie van Microsoft voor bedrijfssoftware is van toepassing wanneer containers formeel worden aangekondigd als algemene beschikbaarheid (GA).

Wat gebeurt er met Cognitive Services containers wanneer de internetverbinding verloren gaat?

Cognitive Services containers hebben geen licentie om te worden uitgevoerd zonder dat ze zijn verbonden met Azure voor het meten. Klanten moeten ervoor zorgen dat de containers te allen tijde kunnen communiceren met de meetservice.

Hoe lang kan de container werken zonder verbinding te maken met Azure?

Cognitive Services containers hebben geen licentie om te worden uitgevoerd zonder dat ze zijn verbonden met Azure voor het meten. Klanten moeten ervoor zorgen dat de containers te allen tijde kunnen communiceren met de meetservice.

Welke hardware is vereist om deze containers uit te voeren?

Cognitive Services containers zijn op x64 gebaseerde containers die elk compatibel Linux-knooppunt, VM en edge-apparaat kunnen uitvoeren dat ondersteuning biedt voor x64 Linux Docker-containers. Voor alle processors zijn CPU-processors vereist. U vindt de minimale en aanbevolen configuraties voor elke containeraanbieding op deze pagina's:

Worden deze containers momenteel ondersteund op Windows?

Cognitive Services containers zijn Linux-containers, maar er is enige ondersteuning voor Linux-containers op Windows. Zie de Docker-documentatie voor meer Windows Linux-containers.

Hoe kunnen Cognitive Services containers worden vergeleken met AWS- en Google-aanbiedingen?

Microsoft is de eerste cloudprovider die zijn vooraf getrainde AI-modellen verplaatst naar containers met eenvoudige facturering per transactie alsof klanten een cloudservice gebruiken. Microsoft denkt dat een hybride cloud klanten meer keuze biedt.

Welke nalevingscertificeringen hebben containers?

Cognitive Services containers hebben geen nalevingscertificeringen.

In welke regio'Cognitive Services containers beschikbaar?

Containers kunnen overal in elke regio worden uitgevoerd, maar ze hebben een sleutel nodig en moeten terugroepen naar Azure voor meting. Alle ondersteunde regio's voor de cloudservice worden ondersteund voor de aanroep van de meting van de containers.

Volgende stappen

Laten we doorgaan met het werken met Azure Cognitive Services containers.