Tekstsamenvatting gebruiken (preview)

In dit artikel leest u hoe u tekstsamenvatting gebruikt met Azure AI Video Indexer. In dit voorbeeld worden azure OpenAI-modelimplementaties gebruikt.

Notitie

Deze functie werkt alleen met een standaardaccount. Maak een standaardaccount.

Vereisten

• Bekijk het overzicht van texuele samenvatting.

Cloud

• Een Azure AI Video Indexer-account dat is verbonden met een Azure OpenAI-account.

• Toegang verleend tot Azure OpenAI in het gewenste Azure abonnement. Op dit moment wordt alleen toegang tot deze service verleend door een aanvraag te doen. U kunt toegang tot Azure OpenAI aanvragen door het formulier in te vullen.

• Een Azure OpenAI gpt-35-turbo- of gpt-4-implementatie . Als u wilt profiteren van samenvattingen op basis van sleutelframes, moet u een Azure Open AI-model selecteren dat visuele invoer accepteert. Lees hier meer: Azure OpenAI Service-modellen.

• Het filter Prompt Shields voor directe aanvallen (jailbreak) moet worden toegevoegd aan de implementatie. Lees hier meer: Inhoudsfilters (preview) gebruiken met De Azure OpenAI-service.

• Het wordt aanbevolen om schadelijke inhoudsfilters te configureren voor categorieën zoals 'Geweld', 'Haat', 'Seksueel' en 'Zelfschade'. Hoewel deze filters niet verplicht zijn, moet u ze instellen op 'Gemiddeld' of 'Laag' om inhoud van ten minste het mediumniveau van schadelijkheid te filteren. Deze instelling zorgt ervoor dat inhoud met een schadelijkheidsclassificatie van gemiddeld of hoger wordt geblokkeerd. Voor meer veiligheid kunt u kiezen voor een strengere instelling. Sla de instellingen voor het inhoudsfilter op nadat deze is geconfigureerd.

• Een video die is geüpload naar uw Azure AI Video Indexer-bibliotheek.

Notitie

Azure AI Video Indexer kan geen verbinding maken met nauwkeurig afgestemde modellen.

Edge

Met Azure AI Video Indexer die is ingeschakeld door Arc, kunt u Azure AI Video Indexer gebruiken op edge-apparaten. Hier volgen de technische vereisten voor deze use-case:

• Video Indexer ingeschakeld door Arc van versienummer 1.1.23 of hoger.
• Hardwarevereisten: GPU of Intel CPU. Het uitvoeren op CPU is mogelijk erg traag en wordt niet aanbevolen. We raden u aan Nvidia V100 of hoger te gebruiken. Als er meerdere GPU-knooppunten zijn, kunt u een knooppuntkiezer toevoegen om het gewenste knooppunt te selecteren.
• Voor het gebruik van keyframes als onderdeel van de samenvatting is Nvidia A100 of hoger vereist.
• Tekstuele videosamenvatting op Edge maakt alleen gebruik van het Phi3.5-model. Raadpleeg de informatie over de officiële release van Phi 3.5 voor meer informatie over hardware.

Webpagina's openen in uw browser

U kunt deze instructies gemakkelijker volgen als u de benodigde webpagina's al hebt geopend. Kopieer en plak de volgende parameters in uw favoriete teksteditor. Hier volgt een lijst om u op weg te helpen:

• VI-account-id:
• videobestand-id:
• implementatienaam:
• toegangstoken:

1. Open Azure Portal in één tabblad of venster en meld u aan.
   1. Navigeer naar de azure AI Video Indexer-accountpagina voor de account-id.
   2. Ga naar de azure OpenAI-accountpagina
      1. Selecteer modelimplementaties in het menu en selecteer vervolgens Implementaties beheren. De Azure OpenAI Studio wordt geopend. Kopieer de implementatienaam die u wilt gebruiken.
2. Open de Azure AI Video Indexer-webportal in een ander tabblad of venster en meld u aan.
   1. Navigeer naar de bibliotheekpagina, kies een video en klik er met de rechtermuisknop op voor de id van het videobestand.
3. Open de Azure AI Video Indexer-API in een ander tabblad of venster en meld u aan.

Web

Een tekstsamenvatting genereren met of zonder sleutelframes

U kunt de Azure AI Video Indexer-webportal gebruiken om tekst samen te vatten.

1. Als u de webportal nog niet hebt geopend, opent u de Azure AI Video Indexer-webportal.
2. Upload een bestand en wacht totdat het is geïndexeerd.
3. Selecteer de video om naar de mediapagina te navigeren.
4. Als u keyframes wilt gebruiken om de samenvatting te produceren, schakelt u het selectievakje Visuele sleutelframeinzichten opnemen in om het overzicht van de kwaliteit te verbeteren.
5. Selecteer Samenvatting genereren. De tekstsamenvatting wordt gegenereerd.

Notitie

