> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# استخدم LlamaIndex مع CometAPI
> استخدم هذا الدليل لتهيئة LlamaIndex مع CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.
يوفّر LlamaIndex الفئة `CometLLM` كتَكامل أساسي مع CometAPI. استخدمها لتشغيل مسارات RAG والوكلاء وسلاسل LLM باستخدام أي model في كتالوج CometAPI.
## المتطلبات الأساسية
* Python 3.8+
* حساب CometAPI مع مفتاح API نشط — [احصل على مفتاحك من هنا](https://www.cometapi.com/console/token)
```bash theme={null}
pip install llama-index-llms-cometapi llama-index
```
```python theme={null}
from llama_index.llms.cometapi import CometLLM
import os
os.environ["COMETAPI_KEY"] = ""
api_key = os.getenv("COMETAPI_KEY")
```
استخدام متغيرات البيئة أكثر أمانًا من تضمين بيانات الاعتماد مباشرة داخل السكربتات.
```python theme={null}
from llama_index.core.llms import ChatMessage
llm = CometLLM(
api_key=api_key,
max_tokens=256,
context_window=4096,
model="your-model-id",
)
# Chat call
messages = [
ChatMessage(role="system", content="You are a helpful assistant"),
ChatMessage(role="user", content="Say 'Hi' only!"),
]
resp = llm.chat(messages)
print(resp)
# Completion call
resp = llm.complete("Who is Kaiming He?")
print(resp)
```
استخدم `stream_chat` أو `stream_complete` للحصول على مخرجات مجزأة في الوقت الفعلي:
```python theme={null}
# Streaming chat
message = ChatMessage(role="user", content="Tell me what ResNet is")
for chunk in llm.stream_chat([message]):
print(chunk.delta, end="")
# Streaming completion
for chunk in llm.stream_complete("Tell me about Large Language Models"):
print(chunk.delta, end="")
```
* **النماذج**: راجع [صفحة نماذج CometAPI](/ar/overview/models) للاطلاع على جميع الخيارات المتاحة.
* **استخدام نماذج أخرى**: هيّئه باستخدام model ID حالي مختلف، مثل `CometLLM(api_key=api_key, model="your-model-id", max_tokens=1024)`.
* **Fine-tuning**: مرّر `temperature` و `max_tokens` مباشرة إلى `CometLLM(...)`.
* **معالجة الأخطاء**: ضع الاستدعاءات داخل `try/except` لالتقاط أخطاء المفاتيح أو مشكلات الشبكة.
* **الأمان**: لا تقم أبدًا بتضمين مفاتيح API في نظام التحكم بالإصدارات. استخدم متغيرات البيئة.
* **مزيد من الوثائق**: [وثائق LlamaIndex](https://docs.llamaindex.ai/) — [البدء السريع لـ CometAPI](/ar/overview/quick-start) — [مثال Colab](https://colab.research.google.com/github/run-llama/llama_index/blob/main/docs/docs/examples/llm/cometapi.ipynb)