ابدأ مع EDDI

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

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

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

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

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

iwr -useb https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1 | iex

docker compose up

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

2. اتصل عبر MCP

إذا كنت تستخدم Claude Desktop أو أي عميل متوافق مع MCP، أضف EDDI كخادم MCP:

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

الآن يمكنك التفاعل مع أدوات EDDI الـ 42 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"}'

💡 نصيحة: صيغة ${eddivault: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: "${eddivault: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": "${eddivault: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?"}'

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

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

• --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.

Quarkus SDK

هل تبني تطبيق Quarkus؟ استخدم إضافة quarkus-eddi لـ Dev Services و API المرنة وبث SSE وجسر MCP:

<dependency>
    <groupId>io.quarkiverse.eddi</groupId>
    <artifactId>quarkus-eddi</artifactId>
    <version>6.0.0</version>
</dependency>