3 خطوات لتفعيل البحث عبر الإنترنت لـ xAI Grok API: دليل كامل لـ x_search و web_search

ملاحظة المؤلف: تفصيل شامل لأحدث ميزات البحث المتصل بالإنترنت في Grok API من xAI، بما في ذلك طرق التكوين الكاملة ونماذج التعليمات البرمجية لكل من x_search للبحث في محتوى منصة X و web_search للبحث في شبكة الويب.

يتساءل العديد من المطورين عند استخدام Grok API من xAI: كيف يمكن تنفيذ البحث المتصل بالإنترنت في Grok API؟ تم إيقاف واجهة برمجة تطبيقات البحث المباشر (Live Search API) التي كانت توفرها xAI سابقاً، وأطلقت الشركة الآن ميزة استدعاء الأدوات (Tools) الأكثر قوة، والتي تحقق قدرات البحث عبر الإنترنت من خلال أداتين من جانب الخادم هما x_search و web_search.

القيمة الجوهرية: بقراءتك لهذا المقال، ستتقن الطريقة الكاملة لاستخدام Grok API من xAI لإجراء عمليات البحث في منصة X والويب، مما يسمح لتطبيقات الذكاء الاصطناعي الخاصة بك بالحصول على معلومات في الوقت الفعلي.

النقاط الأساسية لبحث Grok API من xAI عبر الإنترنت

شرح مفصل لنقاط البحث عبر الإنترنت في Grok API من xAI

الجدول الزمني لإيقاف Live Search API: أعلنت xAI رسمياً أن واجهة برمجة تطبيقات البحث المباشر الأصلية (التي يتم تكوينها عبر search_parameters) سيتم إيقافها نهائياً في 12 يناير 2026. في ذلك الوقت، ستُرجع الطلبات رمز الحالة 410 Gone. يحتاج المطورون إلى الهجرة إلى واجهة برمجة تطبيقات Agent Tools الجديدة في أقرب وقت ممكن لضمان استمرارية الخدمة.

المزايا الجوهرية للهندسة الجديدة: تعتمد آلية استدعاء الأدوات (Tools) الجديدة نمط التنفيذ الذاتي من جانب الخادم. عندما توفر أدوات x_search أو web_search في طلبك، سيقوم خادم xAI تلقائياً بتنظيم حلقة استدلال ذكي – سيقوم النموذج بتحليل السؤال بشكل مستقل، وبدء البحث، وتحليل النتائج، وإجراء استفسارات إضافية إذا لزم الأمر، وفي النهاية يُرجع إجابة شاملة. هذا الأسلوب المسمى "البحث الوكيل" (Agentic Search) أكثر ذكاءً وشمولاً من البحث البسيط التقليدي.

البدء السريع للبحث عبر الإنترنت باستخدام xAI Grok API

مثال مبسط

فيما يلي أبسط مثال لاستخدام x_search للبحث عن المحتوى في منصة X:

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast",
    "input": [
      {
        "role": "user",
        "content": "What is the current status of xAI?"
      }
    ],
    "tools": [
      {
        "type": "x_search"
      }
    ]
  }'

import requests
import os

def grok_x_search(query: str, allowed_handles: list = None) -> dict:
    """
    使用 xAI Grok API 的 x_search 工具搜索 X 平台内容

    Args:
        query: 搜索查询内容
        allowed_handles: 可选，限定搜索的 X 用户列表（最多 10 个）

    Returns:
        API 响应结果
    """
    url = "https://api.x.ai/v1/responses"
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {os.environ.get('XAI_API_KEY')}"
    }

    # 构建 x_search 工具配置
    x_search_tool = {"type": "x_search"}
    if allowed_handles:
        x_search_tool["allowed_x_handles"] = allowed_handles

    payload = {
        "model": "grok-4-1-fast",
        "input": [
            {"role": "user", "content": query}
        ],
        "tools": [x_search_tool]
    }

    response = requests.post(url, headers=headers, json=payload)
    return response.json()

# 使用示例：搜索特定用户的推文
result = grok_x_search(
    query="What are the latest announcements about Grok?",
    allowed_handles=["elonmusk", "xaboratory"]
)
print(result)

نصيحة: إذا كنت بحاجة إلى اختبار قدرات البحث عبر الإنترنت لمجموعة متنوعة من نماذج لغة كبير في وقت واحد، يمكنك الحصول على واجهة API موحدة من خلال APIYI apiyi.com. تدعم المنصة نماذج xAI Grok و OpenAI و Claude وغيرها من النماذج الرائدة، مما يسهل المقارنة السريعة لنتائج البحث بين النماذج المختلفة.

شرح مفصل لأداة x_search في xAI Grok API

تُعد x_search أداة متخصصة للبحث في محتوى منصة X (تويتر سابقًا)، وهي تدعم البحث بالكلمات المفتاحية، والبحث الدلالي، والبحث عن المستخدمين، واستخراج المواضيع المتداولة.

تهيئة معلمات x_search

مثال على استخدام x_search

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast",
    "input": [
      {
        "role": "user",
        "content": "总结 Elon Musk 最近关于 AI 的观点"
      }
    ],
    "tools": [
      {
        "type": "x_search",
        "allowed_x_handles": ["elonmusk"],
        "from_date": "2025-12-01",
        "to_date": "2026-01-23"
      }
    ]
  }'

