ייצוא וייבוא

בדף הזה מוסבר איך לייצא ולייבא אפליקציות של סוכנים וכלים בודדים.

ייצוא וייבוא של סוכנים

אתם יכולים לייצא ולייבא אפליקציות של סוכנים:

  1. פותחים את מסוף CX Agent Studio.
  2. בוחרים את הפרויקט הרצוי. תוצג רשימה של בקשות לסוכנים בפרויקט.
  3. לוחצים על תפריט ההקשר של האפליקציה ואז בוחרים באפשרות 'ייבוא' או 'ייצוא'.

קובץ סביבה

כשמייצאים אפליקציה של סוכן, קובץ בשם environment.json נכלל בספריית הבסיס של הארכיון שהורד. הקובץ הזה עוזר לכם לנהל הגדרות ספציפיות לסביבה של האפליקציה, כמו קטגוריות של Cloud Storage, נקודות קצה של שירותים ומזהי URI של מאגרי נתונים.

השימוש בקובץ הזה לייצוא ולייבוא מציע את היתרונות הבאים:

  • ניידות משופרת: אפשר להעביר אפליקציות של סוכנים בין פרויקטים או סביבות שונות (לדוגמה, מפיתוח לייצור) על ידי שינוי של קובץ אחד.
  • הגדרה מרכזית: כל התלות החיצונית העיקרית מפורטת במקום אחד, מה שמפשט את הניהול ומספק סקירה ברורה.
  • פחות שגיאות: השימוש בכלי מצמצם את הסיכון לטעויות בהשוואה לעריכה ידנית של ההגדרות בכמה קובצי משאבים.
  • מתאים לאוטומציה: פורמט ה-JSON מאפשר לעדכן את ההגדרות באופן פרוגרמטי באמצעות סקריפטים כחלק מפייפליין CI/CD.

כדי לעדכן הגדרות שספציפיות לסביבה:

  1. ייצוא: מורידים את אפליקציית הסוכן המיוצאת ומחלצים אותה.
  2. שינוי: פותחים את הקובץ environment.json שנמצא בספריית הבסיס. משנים את הערכים של התלויות כך שיתאימו להגדרות של סביבת היעד.
  3. ייבוא: דוחסים את כל הספרייה, כולל קובץ environment.json שעבר שינוי, לארכיון ZIP חדש. מייבאים את הארכיון החדש לסביבת היעד. המערכת מחילה את הערכים המעודכנים מ-environment.json.

פרטי קובץ הסביבה

הקובץ environment.json משמש כמניפסט מרכזי לתלות חיצונית שעשויה להשתנות בין סביבות שונות (לדוגמה, פיתוח, בדיקה וייצור).

כשמייצאים אפליקציית סוכן, המערכת מזהה שדות ספציפיים לסביבה במשאבים של האפליקציה. במקום להגדיר את הערכים האלה באופן קשיח, המערכת מחלצת אותם ומציבה אותם בקובץ environment.json. הערכים מסודרים לפי סוג המשאב והשם שלו. בקובצי המניפסט המקוריים של המשאבים, הערכים שחולצו מוחלפים במשתנה placeholder‏, $env_var.

כשמייבאים את אפליקציית הסוכן, המערכת קוראת את הקובץ environment.json. הוא מאתר את ה-placeholders ‏$env_var במניפסטים של המשאבים ומחליף אותם בערכים התואמים מקובץ environment.json. במהלך התהליך הזה, האפליקציה מוגדרת לסביבה החדשה.

השדות הבאים מנוהלים בקובץ environment.json:

  • ApiKeyConfig.key_name
  • ApiKeyConfig.api_key_secret_version
  • AudioRecordingConfig.gcs_bucket
  • BoostSpecs.data_stores
  • ConnectorTool.connection
  • DataStore.name
  • EngineSource.engine
  • FileSearchTool.file_corpus
  • OAuthConfig.client_secret_version
  • OAuthConfig.token_endpoint
  • OpenApiToolset.url (חילוץ אוטומטי מתוך OpenApiToolset.open_api_schema)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids

ייצוא וייבוא של כלי עבודה

אפשר לייצא ולייבא כלים בודדים. הפונקציונליות הזו מספקת שתי אפשרויות חדשות בחלונית הכלים: ייבוא וייצוא.

  • ייצוא: הורדת התוכן של הכלי כקובץ JSON למחשב המקומי או ל-Cloud Storage.
  • ייבוא: אפשר להשתמש בקובצי JSON מקומיים או בקובצי JSON שמאוחסנים ב-Cloud Storage כדי ליצור כלים חדשים או לעדכן כלים קיימים.

ייצוא כלי

כדי לייצא כלי:

  1. פותחים את מסוף CX Agent Studio ובוחרים את הפרויקט והסוכן.
  2. פותחים את החלונית Tool (כלי).
  3. לוחצים על תפריט ההקשר של הכלי שרוצים לייצא.
  4. לוחצים על ייצוא.
  5. בתיבת הדו-שיח, בוחרים אחת מהאפשרויות הבאות:
    • הורדה: שומר את קובץ ה-JSON במחשב המקומי.
    • ‫Cloud Storage: שומר את קובץ ה-JSON ב-URI של Cloud Storage שצוין.

ייבוא כלי

יש שני תהליכי עבודה לייבוא כלי:

ייבוא להחלפה

אפשר להשתמש באפשרות הזו כדי לשנות כלי קיים. קובץ ה-JSON המיובא חייב להתאים לסוג הכלי הנוכחי.

  1. פותחים את מסוף CX Agent Studio ובוחרים את הפרויקט והסוכן.
  2. פותחים את החלונית Tool (כלי).
  3. לוחצים על תפריט ההקשר של הכלי שרוצים לעדכן.
  4. בוחרים באפשרות ייבוא להחלפה.
  5. בתיבת הדו-שיח, בוחרים אחת מהאפשרויות הבאות:
    • העלאת JSON: בוחרים קובץ JSON מהמחשב המקומי.
    • ‫Cloud Storage: מזינים את ה-URI של קובץ JSON ב-Cloud Storage.

ייבוא כחדש

אפשר להשתמש באפשרות הזו כדי ליצור כלי חדש.

  1. פותחים את מסוף CX Agent Studio ובוחרים את הפרויקט והסוכן.
  2. פותחים את החלונית Create Tool (כלי ליצירה).
  3. בוחרים באפשרות ייבוא כחדש.
  4. בתיבת הדו-שיח, בוחרים אחת מהאפשרויות הבאות:
    • העלאת JSON: בוחרים קובץ JSON מהמחשב המקומי.
    • ‫Cloud Storage: מזינים את ה-URI של קובץ JSON ב-Cloud Storage.