إخلاء المسئولية : تعكس البرامج النصية المقدمة في هذا المستودع حالة الخدمة Amazon Q للأعمال حيث تم إطلاقها في ديسمبر 2023 بواسطة AWS في وضع المعاينة. نظرًا لوضع المعاينة هذا ، يمكن أن تتغير ميزات Amazon Q وتنفيذها في أي وقت أثناء المعاينة ولتوافر العام. قد تتطلب هذه التغييرات تحديثات لهذا المستودع.
يجمع هذا المشروع أدوات متنوعة ونصوص فائدة لاستكشاف وتشغيل Amazon Q للأعمال. سنضيف نصوصًا جديدة بناءً على طلبك: لا تتردد في قطع تذكرة هنا إذا كانت لديك حاجة أو فكرة!
نقدم حاليًا المرافق التالية:
جميع هذه البرامج النصية تعيد هياكل JSON التي يمكن معالجتها بشكل أكبر في خطوط أنابيب الصدفة مع مختلف المرافق مثل JQ ، SED ، AWK ، إلخ.
تعتمد تلك البرامج النصية على Python AWS SDK. يتم وصف جميع واجهات برمجة التطبيقات المتعلقة بـ Q للأعمال بالتفاصيل في الوثائق العامة SDK BOTO3.
Amazon Q هو مساعد مُدار بالكامل ، يمكن تكوينه للإجابة على الأسئلة ، وتوفير الملخصات ، وإنشاء المحتوى ، ومهام كاملة بناءً على البيانات في مؤسستك. توفر Amazon Q معلومات فورية وذات صلة لمستخدميها ، وتساعد على تبسيط المهام وتسريع حل المشكلات.
يعتمد تطبيق Amazon Q على مجموعة من المستندات لإنشاء مؤشر Q المحدد. يتم تخزين مجموعة المستندات هذه في مستودعات مستندات واحدة أو أكثر (S3 ، JIRA ، QUIP ، إلخ) تسمى مصادر بيانات Q. سيتم إعداد إجابات أسئلة المستخدم من قبل المساعد من خلال رافعة تقنية RAG.
الجيل المتمثل في الاسترداد (RAG) هو تقنية معالجة اللغة الطبيعية (NLP). يتكون من نظام قائم على نموذج اللغة ، وعادة ما يكون نموذج لغة كبير (LLM) ، والذي يصل إلى مصادر المعرفة الخارجية لإكمال المهام. يتيح ذلك المزيد من السياق ، والاتساق الواقعي ، ويحسن موثوقية الاستجابات التي تم إنشاؤها ، ويساعد على تخفيف مشكلة "الهلوسة".
تفترض البرامج النصية لهذا المشروع أن مستخدم AWS ينعكس على متغيرات البيئة المسمى AWS_ACCESS_KEY_ID و AWS_SECRET_ACCESS_KEY لديه بيانات اعتماد IAM المناسبة من حيث التراخيص للوصول إلى واجهات برمجة التطبيقات الخاصة بـ AMARY Q في حساب AWS. انظر أمثلة سياسة IAM في قسم الأمان في وثائق Q للحصول على جميع التفاصيل.
من دليل /src لهذا المشروع ، يمكن استخدام الأوامر التالية للحصول على جميع خيارات الأوامر
لـ List_applications.py
%python3 q_list_applications.py -h
usage: q_list_applications.py [-h] [-v]
list applications, indexes, retrievers, web experiences, plugins, etc. running in Amazon Q for business
options:
-h, --help show this help message and exit
-v, --verbose verbose mode
q_list_data_source_sync_jobs
% python3 q_list_data_source_sync_jobs.py -h
usage: q_list_data_source_sync_jobs.py [-h] [-a APP_ID] [-i IDX_ID] [-d DS_ID] [-v]
list synchronization jobs executed for a given data source of an Amazon Q application
options:
-h, --help show this help message and exit
-a APP_ID, --app_id APP_ID
Q application id
-i IDX_ID, --idx_id IDX_ID
Q data source id
-d DS_ID, --ds_id DS_ID
Q data source id
-v, --verbose verbose mode
لـ q_list_documents.py
% python3 q_list_documents.py -h
usage: q_list_documents.py [-h] [-a APP_ID] [-i IDX_ID] [-incl INCLUDE] [-excl EXCLUDE] [-inv] [-v]
list documents indexed by Amazon Q
options:
-h, --help show this help message and exit
-a APP_ID, --app_id APP_ID
Q application id
-i IDX_ID, --idx_id IDX_ID
Q index id
-incl INCLUDE, --include INCLUDE
comma-separated list of status to include
-excl EXCLUDE, --exclude EXCLUDE
comma-separated list of status to exclude
-inv, --inventory with document inventory
-v, --verbose verbose mode
لـ q_list_conversations.py
% python3 q_list_conversations.py -h
usage: q_list_conversations.py [-h] [-a APP_ID] [-u USR_ID] [-v]
list documents indexed by Amazon Q
options:
-h, --help show this help message and exit
-a APP_ID, --app_id APP_ID
Q application id
-u USR_ID, --usr_id USR_ID
Q user id
-v, --verbose verbose mode
ل q_chat.py
% python3 q_chat.py -h
usage: q_chat.py [-h] [-a APP_ID] [-u USR_ID] [-p PROMPT] [-f FILE] [-c CNV_ID] [-m MSG_ID] [-d] [-v]
ask a question to a Q application and get answer
options:
-h, --help show this help message and exit
-a APP_ID, --app_id APP_ID
Q application id
-u USR_ID, --usr_id USR_ID
Q index id
-p PROMPT, --prompt PROMPT
question prompt or path to file with list of prompts
-f FILE, --file FILE path to attachment file
-c CNV_ID, --cnv_id CNV_ID
Q conversation id (only to continue an existing conversation)
-m MSG_ID, --msg_id MSG_ID
Q parent message id (only to continue an existing conversation)
-d, --details full conversation details
-v, --verbose verbose mode