نصيحة تقنية: استخدام allowed_x_handles لتحديد نطاق البحث يمكن أن يحسن بشكل كبير من صلة ودقة نتائج البحث، وهو مثالي لتتبع تحديثات خبراء صناعة معينين أو الحسابات الرسمية.

شرح أداة web_search في واجهة برمجة تطبيقات xAI Grok

تُعد أداة web_search أداة قوية للحصول على المعلومات من الإنترنت في الوقت الفعلي، حيث يمكنها البحث في الويب بالكامل وتصفح محتوى المواقع تلقائيًا.

إعدادات معاملات web_search

مثال على استخدام web_search

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4-1-fast",
    "input": [
      {
        "role": "user",
        "content": "What are the latest features of GPT-4o?"
      }
    ],
    "tools": [
      {
        "type": "web_search",
        "allowed_domains": ["openai.com", "techcrunch.com"]
      }
    ]
  }'

نصيحة للحالات الاستخدام: عندما تحتاج إلى الحصول على معلومات تقنية موثوقة، استخدم allowed_domains لتحديد مواقع التوثيق الرسمية لضمان دقة المعلومات.

مقارنة حلول البحث المتصل بالإنترنت في xAI Grok API

توضيح المقارنة: يمكن استخدام الأداتين معًا في نفس الوقت، حيث سيقوم خادم xAI باختيار الأداة المناسبة للبحث تلقائيًا بناءً على طبيعة السؤال. يمكنك اختبار تأثير استراتيجيات البحث المختلفة بسهولة عبر APIYI (apiyi.com).

مراجع ومصادر البحث عبر الإنترنت في واجهة برمجة تطبيقات xAI Grok

بعد استخدام البحث عبر الإنترنت، ستعيد واجهة برمجة التطبيقات (API) معلومات حول جميع المصادر التي تم الوصول إليها أثناء عملية البحث. هناك وضعان للمراجع:

تنسيق إرجاع المراجع

# مثال لطلب تفعيل المراجع المدمجة
payload = {
    "model": "grok-4-1-fast",
    "input": [{"role": "user", "content": "أحدث التطورات في شركة xAI"}],
    "tools": [{"type": "x_search"}, {"type": "web_search"}],
    "inline_citations": True  # تفعيل المراجع المدمجة
}

ملاحظة: بعد تفعيل المراجع المدمجة، سيتخذ النموذج قراراً مستقلاً بناءً على السياق حول ما إذا كان سيضيف مراجع في الإجابة، لذا قد لا تتضمن جميع الإجابات مراجع مدمجة.

الأسئلة الشائعة

ملخص

النقاط الرئيسية للبحث المتصل بالإنترنت عبر واجهة برمجة تطبيقات (API) Grok من xAI:

1. الانتقال السريع: سيتم إيقاف Live Search API في 12 يناير 2026، لذا يُنصح بالانتقال إلى أسلوب استدعاء الأدوات (Tools) في أقرب وقت ممكن.
2. التعاون بين أداتين: أداة x_search مناسبة لمحتوى وسائل التواصل الاجتماعي، وأداة web_search مناسبة للمعلومات من الويب بالكامل، ويمكن استخدام كليهما معًا.
3. الاستنتاج الذكي: تعتمد البنية الجديدة نمط البحث الوكيل (Agentic Search)، حيث يقوم النموذج تلقائيًا بإجراء عدة جولات من البحث والتحليل.

تتمتع ميزة البحث المتصل بالإنترنت في Grok API من xAI بميزة فريدة في الحصول على محتوى منصة X في الوقت الفعلي، وهي مناسبة تمامًا لسيناريوهات التطبيق التي تتطلب تتبع ديناميكيات وسائل التواصل الاجتماعي.

نوصي بالتحقق من النتائج بسرعة عبر APIYI (apiyi.com)، حيث توفر المنصة رصيدًا مجانيًا وواجهة موحدة لنماذج متعددة، مما يسهل مقارنة قدرات البحث المتصل بالإنترنت بين xAI Grok والنماذج الأخرى.

📚 المراجع

⚠️ توضيح بخصوص تنسيق الروابط: تستخدم جميع الروابط الخارجية تنسيق اسم المرجع: domain.com لسهولة النسخ ولكنها غير قابلة للنقر، وذلك لتجنب فقدان قوة تحسين محركات البحث (SEO).

1. وثائق أدوات بحث xAI الرسمية: شرح كامل لمعاملات أدوات البحث مع الأمثلة

   • الرابط: docs.x.ai/docs/guides/tools/search-tools
   • الوصف: الوثائق الرسمية المعتمدة، تحتوي على أحدث مواصفات واجهة برمجة التطبيقات (API)

2. نظرة عامة على أدوات xAI: نظرة شاملة على نظام استدعاء الأدوات

   • الرابط: docs.x.ai/docs/guides/tools/overview
   • الوصف: لفهم البنية العامة لأدوات xAI من جهة الخادم

3. دليل الانتقال من xAI Live Search: إعلان الإيقاف وتعليمات الهجرة

   • الرابط: docs.x.ai/docs/guides/live-search
   • الوصف: للتعرف على الجدول الزمني للإيقاف ومسارات الانتقال

الكاتب: الفريق التقني
التواصل التقني: نرحب بالنقاش في قسم التعليقات، ولمزيد من المعلومات يمكنكم زيارة المجتمع التقني لـ APIYI (apiyi.com)