التشغيل السريع: الكشف عن الكيانات المسماة (NER)
الوثائق | المرجعية مزيد من نماذج حزمة (NuGet) | التعليمات | البرمجية المصدر للمكتبة
استخدم هذا التشغيل السريع لإنشاء تطبيق التعرف على الكيانات المسماة (NER) مع مكتبة العميل لـ .NET. في المثال التالي، ستقوم بإنشاء تطبيق #C يمكنه تحديد الكيانات المعروفة في النص.
تلميح
يمكنك استخدام Language Studio لتجربة ميزات خدمة Language دون الحاجة إلى كتابة التعليمات البرمجية.
المتطلبات الأساسية
- اشتراك Azure - إنشاء اشتراك مجانًا
- Visual Studio IDE
الإعداد
أنشئ مورد Azure.
لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.
استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.
في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.
في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:
تفاصيل الوصف الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة. مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة. المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة. الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات. مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.
حدد Review + Create في أسفل الصفحة.
في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.
الحصول على المفتاح ونقطة النهاية
بعد ذلك ستحتاج إلى المفتاح ونقطة النهاية من المورد لتوصيل التطبيق الخاص بك بواجهة برمجة التطبيقات. ستقوم بلصق المفتاح ونقطة النهاية في التعليمة البرمجية لاحقاً في التشغيل السريع.
بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.
على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.
إنشاء متغيرات البيئة
يجب مصادقة التطبيق الخاص بك لإرسال طلبات واجهة برمجة التطبيقات. وللإنتاج، استخدم طريقة آمنة لتخزين بيانات الاعتماد والوصول إليها. في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.
تلميح
لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.
لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.
- لتعيين
LANGUAGE_KEY
متغير البيئة، استبدلyour-key
بأحد مفاتيح المورد الخاص بك. - لتعيين
LANGUAGE_ENDPOINT
متغير البيئة، استبدلyour-endpoint
بنقطة النهاية للمورد الخاص بك.
setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint
إشعار
إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set
بدلا من setx
.
بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.
إنشاء تطبيق .NET Core جديد
باستخدام Visual Studio IDE، قم بإنشاء تطبيق وحدة تحكم .NET Core جديد. يؤدي هذا إلى إنشاء مشروع "مرحبًا بالعالم" مع ملف مصدر C# واحد: program.cs.
تثبيت مكتبة العميل بالنقر بزر الماوس الأيمن فوق الحل في "Solution Explorer" وتحديد "Manage NuGet Packages". في إدارة الحزمة التي تفتح، حدد "Browse" وابحث عن Azure.AI.TextAnalytics
. حدد الإصدار 5.2.0
، ثم حدد Install. يمكنك أيضاً استخدام Package Manager Console.
مثال على التعليمات البرمجية
انسخ التعليمات البرمجية التالية في ملف program.cs الخاص بك وقم بتشغيل التعليمات البرمجية.
using Azure;
using System;
using Azure.AI.TextAnalytics;
namespace Example
{
class Program
{
// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
static string languageKey = Environment.GetEnvironmentVariable("LANGUAGE_KEY");
static string languageEndpoint = Environment.GetEnvironmentVariable("LANGUAGE_ENDPOINT");
private static readonly AzureKeyCredential credentials = new AzureKeyCredential(languageKey);
private static readonly Uri endpoint = new Uri(languageEndpoint);
// Example method for extracting named entities from text
static void EntityRecognitionExample(TextAnalyticsClient client)
{
var response = client.RecognizeEntities("I had a wonderful trip to Seattle last week.");
Console.WriteLine("Named Entities:");
foreach (var entity in response.Value)
{
Console.WriteLine($"\tText: {entity.Text},\tCategory: {entity.Category},\tSub-Category: {entity.SubCategory}");
Console.WriteLine($"\t\tScore: {entity.ConfidenceScore:F2},\tLength: {entity.Length},\tOffset: {entity.Offset}\n");
}
}
static void Main(string[] args)
{
var client = new TextAnalyticsClient(endpoint, credentials);
EntityRecognitionExample(client);
Console.Write("Press any key to exit.");
Console.ReadKey();
}
}
}
المخرجات
Named Entities:
Text: trip, Category: Event, Sub-Category:
Score: 0.74, Length: 4, Offset: 18
Text: Seattle, Category: Location, Sub-Category: GPE
Score: 1.00, Length: 7, Offset: 26
Text: last week, Category: DateTime, Sub-Category: DateRange
Score: 0.80, Length: 9, Offset: 34
الوثائق | المرجعية مزيد من نماذج حزمة (Maven) | التعليمات | البرمجية المصدر للمكتبة
استخدم هذا التشغيل السريع لإنشاء تطبيق Named Entity Recognition (NER) مع مكتبة العميل لـ Java. في المثال التالي، ستقوم بإنشاء تطبيق Java يمكنه تحديد الكيانات المعروفة في النص.
المتطلبات الأساسية
- اشتراك Azure - إنشاء اشتراك مجانًا
- Java Development Kit (SDK) الإصدار 8 أو أعلى.
الإعداد
أنشئ مورد Azure.
لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.
استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.
في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.
في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:
تفاصيل الوصف الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة. مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة. المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة. الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات. مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.
حدد Review + Create في أسفل الصفحة.
في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.
الحصول على المفتاح ونقطة النهاية
بعد ذلك ستحتاج إلى المفتاح ونقطة النهاية من المورد لتوصيل التطبيق الخاص بك بواجهة برمجة التطبيقات. ستقوم بلصق المفتاح ونقطة النهاية في التعليمة البرمجية لاحقاً في التشغيل السريع.
بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.
على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.
إنشاء متغيرات البيئة
يجب مصادقة التطبيق الخاص بك لإرسال طلبات واجهة برمجة التطبيقات. وللإنتاج، استخدم طريقة آمنة لتخزين بيانات الاعتماد والوصول إليها. في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.
تلميح
لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.
لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.
- لتعيين
LANGUAGE_KEY
متغير البيئة، استبدلyour-key
بأحد مفاتيح المورد الخاص بك. - لتعيين
LANGUAGE_ENDPOINT
متغير البيئة، استبدلyour-endpoint
بنقطة النهاية للمورد الخاص بك.
setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint
إشعار
إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set
بدلا من setx
.
بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.
إضافة مكتبة العميل
إنشاء مشروع Maven في IDE أو بيئة التطوير المفضلة لديك. ثم أضف التبعية التالية إلى ملف pom.xml الخاص بمشروعك. يمكنك العثور على بنية التنفيذ لأدوات البناء الأخرى عبر الإنترنت.
<dependencies>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-textanalytics</artifactId>
<version>5.2.0</version>
</dependency>
</dependencies>
مثال على التعليمات البرمجية
إنشاء ملف Java باسم Example.java
. افتح الملف وانسخ التعليمات البرمجية أدناه. ثم قم بتشغيل التعليمة البرمجية.
import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;
public class Example {
// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
private static String languageKey = System.getenv("LANGUAGE_KEY");
private static String languageEndpoint = System.getenv("LANGUAGE_ENDPOINT");
public static void main(String[] args) {
TextAnalyticsClient client = authenticateClient(languageKey, languageEndpoint);
recognizeEntitiesExample(client);
}
// Method to authenticate the client object with your key and endpoint
static TextAnalyticsClient authenticateClient(String key, String endpoint) {
return new TextAnalyticsClientBuilder()
.credential(new AzureKeyCredential(key))
.endpoint(endpoint)
.buildClient();
}
// Example method for recognizing entities in text
static void recognizeEntitiesExample(TextAnalyticsClient client)
{
// The text that needs to be analyzed.
String text = "I had a wonderful trip to Seattle last week.";
for (CategorizedEntity entity : client.recognizeEntities(text)) {
System.out.printf(
"Recognized entity: %s, entity category: %s, entity sub-category: %s, score: %s, offset: %s, length: %s.%n",
entity.getText(),
entity.getCategory(),
entity.getSubcategory(),
entity.getConfidenceScore(),
entity.getOffset(),
entity.getLength());
}
}
}
المخرجات
Recognized entity: trip, entity category: Event, entity sub-category: null, score: 0.74, offset: 18, length: 4.
Recognized entity: Seattle, entity category: Location, entity sub-category: GPE, score: 1.0, offset: 26, length: 7.
Recognized entity: last week, entity category: DateTime, entity sub-category: DateRange, score: 0.8, offset: 34, length: 9.
الوثائق | المرجعية مزيد من نماذج حزمة (npm) | مكتبة التعليمات | البرمجية المصدر
استخدم هذا التشغيل السريع لإنشاء تطبيق التعرف على الكيانات المسماة (NER) مع مكتبة العميل لـ Node.js. في المثال التالي، يمكنك إنشاء تطبيق JavaScript يمكنه تحديد الكيانات المعترف بها في النص.
المتطلبات الأساسية
- اشتراك Azure - إنشاء اشتراك مجانًا
- Node.js v14 LTS أو أحدث
الإعداد
أنشئ مورد Azure.
لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.
استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.
في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.
في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:
تفاصيل الوصف الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة. مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة. المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة. الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات. مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.
حدد Review + Create في أسفل الصفحة.
في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.
الحصول على المفتاح ونقطة النهاية
بعد ذلك ستحتاج إلى المفتاح ونقطة النهاية من المورد لتوصيل التطبيق الخاص بك بواجهة برمجة التطبيقات. ستقوم بلصق المفتاح ونقطة النهاية في التعليمة البرمجية لاحقاً في التشغيل السريع.
بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.
على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.
إنشاء متغيرات البيئة
يجب مصادقة التطبيق الخاص بك لإرسال طلبات واجهة برمجة التطبيقات. وللإنتاج، استخدم طريقة آمنة لتخزين بيانات الاعتماد والوصول إليها. في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.
تلميح
لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.
لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.
- لتعيين
LANGUAGE_KEY
متغير البيئة، استبدلyour-key
بأحد مفاتيح المورد الخاص بك. - لتعيين
LANGUAGE_ENDPOINT
متغير البيئة، استبدلyour-endpoint
بنقطة النهاية للمورد الخاص بك.
setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint
إشعار
إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set
بدلا من setx
.
بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.
إنشاء تطبيق Node.js جديد
في إطار نافذة وحدة التحكم (مثل cmd أو PowerShell أو Bash)، يمكنك إنشاء دليل جديد لتطبيقك وانتقل إليه.
mkdir myapp
cd myapp
شغّل الأمر npm init
لإنشاء تطبيق node باستخدام ملف package.json
.
npm init
تثبيت مكتبة العميل
تثبيت حزمة npm :
npm install @azure/ai-language-text
مثال على التعليمات البرمجية
افتح الملف وانسخ التعليمات البرمجية أدناه. ثم قم بتشغيل التعليمة البرمجية.
"use strict";
const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");
// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
const key = process.env.LANGUAGE_KEY;
const endpoint = process.env.LANGUAGE_ENDPOINT;
//an example document for entity recognition
const documents = [ "Microsoft was founded by Bill Gates and Paul Allen on April 4, 1975, to develop and sell BASIC interpreters for the Altair 8800"];
//example of how to use the client library to recognize entities in a document.
async function main() {
console.log("== NER sample ==");
const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
const results = await client.analyze("EntityRecognition", documents);
for (const result of results) {
console.log(`- Document ${result.id}`);
if (!result.error) {
console.log("\tRecognized Entities:");
for (const entity of result.entities) {
console.log(`\t- Entity ${entity.text} of type ${entity.category}`);
}
} else console.error("\tError:", result.error);
}
}
//call the main function
main().catch((err) => {
console.error("The sample encountered an error:", err);
});
المخرجات
Document ID: 0
Name: Microsoft Category: Organization Subcategory: N/A
Score: 0.29
Name: Bill Gates Category: Person Subcategory: N/A
Score: 0.78
Name: Paul Allen Category: Person Subcategory: N/A
Score: 0.82
Name: April 4, 1975 Category: DateTime Subcategory: Date
Score: 0.8
Name: 8800 Category: Quantity Subcategory: Number
Score: 0.8
Document ID: 1
Name: 21 Category: Quantity Subcategory: Number
Score: 0.8
Name: Seattle Category: Location Subcategory: GPE
Score: 0.25
الوثائق | المرجعية المزيد من نماذج حزمة (PyPi) | التعليمات | البرمجية المصدر للمكتبة
استخدم هذا التشغيل السريع لإنشاء تطبيق التعرف على الكيانات المسماة (NER) باستخدام مكتبة العميل الخاصة بـ Python. في المثال التالي، يمكنك إنشاء تطبيق Python يمكنه تحديد الكيانات المعترف بها في النص.
المتطلبات الأساسية
- اشتراك Azure - إنشاء اشتراك مجانًا
- Python 3.8 أو أحدث
الإعداد
تثبيت مكتبة العميل
بعد تثبيت Python، يمكنك تثبيت مكتبة العميل عن طريق:
pip install azure-ai-textanalytics==5.2.0
مثال على التعليمات البرمجية
إنشاء ملف Python جديد ونسخ التعليمات البرمجية أدناه. ثم قم بتشغيل التعليمة البرمجية.
# This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
language_key = os.environ.get('LANGUAGE_KEY')
language_endpoint = os.environ.get('LANGUAGE_ENDPOINT')
from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential
# Authenticate the client using your key and endpoint
def authenticate_client():
ta_credential = AzureKeyCredential(language_key)
text_analytics_client = TextAnalyticsClient(
endpoint=language_endpoint,
credential=ta_credential)
return text_analytics_client
client = authenticate_client()
# Example function for recognizing entities from text
def entity_recognition_example(client):
try:
documents = ["I had a wonderful trip to Seattle last week."]
result = client.recognize_entities(documents = documents)[0]
print("Named Entities:\n")
for entity in result.entities:
print("\tText: \t", entity.text, "\tCategory: \t", entity.category, "\tSubCategory: \t", entity.subcategory,
"\n\tConfidence Score: \t", round(entity.confidence_score, 2), "\tLength: \t", entity.length, "\tOffset: \t", entity.offset, "\n")
except Exception as err:
print("Encountered exception. {}".format(err))
entity_recognition_example(client)
المخرجات
Named Entities:
Text: trip Category: Event SubCategory: None
Confidence Score: 0.74 Length: 4 Offset: 18
Text: Seattle Category: Location SubCategory: GPE
Confidence Score: 1.0 Length: 7 Offset: 26
Text: last week Category: DateTime SubCategory: DateRange
Confidence Score: 0.8 Length: 9 Offset: 34
استخدم هذا التشغيل السريع لإرسال طلبات التعرف على الكيانات المسماة (NER) باستخدام واجهة برمجة تطبيقات REST. في المثال التالي، ستستخدم cURL لتحديد الكيانات المعترف بها في النص.
المتطلبات الأساسية
- اشتراك Azure - إنشاء اشتراك مجانًا
الإعداد
أنشئ مورد Azure.
لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.
استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.
في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.
في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:
تفاصيل الوصف الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة. مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة. المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة. الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات. مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.
حدد Review + Create في أسفل الصفحة.
في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.
الحصول على المفتاح ونقطة النهاية
بعد ذلك ستحتاج إلى المفتاح ونقطة النهاية من المورد لتوصيل التطبيق الخاص بك بواجهة برمجة التطبيقات. ستقوم بلصق المفتاح ونقطة النهاية في التعليمة البرمجية لاحقاً في التشغيل السريع.
بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.
على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.
إنشاء متغيرات البيئة
يجب مصادقة التطبيق الخاص بك لإرسال طلبات واجهة برمجة التطبيقات. وللإنتاج، استخدم طريقة آمنة لتخزين بيانات الاعتماد والوصول إليها. في هذا المثال، ستكتب بيانات الاعتماد الخاصة بك إلى متغيرات البيئة على الجهاز المحلي الذي يقوم بتشغيل التطبيق.
تلميح
لا تقم بتضمين المفتاح مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام. راجع مقالة أمان خدمات Azure الذكاء الاصطناعي لمزيد من خيارات المصادقة مثل Azure Key Vault.
لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.
- لتعيين
LANGUAGE_KEY
متغير البيئة، استبدلyour-key
بأحد مفاتيح المورد الخاص بك. - لتعيين
LANGUAGE_ENDPOINT
متغير البيئة، استبدلyour-endpoint
بنقطة النهاية للمورد الخاص بك.
setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint
إشعار
إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set
بدلا من setx
.
بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.
إنشاء ملف JSON مع مثال نص الطلب
في محرر التعليمات البرمجية، أنشئ ملفا جديدا باسم test_ner_payload.json
وانسخ مثال JSON التالي. سيتم إرسال طلب المثال هذا إلى واجهة برمجة التطبيقات في الخطوة التالية.
{
"kind": "EntityRecognition",
"parameters": {
"modelVersion": "latest"
},
"analysisInput":{
"documents":[
{
"id":"1",
"language": "en",
"text": "I had a wonderful trip to Seattle last week."
}
]
}
}
احفظ test_ner_payload.json
في مكان ما على الكمبيوتر. على سبيل المثال، سطح المكتب الخاص بك.
إرسال طلب واجهة برمجة تطبيقات التعرف على الكيان المسمى
استخدم الأوامر التالية لإرسال طلب واجهة برمجة التطبيقات باستخدام البرنامج الذي تستخدمه. انسخ الأمر إلى المحطة الطرفية الخاصة بك، وقم بتشغيله.
المعلمة | الوصف |
---|---|
-X POST <endpoint> |
تحديد نقطة النهاية للوصول إلى واجهة برمجة التطبيقات. |
-H Content-Type: application/json |
نوع المحتوى لإرسال بيانات JSON. |
-H "Ocp-Apim-Subscription-Key:<key> |
تحديد مفتاح الوصول إلى واجهة برمجة التطبيقات. |
-d <documents> |
يحتوي JSON على المستندات التي تريد إرسالها. |
استبدل C:\Users\<myaccount>\Desktop\test_ner_payload.json
بموقع ملف طلب JSON المثال الذي أنشأته في الخطوة السابقة.
موجه الأمر
curl -X POST "%LANGUAGE_ENDPOINT%/language/:analyze-text?api-version=2022-05-01" ^
-H "Content-Type: application/json" ^
-H "Ocp-Apim-Subscription-Key: %LANGUAGE_KEY%" ^
-d "@C:\Users\<myaccount>\Desktop\test_ner_payload.json"
PowerShell
curl.exe -X POST $env:LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2022-05-01 `
-H "Content-Type: application/json" `
-H "Ocp-Apim-Subscription-Key: $env:LANGUAGE_KEY" `
-d "@C:\Users\<myaccount>\Desktop\test_ner_payload.json"
استجابة JSON
إشعار
{
"kind": "EntityRecognitionResults",
"results": {
"documents": [{
"id": "1",
"entities": [{
"text": "trip",
"category": "Event",
"offset": 18,
"length": 4,
"confidenceScore": 0.74
}, {
"text": "Seattle",
"category": "Location",
"subcategory": "GPE",
"offset": 26,
"length": 7,
"confidenceScore": 1.0
}, {
"text": "last week",
"category": "DateTime",
"subcategory": "DateRange",
"offset": 34,
"length": 9,
"confidenceScore": 0.8
}],
"warnings": []
}],
"errors": [],
"modelVersion": "2021-06-01"
}
}
تنظيف الموارد
إذا كنت ترغب في تنظيف اشتراك خدمات Azure الذكاء الاصطناعي وإزالته، يمكنك حذف المورد أو مجموعة الموارد. يؤدي حذف مجموعة الموارد إلى حذف أية موارد أخرى مقترنة بها أيضًا.
الخطوات التالية
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