‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שימוש בכלי לחיפוש קבצים של Google Gemini ל-RAG

1. מבוא

ב-Codelab הזה נסביר איך להשתמש בחיפוש קבצים ב-Gemini כדי להפעיל RAG באפליקציית הסוכן שלכם. תשתמשו בחיפוש הקבצים ב-Gemini כדי להטמיע את המסמכים שלכם וליצור להם אינדקס, בלי שתצטרכו לדאוג לפרטים של חלוקה לחלקים, הטמעה או מסד נתונים וקטורי.

מה תלמדו

הסבר על RAG ולמה אנחנו צריכים אותו.
מה זה Gemini File Search והיתרונות שלו.
איך יוצרים מאגר לחיפוש קבצים.
איך מעלים קבצים בהתאמה אישית למאגר חיפוש הקבצים.
איך משתמשים בכלי חיפוש הקבצים של Gemini ב-RAG.
היתרונות של שימוש בערכה לפיתוח סוכנים (ADK) של Google.
איך משתמשים בכלי חיפוש הקבצים של Gemini בפתרון מבוסס-סוכן שנבנה באמצעות ה-ADK.
איך משתמשים בכלי חיפוש הקבצים של Gemini לצד כלים 'מובנים' של Google כמו חיפוש Google.

מה עושים

יוצרים פרויקט ב-Google Cloud ומגדירים את סביבת הפיתוח.
יוצרים סוכן פשוט מבוסס-Gemini באמצעות Google Gen AI SDK (אבל ללא ADK) שיש לו יכולת להשתמש בחיפוש Google, אבל אין לו יכולת RAG.
להוכיח שהיא לא מסוגלת לספק מידע מדויק ואיכותי לגבי מידע בהתאמה אישית.
ליצור מחברת Jupyter (שאפשר להריץ באופן מקומי, או למשל ב-Google Colab) כדי ליצור ולנהל מאגר של Gemini לחיפוש קבצים.
אפשר להשתמש במחברת כדי להעלות תוכן בהתאמה אישית למאגר החיפוש של קבצים.
תיצור סוכן עם חנות לחיפוש קבצים שמחוברת אליו, ותוכיח שהוא מסוגל לספק תשובות טובות יותר.
המרת סוכן 'בסיסי' ראשוני לסוכן ADK, כולל כלי חיפוש Google.
בודקים את הסוכן באמצעות ממשק המשתמש האינטרנטי של ADK.
משלבים את מאגר חיפוש הקבצים בסוכן ADK באמצעות התבנית Agent-As-A-Tool כדי לאפשר שימוש בכלי לחיפוש קבצים לצד הכלי לחיפוש Google.

2. מה זה RAG ולמה אנחנו צריכים את זה

אז... Retrieval Augmented Generation.

אם הגעתם לכאן, כנראה שאתם יודעים מה זה, אבל בכל זאת נסביר בקצרה. מודלים מסוג LLM (כמו Gemini) הם מבריקים, אבל יש להם כמה בעיות:

הם תמיד לא מעודכנים: הם יודעים רק את מה שהם למדו במהלך האימון.
הם לא יודעים הכול: נכון, המודלים הם עצומים, אבל הם לא יודעים הכול.
הם לא יודעים את המידע הקנייני שלכם: יש להם ידע רחב, אבל הם לא קראו את המסמכים הפנימיים, הבלוגים או הכרטיסים שלכם ב-Jira.

לכן, כששואלים מודל שאלה שהוא לא יודע את התשובה שלה, בדרך כלל מקבלים תשובה שגויה או אפילו תשובה מומצאת. לרוב, המודל יציג את התשובה השגויה הזו בביטחון. מצב כזה נקרא הזיה.

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

זמן אחזור: תגובות איטיות יותר ויותר מהמודל.
היחלשות האות, או 'אובדן באמצע': מצב שבו המודל כבר לא מצליח למיין את הנתונים הרלוונטיים מתוך הנתונים הלא רלוונטיים. המודל מתעלם מחלק גדול מההקשר.
עלות: כי טוקנים עולים כסף.
מיצוי חלון ההקשר: בשלב הזה, Gemini לא יבצע את הבקשות שלכם.

דרך יעילה הרבה יותר לפתור את הבעיה הזו היא באמצעות RAG. זה פשוט תהליך של חיפוש מידע רלוונטי ממקורות הנתונים שלכם (באמצעות התאמה סמנטית) והזנת נתחים רלוונטיים של הנתונים האלה למודל לצד השאלה שלכם. הוא מעגן את המודל במציאות שלכם.

