agentkit

AgentKit: بناء بسرعة تطبيقات عوامل عالية الجودة

AgentKit هي مجموعة بداية قائمة على Langchain تم تطويرها بواسطة BCG X لإنشاء تطبيقات الوكيل. يمكن للمطورين استخدام AgentKit

• جرب بسرعة على بنية الوكيل المقيدة مع واجهة مستخدم جميلة
• قم بإنشاء تطبيق وكيل كامل قائم على الدردشة يمكنه توسيع نطاقه إلى MVP من فئة الإنتاج

تتضمن المزايا الرئيسية لمجموعة أدوات AgentKit:

• قم ببناء تطبيقات عوامل عالية الجودة بسرعة : قم بإنشاء عرض توضيحي قوي في غضون ساعات قليلة باستخدام مجموعة تقنية معيارية وسهلة التكوين بناءً
• مرن ومرن واجهة المستخدم/UX مصممة للوكلاء : واجهة المستخدم المستندة إلى الدردشة React/Nextjs يسهل تكوينها ، مع ميزات مثل البث ، تقديم الجداول/التصورات/الكود ، حالة إجراءات الوكيل والمزيد
• ️ التركيز على الموثوقية : من السهل تكوين بنية التوجيه يمنح التحكم في المسارات المحتملة التي يمكن أن يأخذها وكيل ، وزيادة الموثوقية وجعلها مناسبة لحالات الاستخدام الواقعية
• ؟ تم إعداده إلى المقياس : تم إعداده إلى MVP مع إدارة قائمة انتظار جاهزة ، مصادقة ، تخزين مؤقت ، مراقبة إلخ.

AgentKit_Video.mp4

مكدس التكنولوجيا

تعتمد حزمة المبتدئين على أحدث التقنيات للأداء الأمثل والأمان وتجربة المطور.

• ؟ NextJS 14 مع Tailwind و Daisyui
• Python 3.10 مع fastapi و sqlmodel و pydantic 2.x.
• ؟ تكوين Langchain و Langsmith E2E
• ؟ المصادقة: تم دمج Nextauth مع Fastapi
• ؟ الكرفس و redis للمهام طويلة المدى ، التخزين المؤقت وما إلى ذلك.
• ؟ Postgres المحلية مع امتداد PGVector
• ⬆ Docker-Compose للنشر البسيط و DX
• ؟ linting واختبارات وخطافات ما قبل الالتزام المسبق

ملاحظة: هذه مجموعة أدوات بداية - لنشر الإنتاج ، نوصي بإضافة وظائف أمان على مستوى المؤسسة. خاصة عند استخدام LLMS ، كن على دراية بالمخاطر المعروفة مثل الحقن السريع (اقرأ المزيد).

Quickstart

لإعداد سريع لـ AgentKit ، استخدم الخطوات أدناه ، حيث يتم تشغيل كل من تطبيق الواجهة الخلفية وتطبيق الواجهة الأمامية داخل حاوية Docker. يمكن العثور على المزيد من تعليمات الإعداد المعقدة في الوثائق.

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

• Docker: https://www.docker.com/get-started

خطوات التثبيت

1. استنساخ المستودع الذي يحتوي على رمز المصدر لتطبيقات الواجهة الخلفية والواجهة.

2. انسخ ملف frontend/.env.example في دليل الواجهة الأمامية وقم بتغيير الاسم إلى .env . أيضا ، انسخ ملف .env.example في الدليل الجذر للمستودع وتغيير الاسم إلى .env .

   • قم بتغيير Openai_API_Key و Openai_organization إلى (NB Openai_organization يجب أن يكون Openai "معرف المنظمة" الخاص بك)

3. في المحطة ، انتقل إلى الدليل الجذر للمستودع المستنسخ. بناء وبدء حاويات Docker مع الأمر التالي:

    docker-compose -f docker-compose.yml up -d
   

   انتظر حتى يتم إنشاء الحاويات وتبدأ ، والتي قد تستغرق بضع دقائق حسب نظامك. بمجرد تشغيل الحاويات ، يمكنك الوصول إلى التطبيقات في متصفحك على http: // localhost.

Demo Chinook Music Demo

• إذا كانت حاويات Docker قيد التشغيل ، فقم بتشغيل docker-compose down --volumes
• اتبع تعليمات التثبيت أعلاه ومبادلة docker-compose.yml مع docker-compose-demo.yml لتشغيل التطبيق
• جرب موجه "كم عدد الفنانين والأغاني الموجودة في قاعدة البيانات؟" لرؤية AgentKit في العمل!

