التشغيل السريع: تحليل محتوى النص

ابدأ باستخدام Content خزينة ty Studio أو REST API أو client SDKs للقيام باعتدال النص الأساسي. توفر لك خدمة المحتوى الذكاء الاصطناعي Azure خزينة خوارزميات الذكاء الاصطناعي وضع علامة على محتوى غير مقبول. اتبع هذه الخطوات لتجربتها.

إشعار

قد تحتوي عينة البيانات والرمز على محتوى مسيء. ينصح بسلطة المستخدم التقديرية.

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاناً
• بمجرد حصولك على اشتراك Azure، أنشئ مورد Content خزينة ty في مدخل Microsoft Azure للحصول على المفتاح ونقطة النهاية. أدخل اسما فريدا لموردك، وحدد اشتراكك، وحدد مجموعة موارد، والمنطقة المدعومة (راجع توفر المنطقة)، ومستوى التسعير المدعوم. وبعد ذلك، حدد إنشاء.
  • يستغرق المورد بضع دقائق للتوزيع. بعد الانتهاء، حدد go to resource. في الجزء الأيمن، ضمن إدارة الموارد، حدد مفتاح الاشتراك ونقطة النهاية. يتم استخدام نقطة النهاية وأي من المفاتيح لاستدعاء واجهات برمجة التطبيقات.
• cURL مُثبت

تحليل محتوى النص

يستعرض القسم التالي نموذج طلب باستخدام cURL. الصق الأمر أدناه في محرر نص، وقم بإجراء التغييرات التالية.

1. استبدل <endpoint> بعنوان URL لنقطة النهاية المقترنة بالمورد الخاص بك.
2. استبدل <your_subscription_key> بأحد المفاتيح التي تأتي مع المورد الخاص بك.
3. بشكل اختياري، استبدل "text" الحقل في النص الأساسي بالنص الخاص بك الذي تريد تحليله.

   تلميح

   حجم النص ونقاوته

   الحد الأقصى الافتراضي للطول لعمليات إرسال النص هو 10 آلاف حرف.

curl --location --request POST '<endpoint>/contentsafety/text:analyze?api-version=2023-10-01' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "text": "I hate you",
  "categories": [
   "Hate","Sexual","SelfHarm","Violence"
  ]
   "blocklistNames": [
      "string"
    ],
   "haltOnBlocklistHit": true,
   "outputType": "FourSeverityLevels"
}'

يجب تضمين الحقول أدناه في عنوان url:

الاسم	مطلوبة	‏‏الوصف	النوع
إصدار واجهة برمجة التطبيقات	المطلوب	هذا هو إصدار واجهة برمجة التطبيقات المراد التحقق منها. الإصدار الحالي هو: api-version=2023-10-01. مثال: <endpoint>/contentsafety/text:analyze?api-version=2023-10-01	السلسلة‬

يتم تعريف المعلمات في نص الطلب في هذا الجدول:

الاسم	مطلوبة	‏‏الوصف	النوع
text	المطلوب	هذا هو النص الخام المطلوب التحقق منها. يمكن تضمين أحرف أخرى غير ascii.	السلسلة‬
فئات	اختياري	يفترض أن يكون هذا صفيفا من أسماء الفئات. راجع دليل فئات الضرر للحصول على قائمة بأسماء الفئات المتوفرة. إذا لم يتم تحديد أي فئات، يتم استخدام جميع الفئات الأربع. نستخدم فئات متعددة للحصول على درجات في طلب واحد.	السلسلة‬
أسماء قائمة الحظر	اختياري	اسم قائمة حظر النص. دعم الأحرف التالية فقط: 0-9 A-Z a-z - . _ ~. يمكنك إرفاق أسماء قوائم متعددة هنا.	صفيف
haltOnBlocklistHit	اختياري	عند التعيين إلى ، لن يتم إجراء مزيد من التحليلات للمحتوى الضار في الحالات التي يتم فيها الوصول إلى trueقوائم الحظر. عند التعيين إلى ، سيتم إجراء جميع تحليلات المحتوى الضار، سواء تم الوصول إلى falseقوائم الحظر أم لا.	Boolean
نوع الإخراج	اختياري	"FourSeverityLevels" أو "EightSeverityLevels". شدة الإخراج في أربعة أو ثمانية مستويات، يمكن أن تكون 0,2,4,6 القيمة أو 0,1,2,3,4,5,6,7.	السلسلة‬

