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

Docker (موصى به) أو Java 25+
مفتاح API لمزود LLM (OpenAI أو Anthropic أو Google Gemini أو مثيل Ollama محلي)

1. تثبيت وتشغيل EDDI

أسرع طريقة لتشغيل EDDI هي مُثبِّت الأمر الواحد. يقوم بإعداد EDDI + قاعدة البيانات التي تختارها عبر Docker Compose، وينشر وكيلاً أولياً، ويرشدك خلال الإعداد:

Linux / macOS / WSL2:

curl -fsSL https://raw.githubusercontent.com/labsai/EDDI/main/install.sh | bash

Windows (PowerShell):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1" -OutFile "install.ps1"
Unblock-File .\install.ps1
.\install.ps1

إذا كنت تفضل التحكم اليدوي، قم باستنساخ المستودع واستخدم Docker Compose مباشرة:

docker compose up

سيكون EDDI متاحاً على http://localhost:7070.

2. اتصل عبر MCP

قم بتوصيل مساعدك الذكي بـ 65 أداة MCP في EDDI. يعتمد التكوين على دعم النقل لعميلك:

العملاء الذين يدعمون Streamable HTTP بشكل أصلي (Cursor، VS Code، Windsurf، Antigravity وإضافات IDE الأخرى) يتصلون مباشرة، لا حاجة لجسر:

{
  "mcpServers": {
    "eddi": {
      "url": "http://localhost:7070/mcp"
    }
  }
}

يدعم Claude Desktop نقل stdio فقط. استخدم mcp-remote لجسر stdio↔HTTP. يتطلب Node.js 18+.

{
  "mcpServers": {
    "eddi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:7070/mcp"]
    }
  }
}

💡 Windows: إذا لم يكن npx في PATH، استخدم "command": "cmd", "args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:7070/mcp"] بدلاً من ذلك.

الآن يمكنك التفاعل مع 65 أداة MCP في EDDI مباشرة من مساعدك الذكي.

📖 راجع وثائق خادم MCP للمرجع الكامل للأدوات والتكوين المتقدم.

3. تخزين مفتاح API الخاص بك

قبل إنشاء وكيل، قم بتخزين مفتاح API الخاص بموفر LLM بشكل آمن في Secrets Vault الخاص بـ EDDI (مشفر بـ AES-256-GCM):

curl -X PUT http://localhost:7070/secretstore/secrets/default/my-anthropic-key \
  -H "Content-Type: application/json" \
  -d '{"value": "sk-ant-your-actual-key", "description": "Anthropic API key"}'

افتح واجهة المدير على http://localhost:7070، وانتقل إلى Secrets Vault وأضف سرًا جديدًا باسم المفتاح my-anthropic-key.

💡 نصيحة: صيغة ${vault:my-anthropic-key} تشير إلى Secrets Vault المدمج في EDDI. يتم إنشاء المفتاح الرئيسي للخزنة تلقائيًا بواسطة المثبت. للاختبار السريع، يمكنك أيضًا تمرير مفاتيح API مباشرة: apiKey: "sk-ant-...".

4. إنشاء وكيلك الأول

استخدم setup_agent لإنشاء وكيل كامل الوظائف في مكالمة واحدة، عبر MCP أو REST API:

setup_agent(
  agentName: "My first agent",
  systemPrompt: "You are a helpful assistant that answers questions clearly.",
  provider: "anthropic",
  model: "claude-sonnet-4-6",
  apiKey: "${vault:my-anthropic-key}"
)

curl -X POST http://localhost:7070/administration/agents/setup \
  -H "Content-Type: application/json" \
  -d '{
    "agentName": "My first agent",
    "systemPrompt": "You are a helpful assistant that answers questions clearly.",
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "apiKey": "${vault:my-anthropic-key}"
  }'

هذا ينشئ القواعد وتكوين LLM وسير العمل والوكيل وينشره، كل ذلك في خطوة واحدة.

5. تحدث مع وكيلك

chat_with_agent(agentId: "<your-agent-id>", message: "Hello! What can you do?")

# Start a conversation and send a message
curl -X POST http://localhost:7070/agents/<your-agent-id>/start \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello! What can you do?"}'

6. افتح واجهة الإدارة

انتقل إلى http://localhost:7070 لإدارة وكلائك وسير العمل والمحادثات بصريًا باستخدام EDDI Manager.

خيارات التثبيت

يدعم سكريبت التثبيت أعلامًا للإعدادات الآلية والمخصصة:

--defaults، جميع الإعدادات الافتراضية، بدون مطالبات
--db=postgres، استخدام PostgreSQL بدلاً من MongoDB
--with-auth، تفعيل مصادقة Keycloak
--full، كل شيء مفعّل (قاعدة بيانات + مصادقة + مراقبة)
--local، بناء صورة Docker من المصدر المحلي (للمساهمين)

تحديث EDDI

يُنشئ المُثبّت غلاف CLI eddi. لسحب أحدث صورة وإعادة التشغيل:

eddi update

إذا لم يكن CLI متاحًا، قم بالتشغيل من دليل التثبيت (~/.eddi):

cd ~/.eddi
docker compose --env-file .env -f docker-compose.yml pull
docker compose --env-file .env -f docker-compose.yml up -d

نشر Kubernetes

انشر على Kubernetes بأمر واحد:

kubectl apply -f https://raw.githubusercontent.com/labsai/EDDI/main/k8s/quickstart.yaml

تتوفر أيضًا تراكبات Kustomize وخرائط Helm لـ MongoDB و PostgreSQL والمصادقة والمراقبة وتقوية الإنتاج (HPA، PDB، NetworkPolicy). راجع دليل Kubernetes.

ما التالي؟

جميع الميزاتاستكشف كل ما يقدمه EDDI خادم MCPتصفح جميع أدوات MCP الـ 65 التوثيق ↗تعمق في البنية المعمارية وواجهات API لماذا EDDI؟الحجة المؤسسية لـ EDDI

الميزات

المؤسسات

الموارد

ابدأ مع EDDI