واجهة برمجة تطبيقات برمجة نصية عالية المستوى لمنشئي الروبوتات والمطورين والمشرفين.
تعد Python Dialogflow CX Scripting API (DFCX SCRAPI) واجهة برمجة تطبيقات عالية المستوى تعمل على توسيع عميل Google Python الرسمي لـ Dialogflow CX. يجعل SCRAPI استخدام DFCX أسهل وأكثر ودية وأكثر لغة بايثونية لمنشئي الروبوتات والمطورين والمشرفين.
SCRAPI --> Python Dialogflow CX
as
Keras --> Tensorflow
باستخدام DFCX SCRAPI، يمكنك تنفيذ العديد من إجراءات إنشاء الروبوتات وصيانتها على نطاق واسع بما في ذلك، على سبيل المثال لا الحصر:
يمكن أن تختلف المصادقة اعتمادًا على كيفية ومكان تفاعلك مع SCRAPI.
إذا كنت تستخدم SCRAPI مع دفتر ملاحظات Google Colab، فيمكنك إضافة ما يلي إلى الجزء العلوي من دفتر ملاحظاتك لسهولة المصادقة:
project_id = '<YOUR_GCP_PROJECT_ID>'
# this will launch an interactive prompt that allows you to auth with GCP in a browser
!g cloud auth application - default login - - no - launch - browser
# this will set your active project to the `project_id` above
!g cloud auth application - default set - quota - project $ project_id
بعد تشغيل ما ورد أعلاه، سوف يقوم Colab بالتقاط بيانات الاعتماد الخاصة بك من البيئة وتمريرها إلى SCRAPI مباشرة. لا حاجة لاستخدام مفاتيح حساب الخدمة! يمكنك بعد ذلك استخدام SCRAPI ببساطة مثل هذا:
from dfcx_scrapi . core . intents import Intents
agent_id = '<YOUR_AGENT_ID>'
i = Intents () # <-- Creds will be automatically picked up from the environment
intents_map = i . get_intents_map ( agent_id )
إذا كنت تستخدم SCRAPI مع Cloud Functions أو Cloud Run، فيمكن لـ SCRAPI التقاط أرصدة البيئة الافتراضية التي تستخدمها هذه الخدمات دون أي تكوين إضافي!
dfcx-scrapi
إلى ملف requirements.txt
الخاص بكبمجرد الانتهاء من الإعداد باستخدام ما ورد أعلاه، يمكن استخدام رمز وظيفتك بسهولة مثل هذا:
from dfcx_scrapi . core . intents import Intents
agent_id = '<YOUR_AGENT_ID>'
i = Intents () # <-- Creds will be automatically picked up from the environment
intents_map = i . get_intents_map ( agent_id )
على غرار Cloud Functions / Cloud Run، يمكن لـ SCRAPI التقاط بيانات اعتماد المصادقة المحلية الخاصة بك إذا كنت تستخدم gcloud CLI.
gcloud init
.gcloud auth login
gcloud auth list
للتأكد من أن حسابك الرئيسي نشط.سيؤدي هذا إلى مصادقة حساب Google Cloud Platform الرئيسي الخاص بك باستخدام gcloud CLI، ويمكن لـ SCRAPI الحصول على الاعتمادات من هنا.
هناك بعض الفئات في SCRAPI التي لا تزال تعتمد على مفاتيح حساب الخدمة، ولا سيما فئة DataframeFunctions نظرًا لكيفية مصادقتها مع جداول بيانات Google.
لاستخدام هذه الوظائف، ستحتاج إلى حساب خدمة يتمتع بحق الوصول المناسب إلى مشروع Google Cloud Platform الخاص بك.
لمزيد من المعلومات ولعرض الوثائق الرسمية لحسابات الخدمة، انتقل إلى إنشاء حسابات خدمة Google Cloud Platform وإدارتها.
بمجرد حصولك على مفتاح حساب الخدمة بالأذونات المناسبة، يمكنك استخدامه على النحو التالي:
from dfcx_scrapi . core . intents import Intents
from dfcx_scrapi . tools . dataframe_functions import DataframeFunctions
agent_id = '<YOUR_AGENT_ID>'
creds_path = '<PATH_TO_YOUR_SERVICE_ACCOUNT_JSON_FILE>'
i = Intents ( creds_path = creds_path )
dffx = DataframeFunctions ( creds_path = creds_path )
df = i . bulk_intent_to_df ( agent_id )
dffx . dataframe_to_sheets ( 'GOOGLE_SHEET_NAME' , 'TAB_NAME' , df )
قم بإعداد بيانات اعتماد Google Cloud Platform وتثبيت التبعيات.
gcloud auth login
gcloud auth application-default login
gcloud config set project < project name >
python3 -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt
لتشغيل جزء بسيط من التعليمات البرمجية، يمكنك القيام بما يلي:
dfcx_scrapi.core
from dfcx_scrapi . core . intents import Intents
creds_path = '<PATH_TO_YOUR_SERVICE_ACCOUNT_JSON_FILE>'
agent_path = '<FULL_DFCX_AGENT_ID_PATH>'
# DFCX Agent ID paths are in this format:
# 'projects/<project_id>/locations/<location_id>/agents/<agent_id>'
# Instantiate your class object and pass in your credentials
i = Intents ( creds_path , agent_id = agent_path )
# Retrieve all Intents and Training Phrases from an Agent and push to a Pandas DataFrame
df = i . bulk_intent_to_df ()
فيما يلي نظرة عامة مختصرة على بنية مكتبة SCRAPI والدافع وراء هذا الهيكل.
يعد المجلد الأساسي مرادفًا لأنواع الموارد الأساسية في وكلاء DFCX (الوكلاء، والمقاصد، والتدفقات، وما إلى ذلك)
يحتوي مجلد "الأدوات" على العديد من مجموعات الأدوات المخصصة التي تتيح لك القيام بمهام إدارة الروبوتات الأكثر تعقيدًا، مثل
يحتوي مجلد Builders على طرق بسيطة لإنشاء النماذج الأولية الأساسية في Dialogflow CX
نحن نرحب بأي مساهمات أو طلبات الميزات التي ترغب في تقديمها!
وزعت بموجب ترخيص أباتشي 2.0. راجع الترخيص لمزيد من المعلومات.
باتريك مارلو - [email protected] - @kmaphoenix
ميلاد التبريزي - [email protected] - @MRyderOC
رابط المشروع: https://github.com/GoogleCloudPlatform/dfcx-scrapi
مكتبة عملاء Dialogflow CX Python
معانقة الوجه - إعادة صياغة بيغاسوس