התהליך מתבצע כך: מייבאים נתונים חיצוניים, מחלקים את הנתונים למקטעים, ממירים את הנתונים להטמעות וקטוריות, ואז מאחסנים את ההטמעות האלה ומבצעים עליהן אינדוקס במסד נתונים וקטורי מתאים.

לכן, כדי להטמיע RAG, בדרך כלל צריך לדאוג לגבי:

מפעיל מסד נתונים וקטורי (Pinecone, ‏ Weaviate, ‏ Postgres עם pgvector...).
כתיבת סקריפט לחלוקת המסמכים (למשל, קובצי PDF, קובצי Markdown וכו').
יצירת הטמעות (וקטורים) עבור החלקים האלה באמצעות מודל הטמעה.
אחסון הווקטורים במסד הנתונים הווקטורי.

אבל חברים לא מאפשרים לחברים לתכנן דברים בצורה מוגזמת. מה אם אגיד לך שיש דרך קלה יותר?

3. דרישות מוקדמות

יצירת פרויקט ב-Google Cloud

כדי להשתמש ב-Codelab הזה, צריך פרויקט ב-Google Cloud. אפשר להשתמש בפרויקט קיים או ליצור פרויקט חדש.

מוודאים שהחיוב מופעל בפרויקט. במדריך הזה מוסבר איך לבדוק את סטטוס החיוב של הפרויקטים.

הערה: לא צפוי שתצטרכו לשלם על השלמת ה-codelab הזה. לכל היותר, כמה אגורות.

אפשר להכין את הפרויקט. אני אחכה.

שיבוט של מאגר ההדגמה

יצרתי מאגר עם תוכן מודרך ל-Codelab הזה. תצטרכו אותו!

מריצים את הפקודות הבאות מהטרמינל או מהטרמינל שמשולב ב-Cloud Shell Editor של Google. ‫Cloud Shell והעורך שלו נוחים מאוד, כי כל הפקודות שצריך מותקנות מראש והכול פשוט פועל 'מהקופסה'.

git clone https://github.com/derailed-dash/gemini-file-search-demo
cd gemini-file-search-demo

בעץ הזה מוצגים הקבצים והתיקיות העיקריים במאגר:

gemini-file-search-demo/
├── app/
│   ├── basic_agent_adk/        # Agent with Google Search, using ADK framework
│   │   └── agent.py
│   ├── rag_agent_adk/          # Agent with Google Search and File Search, using ADK framework
│   │   ├── agent.py            
│   │   └── tools_custom.py      
│   ├── sdk_agent.py            # Agent using GenAI SDK (no ADK) with Google Search tool
│   └── sdk_rag_agent.py        # Agent using GenAI SDK (no ADK) with Gemini File Search tool
├── data/
│   └── story.md                # Sample story with "bespoke content" to use with Gemini File Search Store
├── notebooks/
│   └── file_search_store.ipynb # Jupyter notebook for creating and managing Gemini File Search Store
│
├── .env.template               # Template for environment variables - make a copy as .env
├── Makefile                    # Makefile for `make` commands
├── pyproject.toml              # Project configuration and dependencies
└── README.md                   # This file

פותחים את התיקייה הזו ב-Cloud Shell Editor או בעורך המועדף. (השתמשת כבר ב-Antigravity? אם לא, עכשיו זה זמן טוב לנסות.)

שימו לב שהמאגר מכיל סיפור לדוגמה – The Wormhole Incursion – בקובץ data/story.md. כתבתי אותו ביחד עם Gemini! הספר עוסק במפקד דזבו ובטייסת שלו של חלליות בעלות תבונה. (קיבלתי השראה מהמשחק Elite Dangerous). הסיפור הזה משמש כ'מאגר ידע בהתאמה אישית', שמכיל עובדות ספציפיות ש-Gemini לא יודע, וגם לא יכול לחפש באמצעות חיפוש Google.

הגדרת סביבת הפיתוח

לנוחיותך, צירפתי Makefile כדי לפשט רבות מהפקודות שצריך להריץ. במקום לזכור פקודות ספציפיות, אפשר פשוט להריץ פקודה כמו make <target>. עם זאת, make זמין רק בסביבות Linux / MacOS / WSL. אם אתם משתמשים ב-Windows (בלי WSL), תצטרכו להריץ את הפקודות המלאות שקובצי היעד של make מכילים.

# Install dependencies with make
make install

# If you don't have make...
uv sync --extra jupyter

כך נראה הפלט כשמריצים את הפקודה make install ב-Cloud Shell Editor:

איך יוצרים מפתח Gemini API

כדי להשתמש ב-Gemini Developer API (שנדרש כדי להשתמש בכלי חיפוש הקבצים של Gemini), צריך מפתח Gemini API. הדרך הכי קלה לקבל מפתח API היא באמצעות Google AI Studio, שמספק ממשק נוח לקבלת מפתחות API לפרויקטים בענן שלכם ב-Google Cloud. השלבים הספציפיים מפורטים במדריך הזה.

אחרי שיוצרים את מפתח ה-API, מעתיקים אותו ושומרים אותו במקום בטוח.

עכשיו צריך להגדיר את מפתח ה-API הזה כמשתנה סביבה. אפשר לעשות את זה באמצעות .envקובץ. מעתיקים את הקובץ .env.example שכלול בחבילה כקובץ חדש בשם .env. הקובץ צריך להיראות כך:

export GEMINI_API_KEY="your-api-key"
export MODEL="gemini-2.5-flash"
export STORE_NAME="demo-file-store"

מחליפים את הערך your-api-key במפתח ה-API שלכם. עכשיו הוא אמור להיראות בערך כך:

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

source .env

4. הסוכן הבסיסי

קודם כל, נגדיר נקודת התחלה. נשתמש ב-google-genai SDK הגולמי כדי להריץ סוכן פשוט.

הקוד

כדאי להציץ בapp/sdk_agent.py. זו הטמעה מינימלית שכוללת:

יוצר מופע של genai.Client.
הפעלה של הכלי google_search.
זה הכול. אין RAG.

כדאי לעיין בקוד ולוודא שאתם מבינים מה הוא עושה.

הפעלת התכונה

# With make
make sdk-agent

# Without make
uv run python app/sdk_agent.py

נשאל אותו שאלה כללית:

> What is the stock price of Google?

הוא צריך לענות נכון באמצעות חיפוש Google כדי למצוא את המחיר הנוכחי:

עכשיו נשאל שאלה שהוא לא יודע לענות עליה. היא מחייבת את הסוכן לקרוא את הסיפור שלנו.

> Who pilots the 'Too Many Pies' ship?

הוא עלול להיכשל או אפילו להמציא תשובות. בוא נראה:

ואכן, המודל לא מצליח לענות על השאלה. הוא לא יודע על מה אנחנו מדברים!

עכשיו מקלידים quit כדי לצאת מהסוכן.

5. הסבר על חיפוש קבצים באמצעות Gemini

חיפוש קבצים ב-Gemini הוא בעצם שילוב של שני דברים:

מערכת RAG בניהול מלא: אתם מספקים קבוצה של קבצים, וכלי חיפוש הקבצים של Gemini מטפל בשבירת הקבצים לחלקים, בהטמעה, באחסון ובאינדוקס וקטורי בשבילכם.
כ'כלי' במובן של סוכן: אפשר פשוט להוסיף את כלי חיפוש הקבצים של Gemini ככלי בהגדרת הסוכן, ולהפנות את הכלי אל מאגר חיפוש קבצים.

אבל מה שחשוב לדעת: הוא מובנה ב-Gemini API עצמו. כלומר, לא צריך להפעיל ממשקי API נוספים או לפרוס מוצרים נפרדים כדי להשתמש בו. אז זה באמת out-of-the-box.

התכונות של Gemini לחיפוש קבצים

אלה כמה מהתכונות:

פרטי החלוקה לחלקים, ההטמעה, האחסון והאינדוקסציה מוסתרים מכם, המפתחים. זה אומר שלא צריך לדעת (או להתעניין) במודל ההטמעה (שהוא Gemini Embeddings, אגב), או איפה מאוחסנים הווקטורים שמתקבלים. אין צורך לקבל החלטות לגבי מסד נתונים וקטורי.
הוא תומך במספר עצום של סוגי מסמכים. כולל, בין היתר: PDF,‏ DOCX,‏ Excel,‏ SQL,‏ JSON, מחברות Jupyter,‏ HTML,‏ Markdown,‏ CSV ואפילו קובצי zip. הרשימה המלאה מפורטת כאן. לדוגמה, אם רוצים להצמיד את הסוכן לקובצי PDF שמכילים טקסט, תמונות וטבלאות, לא צריך לבצע עיבוד מראש של קובצי ה-PDF האלה. פשוט מעלים את קובצי ה-PDF הגולמיים, ו-Gemini כבר יעשה את כל השאר.
אנחנו יכולים להוסיף מטא-נתונים מותאמים אישית לכל קובץ שמועלה. האפשרות הזו יכולה להיות שימושית מאוד לסינון קבצים שבהם רוצים שהכלי ישתמש, בזמן הריצה.

איפה הנתונים נמצאים?

אתם מעלים קבצים. כלי חיפוש הקבצים של Gemini לקח את הקבצים האלה, יצר את החלקים, ואז את ההטמעות, והניח אותם… איפשהו. אבל איפה?

התשובה: מאגר חיפוש קבצים. זהו קונטיינר מנוהל לחלוטין להטמעות שלכם. אתם לא צריכים לדעת (או להתעניין) איך זה קורה מאחורי הקלעים. כל מה שצריך לעשות הוא ליצור אחת (באמצעות תכנות) ואז להעלות אליה את הקבצים.

זה זול!

האחסון והשאילתות של ההטמעות הם בחינם. כך תוכלו לאחסן הטמעות כמה זמן שתרצו, ולא תצטרכו לשלם על האחסון הזה.

למעשה, הדבר היחיד שאתם משלמים עליו הוא יצירת ההטמעות בזמן ההעלאה או היצירה של האינדקס. בזמן כתיבת המאמר הזה, העלות היא 0.15 $למיליון טוקנים. זה די זול.

6. איך משתמשים בחיפוש קבצים ב-Gemini

יש שני שלבים:

ליצור את ההטמעות ולאחסן אותן במאגר לחיפוש קבצים.
שליחת שאילתה למאגר של חיפוש הקבצים מהסוכן.

שלב 1 – יצירה וניהול של מאגר לחיפוש קבצים ב-Gemini באמצעות Jupyter Notebook

השלב הזה מתבצע בהתחלה, וגם בכל פעם שרוצים לעדכן את החנות. לדוגמה, כשרוצים להוסיף מסמכים חדשים או כשמסמכי המקור השתנו.

אתם לא צריכים לארוז את השלב הזה באפליקציה של הסוכן שפרסתם. בטח, אם רוצים. לדוגמה, אם רוצים ליצור ממשק משתמש כלשהו למשתמשים עם הרשאות אדמין באפליקציה מבוססת-הסוכן. אבל לעיתים קרובות מספיק להריץ קטע קוד לפי דרישה. מהי דרך מצוינת להריץ את הקוד הזה לפי דרישה? מחברת Jupyter!

הנוטבוק

פותחים את הקובץ notebooks/file_search_store.ipynb בכלי העריכה. אם מוצגת בקשה להתקין תוספים של Jupyter VS Code, צריך להתקין אותם.

אם פותחים אותו ב-Cloud Shell Editor, הוא נראה כך:

נריץ אותו תא אחרי תא. מתחילים בהרצת התא Setup עם הייבוא הנדרש. אם לא הפעלתם מחברת בעבר, תתבקשו להתקין את התוספים הנדרשים. אפשר לעשות את זה. לאחר מכן תתבקשו לבחור ליבה. בוחרים באפשרות Python environments... ואז ב-.venv המקומי שהתקנו כשביצענו את הפקודה make install קודם:

לאחר מכן:

מריצים את התא Local Only כדי לאחזר את משתני הסביבה.
מריצים את התא Client Initialisation כדי לאתחל את Gemini Gen AI Client.
מריצים את התא Retrieve the Store (אחזור המאגר) עם פונקציית העזר לאחזור מאגר Gemini File Search לפי שם.

עכשיו אפשר ליצור את החנות.

מריצים את התא Create the Store (One Time) כדי ליצור את החנות. צריך לעשות את זה רק פעם אחת. אם הקוד יפעל בהצלחה, תוצג ההודעה "Created store: fileSearchStores/<someid>"
מריצים את התא View the Store כדי לראות מה יש בו. בשלב הזה, אמור להופיע שהמאגר מכיל 0 מסמכים.

מצוין! יש לנו עכשיו חנות מוכנה לשימוש של Gemini File Search.

העלאת הנתונים

אנחנו רוצים להעלות את data/story.md לחנות. בצע את הפעולות הבאות:

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

שלב 2 – הטמעה של RAG לחיפוש קבצים ב-Gemini בסוכן שלנו

יצרנו מאגר של חיפוש קבצים ב-Gemini והעלינו אליו את הסיפור שלנו. עכשיו הגיע הזמן להשתמש במאגר החיפוש של קבצים בסוכן שלנו. בואו ניצור סוכן חדש שמשתמש במאגר File Search Store במקום בחיפוש Google. כדאי להציץ בapp/sdk_rag_agent.py.

הדבר הראשון שחשוב לשים לב אליו הוא שהטמענו פונקציה לאחזור החנות שלנו על ידי העברת שם החנות:

def get_store(client: genai.Client, store_name: str) -> types.FileSearchStore | None:
    """Retrieve a store by display name"""
    try:
        for a_store in client.file_search_stores.list():
            if a_store.display_name == store_name:
                return a_store
    except Exception as e:
        logger.error(f"Error listing stores: {e}")
    return None

אחרי שיוצרים את החנות, השימוש בה פשוט כמו צירוף שלה ככלי לסוכן, כך:

   file_search_tool = types.Tool(file_search=types.FileSearch(file_search_store_names=[store.name]))

הרצת סוכן RAG

כך מפעילים אותו:

make sdk-rag-agent

# Or, without make:
uv run python app/sdk_rag_agent.py

נשאל את השאלה שהסוכן הקודם לא הצליח לענות עליה:

> Who pilots the 'Too Many Pies' ship?

מה התשובה?

הצלחת! מהתשובה אפשר לראות ש:

התשובה לשאלה מבוססת על קבצים ששמורים במאגר הקבצים שלנו.
נמצאו 5 קטעים רלוונטיים.
התשובה מדויקת!

מקישים על quit כדי לסגור את הסוכן.

7. המרת הסוכנים שלנו לשימוש ב-ADK

‫Agent Development Kit (ADK) של Google הוא ערכת SDK ומסגרת מודולרית בקוד פתוח, שמאפשרת למפתחים ליצור סוכנים ומערכות מבוססות-סוכנים. היא מאפשרת לנו ליצור ולתזמר בקלות מערכות מרובות סוכנים. הערכה ADK מותאמת ל-Gemini ולסביבת Google, אבל היא מתאימה לכל המודלים, לא תלויה בפריסה מסוימת, והיא מיועדת לתאימות למסגרות אחרות. אם עדיין לא השתמשתם ב-ADK, כדאי לעיין במסמכי ה-ADK כדי לקבל מידע נוסף.

סוכן ADK בסיסי עם חיפוש Google

כדאי להציץ בapp/basic_agent_adk/agent.py. בדוגמה הזו של קוד לדוגמה אפשר לראות שהטמענו שני סוכנים:

root_agent שמטפל באינטראקציה עם המשתמש, ושבו סיפקנו את ההוראה העיקרית למערכת.
‫SearchAgent נפרד שמשתמש ב-google.adk.tools.google_search ככלי.

‫root_agent משתמש בפועל ב-SearchAgent ככלי, והוא מיושם באמצעות השורה הזו:

   tools=[AgentTool(agent=search_agent)],

ההנחיה למערכת של הסוכן הראשי נראית כך:

You are a helpful AI assistant designed to provide accurate and useful information.
If you don't know the answer, use the SearchAgent to perform a Google search.
Do not attempt to search more than ONCE.
If the search yields no relevant results or returns unrelated content, you MUST immediately respond with: "I could not find any information about that."
Do NOT retry the search with different terms. Do NOT ask for clarification. FAIL FAST.

איך מנסים את Agent

‫ADK מספק מספר ממשקים מוכנים מראש כדי לאפשר למפתחים לבדוק את סוכני ה-ADK שלהם. אחד מהממשקים האלה הוא ממשק המשתמש האינטרנטי. כך אנחנו יכולים לבדוק את הסוכנים שלנו בדפדפן, בלי לכתוב שורה אחת של קוד ממשק משתמש.

כדי להפעיל את הממשק הזה, מריצים את הפקודה:

make adk-playground

# Or, without make:
uv run adk web app --port 8501 --reload_agents

שימו לב שהפקודה מפנה את הכלי adk web לתיקייה app, שבה הוא יזהה באופן אוטומטי סוכני ADK שמטמיעים root_agent. אז בואו ננסה:

אחרי כמה שניות, האפליקציה מוכנה. אם מריצים את הקוד באופן מקומי, פשוט מפנים את הדפדפן אל http://127.0.0.1:8501. אם אתם מריצים את האפליקציה ב-Cloud Shell Editor, לוחצים על Web preview ומשנים את היציאה ל-8501:

כשממשק המשתמש מופיע, בוחרים באפשרות basic_agent_adk מהתפריט הנפתח, ואז אפשר לשאול אותו שאלות:

עד עכשיו, הכול טוב ויפה. בממשק המשתמש האינטרנטי אפשר לראות גם מתי סוכן הבסיס מעביר את הטיפול לסוכן SearchAgent. זו תכונה מאוד שימושית.

עכשיו נשאל אותו את השאלה שלנו שדורשת ידע על הסיפור:

רוצים לנסות? הוא אמור להיכשל במהירות, בדיוק כמו שצוין.

שילוב מאגר לחיפוש קבצים בסוכן ADK

עכשיו נסכם את כל מה שלמדנו. אנחנו הולכים להריץ סוכן ADK שיכול להשתמש גם במאגר לחיפוש קבצים וגם בחיפוש Google. בודקים את הקוד ב-app/rag_agent_adk/agent.py.

הקוד דומה לדוגמה הקודמת, אבל יש כמה הבדלים חשובים:

יש לנו סוכן ברמה הבסיסית (root) שמנהל שני סוכנים מומחים:
‫RagAgent: מומחה ידע בהתאמה אישית – באמצעות מאגר חיפוש הקבצים של Gemini
‫SearchAgent: מומחה לידע כללי – שימוש בחיפוש Google
מכיוון של-ADK אין wrapper מובנה ל-FileSearch, אנחנו משתמשים במחלקה FileSearchTool של wrapper בהתאמה אישית כדי לעטוף את הכלי FileSearch, שמוסיף את ההגדרה file_search_store_names לבקשת המודל ברמה הנמוכה. ההגדרה הזו הוטמעה בסקריפט הנפרד app/rag_agent_adk/tools_custom.py.

יש גם מלכודת שכדאי להיזהר ממנה. בזמן כתיבת המאמר הזה, אי אפשר להשתמש בכלי המקורי GoogleSearch ובכלי FileSearch באותה בקשה לאותו סוכן. אם תנסו, תקבלו שגיאה כזו:

שגיאה – אירעה שגיאה: 400 INVALID_ARGUMENT. ‪{'error': {‘code': 400, ‘message': ‘Search as a tool and file search tool are not supported together', ‘status': ‘INVALID_ARGUMENT'}}

שגיאה: 400 INVALID_ARGUMENT. ‪{'error': {‘code': 400, ‘message': ‘Search as a tool and file search tool are not supported together', ‘status': ‘INVALID_ARGUMENT'}}

הפתרון הוא להטמיע את שני הסוכנים המומחים כסוכני משנה נפרדים, ולהעביר אותם לסוכן הבסיסי באמצעות התבנית Agent-as-a-Tool. ובאופן מכריע, הוראות המערכת של סוכן הבסיס מספקות הנחיות ברורות מאוד לשימוש ב-RagAgent קודם:

אתה עוזר אישי מבוסס-AI שנועד לספק מידע מדויק ושימושי.

יש לך גישה לשני נציגים מומחים:

‫RagAgent: לקבלת מידע מותאם אישית ממאגר הידע הפנימי.
SearchAgent: לקבלת מידע כללי מחיפוש Google.

תמיד כדאי לנסות קודם את RagAgent. אם לא מתקבלת תשובה מועילה, כדאי לנסות את SearchAgent.

Final Test

מריצים את ממשק האינטרנט של ADK כמו קודם:

make adk-playground

# Or, without make:
uv run adk web app --port 8501 --reload_agents

הפעם, בוחרים באפשרות rag_agent_adk בממשק המשתמש. הנה דוגמה:

אפשר לראות שהמערכת בוחרת את הסוכן המשני המתאים על סמך השאלה.

8. סיכום

כל הכבוד, סיימתם את ה-Codelab הזה!

עברתם מסקריפט פשוט למערכת מרובת סוכנים עם RAG, בלי לכתוב שורת קוד אחת של הטמעה ובלי להטמיע מסד נתונים וקטורי.

למדנו:

‫Gemini File Search הוא פתרון RAG מנוהל שחוסך זמן ומאפשר לכם לשמור על שפיות.
ADK מספק לנו את המבנה שדרוש לאפליקציות מורכבות מרובות סוכנים, ומציע למפתחים נוחות שימוש באמצעות ממשקים כמו ממשק המשתמש באינטרנט.
התבנית "Agent-as-a-Tool" פותרת בעיות תאימות של כלים.

מקווים שהתרגיל הזה היה מועיל. נתראה בפעם הבאה!