تحقق من بناء تجريبي أكثر تقدما بعد البرنامج التعليمي.

قم بإعداد التطبيق الخاص بك

• تكوين الوكيل والأدوات الرابط
• (اختياري) اضبط واجهة المستخدم على رابط حالة الاستخدام الخاص بك
• (اختياري) إعداد التقييم مع رابط Langsmith

الوثائق

ابحث عن الوثائق المستضافة هنا.

• تعليمات التثبيت لتشغيل الواجهة الأمامية أو التطبيق بالكامل خارج Docker
• المفاهيم الرئيسية
• تكوين الوكيل والأدوات
• تكوين واجهة المستخدم
• ميزات اختيارية
• مكتبة الأدوات

كيف تعمل

مصداقية

يحاول AgentKit حل قضية موثوقية الوكلاء مثل عوامل React من خلال تقييد الطرق المحتملة التي يمكن للوكيل أن يأخذها إلى مجموعات من الطرق أو خطط العمل مسبقًا. نظرًا لأن العديد من حالات الاستخدام ، فإن الطرق المحتملة التي يمكن أن يتخذها العميل معروفة ، يمكننا استخدام خبرة المجال البشري لدينا لتوجيه الوكيل في الاتجاه الصحيح ، وتقليله إلى اتجاهات غير متوقعة أو ثقوب أرنب. يتم تحقيق ذلك من خلال الجمع بين وكيل التعريف مع خطط الإجراء : مجموعة من الأدوات التي يتم تنفيذها خطيًا وبالمثل ، على غرار السلسلة. يأخذ وكيل META موجه المستخدم ويخرج خطة العمل الأكثر ملاءمة لإنشاء إجابة. ملاحظة: من الممكن تنفيذ وكلاء التعريف المتعددة ، مما يولد شجرة من الطرق الممكنة.

تجربة المستخدم

لتحسين تجربة المستخدم ، يمكن عرض الإخراج الوسيط لكل خطوة في خطة العمل للمستخدم. على سبيل المثال ، ضع في اعتبارك خطة عمل تتكون من اثنين من الأدوات: [[sql_tool, pdf_tool], [generate_summary_tool, visualize_tool]] . في خطوة الإجراء الأولى ، يتم استرداد المعلومات من قاعدة بيانات SQL وقاعدة بيانات المتجهات مع PDF المضمن بالتوازي. يتم دفق البيانات التي تم استردادها ومعظم PDF ذات الصلة إلى واجهة المستخدم بمجرد انتهاء خطوة الإجراء الأولى. في خطوة الإجراء الثانية ، يتم تمرير الإخراج من الخطوة 1 إلى أداة تنشئ ملخص نص وأداة تنشئ تصور JSX من البيانات ، والتي يتم بثها إلى واجهة المستخدم لإنشاء الإجابة النهائية.

للحصول على نظرة عامة عالية على تدفق التوجيه والاتصال واجهة المستخدم ، يرجى الاطلاع على الرسم البياني أدناه:

ميزات اختيارية إضافية

• تكامل التعليقات : جمع التعليقات على إجابات تم إنشاؤها من المستخدمين

• إعدادات المستخدم : السماح للمستخدمين بتحديد الإعدادات الافتراضية في التطبيق والتي يمكن استخدامها لتخصيص مطالبات للمستخدم

• مصادقة المستخدم : تمكين NextAuth على تطبيقك لمصادقة المستخدمين مع Github أو مع البريد الإلكتروني/كلمة المرور

راجع وثائق الميزة الاختيارية للحصول على معلومات أكثر تفصيلاً.

تاريخ النجوم

الدعم والصيانة

نسج مشروع مجموعة من القوالب المختلفة. أحد الإلهام العظيم هو fastapi-alembic-sqlmodel-async ، والذي وفر الأسس لإعداد fastapi. يرجى التحقق منها!

شكر رائع لجميع المساهمين: @kaikun213 drivianeielmansouri @mastermplinter @tanmaygupta9 @sofglide @harticodeedenbd @ben-howtcarelschw @gustafvh @casper321 @modvinden1 @

يرجى قراءة CONTRIBUTING.md لمزيد من التفاصيل حول كيفية المساهمة. PRS موضع ترحيب ❤

رخصة

• هذا المشروع مرخص بموجب شروط ترخيص معهد ماساتشوستس للتكنولوجيا