راجع نموذج نص الطلب التالي:

{
  "text": "I hate you",
  "categories": [
   "Hate","Sexual","SelfHarm","Violence"
  ],
  "blocklistNames": [
    "array"
  ],
  "haltOnBlocklistHit": false,
  "outputType": "FourSeverityLevels"
}

افتح نافذة موجه الأوامر وقم بتشغيل الأمر cURL.

تفسير استجابة واجهة برمجة التطبيقات

يجب أن تشاهد نتائج الإشراف على النص معروضة كبيانات JSON في إخراج وحدة التحكم. على سبيل المثال:

{
  "blocklistsMatch": [
    {
      "blocklistName": "string",
      "blocklistItemId": "string",
      "blocklistItemText": "string"
    }
  ],
  "categoriesAnalysis": [
        {
            "category": "Hate",
            "severity": 2
        },
        {
            "category": "SelfHarm",
            "severity": 0
        },
        {
            "category": "Sexual",
            "severity": 0
        },
        {
            "category": "Violence",
            "severity": 0
  ]
}

يتم تعريف حقول JSON في الإخراج هنا:

Name	‏‏الوصف	النوع
غسيل الفئات	كل فئة إخراج تتوقعها واجهة برمجة التطبيقات. يمكن أن يكون التصنيف متعدد التسميات. على سبيل المثال، عند تشغيل نموذج نص من خلال نموذج الإشراف على النص، يمكن تصنيفه على أنه محتوى جنسي وعنف. فئات الضرر	السلسلة‬
الخطورة	كلما ارتفعت خطورة محتوى الإدخال، كانت هذه القيمة أكبر.	رقم صحيح

الوثائق المرجعية | التعليمات البرمجية لمصدر المكتبة | حزمة (NuGet) | نماذج

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاناً
• تم تمكين Visual Studio IDE مع تطوير سطح مكتب .NET لحمل العمل. أو إذا كنت لا تخطط لاستخدام Visual Studio IDE، فأنت بحاجة إلى الإصدار الحالي من .NET Core.
• بمجرد حصولك على اشتراك Azure، أنشئ مورد Content خزينة ty في مدخل Microsoft Azure للحصول على المفتاح ونقطة النهاية. أدخل اسما فريدا لموردك، وحدد اشتراكك، وحدد مجموعة موارد، والمنطقة المدعومة (راجع توفر المنطقة)، ومستوى التسعير المدعوم. وبعد ذلك، حدد إنشاء.
  • يستغرق المورد بضع دقائق للتوزيع. بعد الانتهاء، حدد go to resource. في الجزء الأيمن، ضمن إدارة الموارد، حدد مفتاح الاشتراك ونقطة النهاية. يتم استخدام نقطة النهاية وأي من المفاتيح لاستدعاء واجهات برمجة التطبيقات.

إعداد التطبيق

إنشاء تطبيق C# جديد.

Visual Studio IDE

افتح Visual Studio، وضمن Get started حدد Create a new project. تعيين عوامل تصفية القالب إلى C#/All Platforms/Console. حدد تطبيق وحدة التحكم (تطبيق سطر الأوامر الذي يمكن تشغيله على .NET على Windows وLinux وmacOS) واختر التالي. قم بتحديث اسم المشروع إلى Content خزينة tyQuickstart واخترNext. حدد .NET 6.0 أو أعلى، واختر إنشاء لإنشاء المشروع.

تثبيت SDK للعميل

بمجرد إنشاء مشروع جديد، قم بتثبيت SDK للعميل بالنقر بزر الماوس الأيمن فوق حل المشروع في مستكشف الحلول وتحديد إدارة حزم NuGet. في مدير الحزمة الذي يفتح، حدد استعراض، وابحث عن Azure.AI.ContentSafety. حدد تثبيت.

المبادره القطريه

في نافذة وحدة تحكم (مثل cmd أو PowerShell أو Bash)، استخدم الأمر ⁧dotnet new⁩ لإنشاء تطبيق وحدة تحكم جديد بالاسم ⁧content-safety-quickstart⁩. هذا الأمر ينشئ مشروع "مرحباً بالعالم" بسيطاً بلغة #C باستخدام ملف مصدر واحد: Program.cs.

dotnet new console -n content-safety-quickstart

غيّر دليلك إلى مجلد التطبيق المنشأ حديثاً. يمكنك إنشاء التطبيق باستخدام:

dotnet build

يجب ألا يحتوي إخراج البناء على تحذيرات أو أخطاء.

...
Build succeeded.
  0 Warning(s)
  0 Error(s)
...

تثبيت SDK للعميل

ضمن دليل التطبيق، قم بتثبيت Computer Vision client SDK ل .NET باستخدام الأمر التالي:

dotnet add package Azure.AI.ContentSafety

إنشاء متغيرات البيئة

في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.

تلميح

لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.

لتعيين متغير البيئة للمفتاح ونقطة النهاية، افتح نافذة وحدة التحكم واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

1. لتعيين CONTENT_SAFETY_KEY متغير البيئة، استبدل YOUR_CONTENT_SAFETY_KEY بأحد مفاتيح المورد الخاص بك.
2. لتعيين CONTENT_SAFETY_ENDPOINT متغير البيئة، استبدل YOUR_CONTENT_SAFETY_ENDPOINT بنقطة النهاية للمورد الخاص بك.

Windows

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستقرأ متغيرات البيئة، بما في ذلك نافذة وحدة التحكم.

Linux

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قم بتشغيل source ~/.bashrc من نافذة وحدة التحكم الخاصة بك لجعل التغييرات فعالة.

تحليل محتوى النص

من دليل المشروع، افتح ملف Program.cs الذي تم إنشاؤه مسبقا. ألصق التعليمات البرمجية الآتية:

using System;
using Azure.AI.ContentSafety;

namespace Azure.AI.ContentSafety.Dotnet.Sample
{
  class ContentSafetySampleAnalyzeText
  {
    public static void AnalyzeText()
    {
      // retrieve the endpoint and key from the environment variables created earlier
      string endpoint = Environment.GetEnvironmentVariable("CONTENT_SAFETY_ENDPOINT");
      string key = Environment.GetEnvironmentVariable("CONTENT_SAFETY_KEY");

      ContentSafetyClient client = new ContentSafetyClient(new Uri(endpoint), new AzureKeyCredential(key));

      string text = "Your input text";

      var request = new AnalyzeTextOptions(text);

      Response<AnalyzeTextResult> response;
      try
      {
          response = client.AnalyzeText(request);
      }
      catch (RequestFailedException ex)
      {
          Console.WriteLine("Analyze text failed.\nStatus code: {0}, Error code: {1}, Error message: {2}", ex.Status, ex.ErrorCode, ex.Message);
          throw;
      }

      Console.WriteLine("\nAnalyze text succeeded:");
      Console.WriteLine("Hate severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.Hate)?.Severity ?? 0);
      Console.WriteLine("SelfHarm severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.SelfHarm)?.Severity ?? 0);
      Console.WriteLine("Sexual severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.Sexual)?.Severity ?? 0);
      Console.WriteLine("Violence severity: {0}", response.Value.CategoriesAnalysis.FirstOrDefault(a => a.Category == TextCategory.Violence)?.Severity ?? 0);

    }
    static void Main()
    {
        AnalyzeText();
    }
  }
}

استبدل "Your input text" بمحتوى النص الذي تريد استخدامه.

تلميح

حجم النص ونقاوته

الحد الأقصى الافتراضي للطول لعمليات إرسال النص هو 10 آلاف حرف.

Visual Studio IDE

قم بإنشاء التطبيق وتشغيله عن طريق تحديد Start Debugging من قائمة Debug في أعلى نافذة IDE (أو اضغط F5).

المبادره القطريه

إنشاء التطبيق وتشغيله من دليل التطبيق الخاص بك باستخدام هذه الأوامر:

dotnet build
dotnet run

نماذج التوثيق المرجعي | التعليمة البرمجية لمصدر المكتبة | حزمة (PyPi) | عينات |

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاناً
• بمجرد حصولك على اشتراك Azure، أنشئ مورد Content خزينة ty في مدخل Microsoft Azure للحصول على المفتاح ونقطة النهاية. أدخل اسما فريدا لموردك، وحدد اشتراكك، وحدد مجموعة موارد، والمنطقة المدعومة (راجع توفر المنطقة)، ومستوى التسعير المدعوم. وبعد ذلك، حدد إنشاء.
  • يستغرق المورد بضع دقائق للتوزيع. بعد الانتهاء، حدد go to resource. في الجزء الأيمن، ضمن إدارة الموارد، حدد مفتاح الاشتراك ونقطة النهاية. يتم استخدام نقطة النهاية وأي من المفاتيح لاستدعاء واجهات برمجة التطبيقات.
• Python 3.x
  • يجب أن يتضمن تثبيت Python خاصتك pip. يمكنك التحقق مما إذا كانت لديك نقطة مثبتة عن طريق تشغيل pip --version على سطر الأوامر. الحصول على نقطة عن طريق تثبيت أحدث إصدار من Python.

إنشاء متغيرات البيئة

في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.

تلميح

لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.

لتعيين متغير البيئة للمفتاح ونقطة النهاية، افتح نافذة وحدة التحكم واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

1. لتعيين CONTENT_SAFETY_KEY متغير البيئة، استبدل YOUR_CONTENT_SAFETY_KEY بأحد مفاتيح المورد الخاص بك.
2. لتعيين CONTENT_SAFETY_ENDPOINT متغير البيئة، استبدل YOUR_CONTENT_SAFETY_ENDPOINT بنقطة النهاية للمورد الخاص بك.

Windows

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستقرأ متغيرات البيئة، بما في ذلك نافذة وحدة التحكم.

Linux

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قم بتشغيل source ~/.bashrc من نافذة وحدة التحكم الخاصة بك لجعل التغييرات فعالة.

تحليل محتوى النص

يستعرض القسم التالي نموذج طلب باستخدام Python SDK.

1. افتح موجه الأوامر، وانتقل إلى مجلد المشروع، وأنشئ ملفا جديدا باسم quickstart.py.

2. قم بتشغيل هذا الأمر لتثبيت مكتبة المحتوى خزينة azure الذكاء الاصطناعي:

   pip install azure-ai-contentsafety
   

3. انسخ التعليمات البرمجية التالية إلى quickstart.py:

   import os
   from azure.ai.contentsafety import ContentSafetyClient
   from azure.core.credentials import AzureKeyCredential
   from azure.core.exceptions import HttpResponseError
   from azure.ai.contentsafety.models import AnalyzeTextOptions, TextCategory
   
   def analyze_text():
       # analyze text
       key = os.environ["CONTENT_SAFETY_KEY"]
       endpoint = os.environ["CONTENT_SAFETY_ENDPOINT"]
   
       # Create an Azure AI Content Safety client
       client = ContentSafetyClient(endpoint, AzureKeyCredential(key))
   
       # Contruct request
       request = AnalyzeTextOptions(text="Your input text")
   
       # Analyze text
       try:
           response = client.analyze_text(request)
       except HttpResponseError as e:
           print("Analyze text failed.")
           if e.error:
               print(f"Error code: {e.error.code}")
               print(f"Error message: {e.error.message}")
               raise
           print(e)
           raise
   
       hate_result = next(item for item in response.categories_analysis if item.category == TextCategory.HATE)
       self_harm_result = next(item for item in response.categories_analysis if item.category == TextCategory.SELF_HARM)
       sexual_result = next(item for item in response.categories_analysis if item.category == TextCategory.SEXUAL)
       violence_result = next(item for item in response.categories_analysis if item.category == TextCategory.VIOLENCE)
   
       if hate_result:
           print(f"Hate severity: {hate_result.severity}")
       if self_harm_result:
           print(f"SelfHarm severity: {self_harm_result.severity}")
       if sexual_result:
           print(f"Sexual severity: {sexual_result.severity}")
       if violence_result:
           print(f"Violence severity: {violence_result.severity}")
   
   if __name__ == "__main__":
       analyze_text()
   

4. استبدل "Your input text" بمحتوى النص الذي تريد استخدامه.

   تلميح

   حجم النص ونقاوته

   الحد الأقصى الافتراضي للطول لعمليات إرسال النص هو 10 آلاف حرف.

5. ثم قم بتشغيل التطبيق باستخدام python الأمر على ملف التشغيل السريع.

   python quickstart.py
   

المرجع | رمز مصدر المكتبة | عينات من برنامج | (Maven)

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاناً
• الإصدار الحالي من Java Development Kit (JDK)
• أداة إنشاء Gradleأو مدير تبعية آخر.
• بمجرد حصولك على اشتراك Azure، أنشئ مورد Content خزينة ty في مدخل Microsoft Azure للحصول على المفتاح ونقطة النهاية. أدخل اسما فريدا لموردك، وحدد اشتراكك، وحدد مجموعة موارد، والمنطقة المدعومة (راجع توفر المنطقة)، ومستوى التسعير المدعوم. وبعد ذلك، حدد إنشاء.
  • يستغرق المورد بضع دقائق للتوزيع. بعد الانتهاء، حدد go to resource. في الجزء الأيمن، ضمن إدارة الموارد، حدد مفتاح الاشتراك ونقطة النهاية. يتم استخدام نقطة النهاية وأي من المفاتيح لاستدعاء واجهات برمجة التطبيقات.

إعداد التطبيق

قم بإنشاء مشروع Gradle جديد.

في إطار نافذة وحدة التحكم (مثل cmd أو PowerShell أو Bash)، يمكنك إنشاء دليل جديد لتطبيقك وانتقل إليه.

mkdir myapp && cd myapp

بادر بتشغيل الأمر gradle init من دليل العمل خاصتك. سينشئ هذا الأمر ملفات بناء أساسية لـ Gradle، بما في ذلك build.gradle.kts، والذي يجري استخدامه في وقت التشغيل لإنشاء تطبيقك وتكوينه.

gradle init --type basic

عند طلب اختيار DSL، حدد Kotlin.

من دليل العمل الخاص بك، قم بتشغيل الأمر التالي لإنشاء مجلد مصدر المشروع:

mkdir -p src/main/java

انتقل إلى المجلد الجديد وأنشئ ملفا يسمى Content خزينة tyQuickstart.java.

تثبيت SDK للعميل

يستخدم هذا التشغيل السريع مدير تبعية Gradle. يمكنك العثور على مكتبة العميل ومعلومات مديري التبعية الآخرين على Maven Central Repository.

حدد build.gradle.kts وافتحه باستخدام IDE أو محرر النص المفضل لديك. ثم انسخ في تكوين البناء التالي. يعرف هذا التكوين المشروع على أنه تطبيق Java الذي نقطة إدخاله هي فئة Content خزينة tyQuickstart. يستورد مكتبة Azure الذكاء الاصطناعي Vision.

plugins {
    java
    application
}
application { 
    mainClass.set("ContentSafetyQuickstart")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.azure", name = "azure-ai-contentsafety", version = "1.0.0")
}

إنشاء متغيرات البيئة

في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.

تلميح

لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.

لتعيين متغير البيئة للمفتاح ونقطة النهاية، افتح نافذة وحدة التحكم واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

1. لتعيين CONTENT_SAFETY_KEY متغير البيئة، استبدل YOUR_CONTENT_SAFETY_KEY بأحد مفاتيح المورد الخاص بك.
2. لتعيين CONTENT_SAFETY_ENDPOINT متغير البيئة، استبدل YOUR_CONTENT_SAFETY_ENDPOINT بنقطة النهاية للمورد الخاص بك.

Windows

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستقرأ متغيرات البيئة، بما في ذلك نافذة وحدة التحكم.

Linux

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قم بتشغيل source ~/.bashrc من نافذة وحدة التحكم الخاصة بك لجعل التغييرات فعالة.

تحليل محتوى النص

افتح Content خزينة tyQuickstart.java في المحرر المفضل لديك أو IDE والصقه في التعليمات البرمجية التالية. استبدل <your text sample> بمحتوى النص الذي تريد استخدامه.

تلميح

حجم النص ونقاوته

الحد الأقصى الافتراضي للطول لعمليات إرسال النص هو 10 آلاف حرف.

import com.azure.ai.contentsafety.ContentSafetyClient;
import com.azure.ai.contentsafety.ContentSafetyClientBuilder;
import com.azure.ai.contentsafety.models.AnalyzeTextOptions;
import com.azure.ai.contentsafety.models.AnalyzeTextResult;
import com.azure.ai.contentsafety.models.TextCategoriesAnalysis;
import com.azure.core.credential.KeyCredential;
import com.azure.core.util.Configuration;


public class ContentSafetyQuickstart {
    public static void main(String[] args) {

        // get endpoint and key from environment variables
        String endpoint = System.getenv("CONTENT_SAFETY_ENDPOINT");
        String key = System.getenv("CONTENT_SAFETY_KEY");
        
        ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder()
            .credential(new KeyCredential(key))
            .endpoint(endpoint).buildClient();

        AnalyzeTextResult response = contentSafetyClient.analyzeText(new AnalyzeTextOptions("<your text sample>"));

        for (TextCategoriesAnalysis result : response.getCategoriesAnalysis()) {
            System.out.println(result.getCategory() + " severity: " + result.getSeverity());
        }
    }
}

انتقل مرة أخرى إلى المجلد الجذر للمشروع، وأنشئ التطبيق باستخدام:

gradle build

ثم، شغله باستخدام أمر gradle run:

gradle run

المخرجات

Hate severity: 0
SelfHarm severity: 0
Sexual severity: 0
Violence severity: 0

الوثائق المرجعية | التعليمات البرمجية لمصدر المكتبة | الحزمة (npm) | النماذج |

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاناً
• الإصدار الحالي من Node.js
• بمجرد حصولك على اشتراك Azure، أنشئ مورد Content خزينة ty في مدخل Microsoft Azure للحصول على المفتاح ونقطة النهاية. أدخل اسما فريدا لموردك، وحدد اشتراكك، وحدد مجموعة موارد، والمنطقة المدعومة (راجع توفر المنطقة)، ومستوى التسعير المدعوم. وبعد ذلك، حدد إنشاء.
  • يستغرق المورد بضع دقائق للتوزيع. بعد الانتهاء، حدد go to resource. في الجزء الأيمن، ضمن إدارة الموارد، حدد مفتاح الاشتراك ونقطة النهاية. يتم استخدام نقطة النهاية وأي من المفاتيح لاستدعاء واجهات برمجة التطبيقات.

إعداد التطبيق

قم بإنشاء تطبيق Node.js جديد. في إطار نافذة وحدة التحكم (مثل cmd أو PowerShell أو Bash)، يمكنك إنشاء دليل جديد لتطبيقك وانتقل إليه.

mkdir myapp && cd myapp

شغّل الأمر npm init لإنشاء تطبيق node باستخدام ملف package.json.

npm init

تثبيت SDK للعميل

تثبيت حزمة npm @azure-rest/ai-content-safety:

npm install @azure-rest/ai-content-safety

قم أيضا بتثبيت الوحدة النمطية dotenv لاستخدام متغيرات البيئة:

npm install dotenv

تحديث ملف تطبيقك package.json باستخدام التبعيات.

إنشاء متغيرات البيئة

في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.

تلميح

لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.

لتعيين متغير البيئة للمفتاح ونقطة النهاية، افتح نافذة وحدة التحكم واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

1. لتعيين CONTENT_SAFETY_KEY متغير البيئة، استبدل YOUR_CONTENT_SAFETY_KEY بأحد مفاتيح المورد الخاص بك.
2. لتعيين CONTENT_SAFETY_ENDPOINT متغير البيئة، استبدل YOUR_CONTENT_SAFETY_ENDPOINT بنقطة النهاية للمورد الخاص بك.

Windows

setx CONTENT_SAFETY_KEY 'YOUR_CONTENT_SAFETY_KEY'

setx CONTENT_SAFETY_ENDPOINT 'YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستقرأ متغيرات البيئة، بما في ذلك نافذة وحدة التحكم.

Linux

export CONTENT_SAFETY_KEY='YOUR_CONTENT_SAFETY_KEY'

export CONTENT_SAFETY_ENDPOINT='YOUR_CONTENT_SAFETY_ENDPOINT'

بعد إضافة متغيرات البيئة، قم بتشغيل source ~/.bashrc من نافذة وحدة التحكم الخاصة بك لجعل التغييرات فعالة.

تحليل محتوى النص

إنشاء ملف جديد في الدليل الخاص بك، index.js. افتحه في المحرر المفضل لديك أو IDE والصقه في التعليمات البرمجية التالية. استبدل <your text sample> بمحتوى النص الذي تريد استخدامه.

تلميح

حجم النص ونقاوته

الحد الأقصى الافتراضي للطول لعمليات إرسال النص هو 10 آلاف حرف.

const ContentSafetyClient = require("@azure-rest/ai-content-safety").default,
  { isUnexpected } = require("@azure-rest/ai-content-safety");
const { AzureKeyCredential } = require("@azure/core-auth");

// Load the .env file if it exists
require("dotenv").config();

async function main() {
    // get endpoint and key from environment variables
    const endpoint = process.env["CONTENT_SAFETY_ENDPOINT"];
    const key = process.env["CONTENT_SAFETY_KEY"];
    
    const credential = new AzureKeyCredential(key);
    const client = ContentSafetyClient(endpoint, credential);
    
    // replace with your own sample text string 
    const text = "<your sample text>";
    const analyzeTextOption = { text: text };
    const analyzeTextParameters = { body: analyzeTextOption };
    
    const result = await client.path("/text:analyze").post(analyzeTextParameters);
    
    if (isUnexpected(result)) {
        throw result;
    }
    
    for (let i = 0; i < result.body.categoriesAnalysis.length; i++) {
    const textCategoriesAnalysisOutput = result.body.categoriesAnalysis[i];
    console.log(
      textCategoriesAnalysisOutput.category,
      " severity: ",
      textCategoriesAnalysisOutput.severity
    );
  }
}

main().catch((err) => {
    console.error("The sample encountered an error:", err);
});

شغّل التطبيق باستخدام الأمر node المُتاح على ملف التشغيل السريع.

node index.js

المخرجات

Hate severity:  0
SelfHarm severity:  0
Sexual severity:  0
Violence severity:  0

تنظيف الموارد

إذا كنت ترغب في تنظيف اشتراك خدمات Azure الذكاء الاصطناعي وإزالته، يمكنك حذف المورد أو مجموعة الموارد. يؤدي حذف مجموعة الموارد إلى حذف أية موارد أخرى مقترنة بها أيضًا.

• المدخل
• Azure CLI

الخطوات التالية

تكوين عوامل التصفية لكل فئة واختبارها على مجموعات البيانات باستخدام Content خزينة ty Studio وتصدير التعليمات البرمجية والنشر.

التشغيل السريع للمحتوى خزينة Ty Studio