Als u de knop Samenvatting genereren niet ziet, gebruikt u mogelijk een proefaccount. Maak een standaardaccount om deze functie te gebruiken.

Samenvattingsaanpassingen

Zodra de samenvatting is gegenereerd, kunt u er aanpassingen aan aanbrengen door de samenvattingsstijl aan te passen of de modelimplementatie te wijzigen.

Samenvattingsstijl aanpassen

U kunt de samenvatting ook aanpassen door het pictogram Samenvatting aanpassen te selecteren. U kunt kiezen uit korte, **gemiddelde of lange samenvattingslengten en u kunt neutraal, casual of formeel kiezen als een samenvattingsstijl. Nadat u uw keuzes hebt gekozen, selecteert u Opnieuw genereren.

Modelimplementatie wijzigen

1. Selecteer het pictogram Samenvatting aanpassen.
2. Selecteer de modelimplementatie die u wilt gebruiken in de vervolgkeuzelijst Modelimplementatie .
3. Selecteer Opnieuw genereren.

Notitie

Houd er rekening mee dat de modelimplementatie een combinatie is van het model en de filters. Bovendien wordt elke keer dat u de tekstsamenvatting aanpast, een API PUT-aanvraag weergegeven.

API

Een videooverzicht maken

Een toegangstoken genereren

Genereer een toegangstoken in Azure Portal:

1. Navigeer naar uw Azure AI Video Indexer-account.
2. Selecteer management en beheer-API in het menu.
3. Selecteer In de vervolgkeuzelijst Machtigingstype Inzender.
4. Selecteer Account in de vervolgkeuzelijst Bereik.
5. Selecteer Genereren. Het toegangstoken wordt gegenereerd.
6. Kopieer het toegangstoken naar het Klembord.

U moet alle parameters hebben die nodig zijn om een videosamenvatting te maken die klaar is voor gebruik in uw teksteditor.

1. Zoek op de azure AI Video Indexer-API-pagina naar samenvatting.
2. Selecteer de knop Uitproberen naast Videosamenvatting maken. Het deelvenster API-parameters wordt geopend.
3. Plak het toegangstoken op het klembord in het veld accessToken .
4. Selecteer de locatie in de vervolgkeuzelijst locatie .
5. Kopieer en plak de VI-account-id in het veld AccountId .
6. Kopieer de id van het videobestand en plak deze in het veld VideoId .
7. Kies de lengte van de samenvatting, gemiddeld, kort of lang in de vervolgkeuzelijst lengte .
8. Kies in de vervolgkeuzelijst stijl de stijl, neutraal, casual of formeel.
9. Selecteer Verzenden.

In het antwoord ziet u een samenvattings-id. Kopieer die id naar het klembord.

Een videooverzicht ophalen

Controleer eerst de samenvattingsstatus. Totdat de samenvattingstaak is voltooid, toont de statuswaarde 'Verwerken', maar er is geen samenvatting in het antwoord. Wanneer de samenvattingstaak is voltooid, wordt de samenvatting weergegeven in het antwoord.

1. Selecteer GET Video Summary.
2. Voer de account-id, de video-id, de samenvattings-id en het toegangstoken in de juiste velden in.
3. Selecteer Verzenden.

Notitie

Er is altijd een disclaimer beschikbaar in het antwoord over de samenvatting. Er is ook een koppeling naar de taakstatus-API in de locatieheader .

Videooverzichten weergeven

U kunt de videosamenvattingen per pagina weergeven. Selecteer GET List Video Samenvattingen en gebruik dezelfde parameters die al zijn beschreven. Als er een grote lijst met samenvattingen is, gebruikt u de paginaparameters om het antwoord op pagina's te retourneren. Gebruik de samenvattings-id voor de GET Video Summary-aanvraag.

Een videooverzicht verwijderen

Het verwijderen van de videosamenvatting is net zo eenvoudig als het selecteren van DEL Video-samenvatting, met dezelfde parameters en het selecteren van Verzenden.

Foutcodes

