Moderování se seznamy vlastních termínů v konzole rozhraní API

Výchozí globální seznam výrazů v Azure Content Moderatoru je dostačující pro většinu potřeb z hlediska moderování obsahu. Možná ale budete potřebovat vyhledat výrazy, které jsou specifické pro vaši organizaci. Například můžete chtít označit názvy konkurentů k další kontrole.

Pomocí rozhraní API pro správu seznamů můžete vytvářet vlastní seznamy termínů pro použití s rozhraním API pro moderování textu. Operace Text – Obrazovka prohledává text pro vulgární výrazy a také porovnává text s vlastními a sdílenými seznamy blokovaných položek.

Poznámka:

Limit je maximálně 5 seznamů výrazů a v každém seznamu může být maximálně 10 000 výrazů.

Rozhraní API pro správu seznamů můžete použít k provedení následujících úloh:

• Vytvoření seznamu
• Přidání výrazů do seznamu
• Porovnání výrazů s výrazy v seznamu
• Odstranění výrazů ze seznamu
• Odstranění seznamu
• Úprava informací o seznamu
• Aktualizace indexu tak, aby změny provedené v seznamu byly součástí nového porovnávání

Použití konzoly rozhraní API

Než budete moct otestovat rozhraní API v online konzole, potřebujete klíč předplatného. Tento klíč se nachází na kartě Nastavení v poli Ocp-Apim-Subscription-Key. Další informace najdete v tématu Přehled.

Aktualizace indexu vyhledávání

Po provedení změn v seznamu termínů je nutné aktualizovat jeho index, aby se změny zahrnuly do budoucích kontrol. Tento krok se podobá tomu, jak vyhledávací web na ploše (pokud je povolený) nebo webový vyhledávací web průběžně aktualizuje svůj index tak, aby zahrnoval nové soubory nebo stránky.

1. V referenčních informacích k rozhraní API pro správu seznamů termínů v nabídce vlevo vyberte Seznamy termínů a pak vyberte Aktualizovat index vyhledávání.

   Otevře se stránka Seznam termínů – Aktualizovat index vyhledávání.

2. Pro testovací konzolu Open API vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola rozhraní API indexu vyhledávání v seznamech termínů .

3. Do pole listId zadejte ID seznamu. Zadejte klíč předplatného a pak vyberte Odeslat.

   

Vytvoření seznamu výrazů

1. Přejděte na referenční informace k rozhraní API pro správu seznamů termínů.

   Otevře se stránka Seznamy termínů – Vytvořit .

2. Pro testovací konzolu Open API vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se seznam termínů – vytvoření konzoly rozhraní API.

3. Do pole Ocp-Apim-Subscription-Key zadejte klíč předplatného.

4. Do pole Text požadavku zadejte hodnoty pro Název (například MyList) a Popis.

   

5. Pomocí zástupných symbolů páru klíč-hodnota přiřaďte k seznamu popisnější metadata.

   {
       "Name": "MyExclusionList",
       "Description": "MyListDescription",
       "Metadata": 
       {
           "Category": "Competitors",
           "Type": "Exclude"
       }
   }
   

   Přidejte metadata seznamu jako páry klíč-hodnota, nikoli skutečné termíny.

6. Vyberte Odeslat. Vytvoří se váš seznam. Poznamenejte si hodnotu ID přidruženou k novému seznamu. Toto ID potřebujete pro další funkce správy seznamů termínů.

   

7. Přidejte termíny do seznamu MyList. V nabídce vlevo v části Termín vyberte Přidat termín.

   Otevře se stránka Termín – Přidat termín .

8. Pro testovací konzolu Open API vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola Rozhraní API pro přidání termínů .

9. Do pole listId zadejte ID seznamu, které jste vygenerovali, a vyberte hodnotu jazyka. Zadejte klíč předplatného a pak vyberte Odeslat.

   

10. Chcete-li ověřit, že byl termín přidán do seznamu, vyberte v nabídce vlevo možnost Termín a pak vyberte Získat všechny podmínky.

    Otevře se konzola rozhraní API Pro získání všech termínů .

11. Do pole listId zadejte ID seznamu a zadejte klíč předplatného. Vyberte Odeslat.

12. V poli Obsah odpovědi ověřte zadané termíny.

    

13. Přidejte několik dalších termínů. Teď, když jste vytvořili vlastní seznam termínů, zkuste zkontrolovat nějaký text pomocí vlastního seznamu termínů.

Odstranění výrazů a seznamů

Odstranění výrazu nebo seznamu je jednoduché. Rozhraní API slouží k provedení následujících úloh:

• Odstranění výrazu. (Termín – Odstranění)
• Odstranění všech výrazů v seznamu bez odstranění seznamu. (Termín – Odstranit všechny termíny)
• Odstranění seznamu a veškerého jeho obsahu. (Seznamy termínů – Odstranit)

Tento příklad odstraní jeden termín.

1. V referenčních informacích k rozhraní API pro správu seznamu termínů vyberte v nabídce vlevo možnost Termín a pak vyberte Odstranit.

   Otevře se termín – odstranění .

2. Pro testovací konzolu Open API vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola rozhraní API pro odstranění termínu.

3. Do pole listId zadejte ID seznamu, ze kterého chcete termín odstranit. Toto ID je číslo (v našem příkladu 122), které se vrátí v seznamech termínů – získat konzolu Podrobností pro seznam MyList. Zadejte termín a vyberte jazyk.

   

4. Zadejte klíč předplatného a pak vyberte Odeslat.

5. Pokud chcete ověřit, že byl termín odstraněn, použijte konzolu Seznamy termínů – Získat vše .

   

Změna informací o seznamu

Můžete upravit název a popis seznamu a přidat položky metadat.

1. V referenčních informacích k rozhraní API pro správu seznamů termínů v nabídce vlevo vyberte Seznamy termínů a pak vyberte Aktualizovat podrobnosti.

   Otevře se stránka Seznam termínů – Aktualizovat podrobnosti .

2. Pro testovací konzolu Open API vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola rozhraní API pro seznam termínů – aktualizovat podrobnosti .

3. Do pole listId zadejte ID seznamu a zadejte klíč předplatného.

4. V poli Text požadavku proveďte úpravy a pak vyberte Odeslat.

   

Další kroky

K integraci s vaší aplikací použijte rozhraní REST API ve svém kódu nebo začněte rychlým startem se seznamem termínů .NET.