Aanvraag	Statuscode	Foutbericht	Fouttype	Reden	Oplossing
Create-Video-Summary	400	Account is niet verbonden met Azure OpenAI	INVALID_INPUT		Ga naar Azure Portal en verbind een account.
Create-Video-Summary	400	Er is geen implementatie gevonden met deze naam: {deploymentName}	INVALID_INPUT		Controleer de tekenreeks voor de implementatienaam.
Create-Video-Summary	400	Dit model biedt geen ondersteuning voor het genereren van samenvattingen.	INVALID_INPUT		Een ander model kiezen
Create-Video-Summary	400	Kan geen samenvatting genereren omdat voor het AI-model inhoudsfilters moeten worden toegevoegd om schadelijke inhoud te voorkomen. " + $"Voeg het volgende beleid toe: {string. Join(",", Enum.GetValues<FilterType>(). Where(type => type != FilterType.JailBreak)}." + $"Stel allowedContentLevel in op ten minste {AllowedContentLevel.Medium} voor beide bronnen {FilterSource.Prompt} en {FilterSource.Completion}	SUMMARY_FILTERS_NOT_FOUND		Zie het foutbericht.
Create-Video-Summary	400	Kan de video niet vinden	VIDEO_NOT_FOUND
Create-Video-Summary	400	Video-indexering is nog niet voltooid	VIDEO_ALREADY_IN_PROGRESS
Create-Video-Summary	400	Ongeldige samenvattingslengtewaarde {length}	INVALID_INPUT
Create-Video-Summary	400	Ongeldige waarde voor de samenvattingsstijl {style}	INVALID_INPUT
Get-Video-Summary	200	N.v.t.	N.v.t.
Get-Video-Summary	404	Samenvatting {summaryId} is niet gevonden voor video {videoId}.	NOT_FOUND
Get-Video-Summary	200	Kan geen samenvatting genereren omdat de video-inhoud is gemarkeerd als schadelijk. Zie Inhoudsfilters voor meer informatie	N.v.t.	Alle secties in de video hebben het inhoudsfilter geactiveerd.	Er is geen oplossing voor de specifieke video.
Get-Video-Summary	200	Er is onvoldoende informatie om een samenvatting te genereren.	N.v.t.	De video-inzichten bevatten onvoldoende informatie om prompts voor Azure OpenAI te maken	Als de voorinstelling van de video niet alle modellen bevat, kan het opnieuw indexeren met een geavanceerdere voorinstelling die audio bevat, mogelijk helpen.
Get-Video-Summary	200	Kan Geen Azure OpenAI-implementaties ophalen voor resource {_resourceName}
Get-Video-Summary	200	Implementatie {DeploymentName} bestaat niet
Get-Video-Summary	200	Azure OpenAI kan niet worden bereikt. Probeer de samenvatting later opnieuw uit te voeren.			Probeer de samenvattingstaak later opnieuw uit te voeren.
Create-Video-Summary				Geen roltoewijzing
Get-Video-Summary				Geen roltoewijzing

Probleemoplossing

Voordat u specifieke oplossingen zoekt, moet u ervoor zorgen dat u de resources hebt gemaakt in de sectie Vereisten van het document.

Samenvatting genereren wordt niet weergegeven

Mogelijk hebt u uw Azure OpenAI-account niet correct verbonden met het Azure AI Video Indexer-account.

Kan samenvatting niet genereren

• U moet inhoudsfilters toevoegen aan de implementatie om schadelijke inhoud te voorkomen. Ga terug naar Azure OpenAI Studio en voeg filters toe aan uw implementatie.
• Mogelijk hebt u een missief inhoudsfilter gemaakt voor inhoud met gevoelige of schadelijke inhoud. Het inhoudsfilter moet ten minste Gemiddeld zijn. Als u het inhoudsfilter instelt op Gemiddeld en schadelijk inhoud in de video blijft, wordt het filter geactiveerd. In dit geval is er geen oplossing.
• Mogelijk hebt u niet om een transcriptie gevraagd of zijn er mogelijk onvoldoende gegevens gegenereerd tijdens het indexeringsproces.
• Mogelijk gebruikt u een geavanceerde voorinstelling.
• De video bevat mogelijk onvoldoende audio om een transformatie te maken.

Kan geen modelimplementatie of implementatie gebruiken die ontbreekt

• Mogelijk hebt u geen implementatie gemaakt.
• Iemand heeft het geïmplementeerde model mogelijk gewijzigd of verwijderd.

Beperking

Er kunnen te veel aanvragen naar VI worden verzonden. Wacht enkele minuten en probeer het opnieuw.

U ontvangt de foutmelding 'filter niet gevonden'

Als er een fout met het filter niet is gevonden, krijgt u een gedetailleerde foutmelding waarin wordt beschreven wat er ontbreekt. De fout ziet er ongeveer als volgt uit, maar bevat mogelijk details over andere ontbrekende dingen:

ErrorType":"SUMMARY_FILTERS_NOT_FOUND","Message":"Couldn't generate a summary because the model needs to be set with the right content filters to avoid showing harmful content. Input filter 'Jailbreak' must be enabled with action set to 'Annotate and block'. Trace id: '00000000-0000-0000-0000-000000000000'.

Notitie

Het jailbreakfilter is alleen vereist wanneer u vanaf 1 november 2024 een samenvatting op basis van keyframes of een regelmatig overzicht gebruikt.

Los het jailbreakprobleem op:

1. Selecteer Ga naar Azure Open AI Studio.
2. Selecteer Implementaties.
3. Selecteer de implementatie waarmee u werkt.
4. Selecteer Bewerken.
5. Configureer de filters zodat deze ten minste gemiddeld zijn voor elke categorie.
6. Vraagschilden toepassen voor jailbreakaanvallen.
7. Selecteer Filter maken .

Andere overwegingen

Het is raadzaam om de Azure AI Video Indexer- en Azure OpenAI-accounts in dezelfde regio te maken of om prestatieproblemen te ondervinden.