🤖 Graph RAG, ADK āĻ“ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āϕ⧇āϰ āϏāĻžāĻšāĻžāĻ¯ā§āϝ⧇ āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ AI āĻāĻœā§‡āĻ¨ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻž

ā§§. āĻ­ā§‚āĻŽāĻŋāĻ•āĻž

āĻ•āĻ­āĻžāϰ

ā§§. āĻšā§āϝāĻžāϞ⧇āĻžā§āϜ

āĻĻ⧁āĻ°ā§āϝ⧋āϗ⧇āϰ āϏāĻŽā§Ÿ āωāĻĻā§āϧāĻžāϰāĻ•āĻžāĻœā§‡, āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āϞ⧋āϕ⧇āĻļāύ⧇ āĻĨāĻžāĻ•āĻž āĻŦ⧇āρāĻšā§‡ āϝāĻžāĻ“ā§ŸāĻž āĻŦā§āϝāĻ•ā§āϤāĻŋāĻĻ⧇āϰ āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āĻĻāĻ•ā§āώāϤāĻž, āϰāĻŋāϏ⧋āĻ°ā§āϏ āĻ“ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ āĻ…āύ⧁āϝāĻžā§Ÿā§€ āϏāĻŽāĻ¨ā§āĻŦ⧟ āĻ•āϰāϤ⧇, āχāĻ¨ā§āĻŸā§‡āϞāĻŋāĻœā§‡āĻ¨ā§āϟ āĻĄā§‡āϟāĻž āĻŽā§āϝāĻžāύ⧇āϜāĻŽā§‡āĻ¨ā§āϟ āĻ“ āϏāĻžāĻ°ā§āϚ āĻ•āϰāĻžāϰ āĻ•ā§āώāĻŽāϤāĻž āĻĒā§āĻ°ā§Ÿā§‹āϜāύāĨ¤ āĻāχ āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻļāĻĒ⧇ āφāĻĒāύāĻŋ āĻĒā§āϰ⧋āĻĄāĻžāĻ•āĻļāύ AI āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽ āϤ⧈āϰāĻŋ āĻ•āϰāϤ⧇ āĻļāĻŋāĻ–āĻŦ⧇āύ āϝāĻž āĻāϗ⧁āϞāĻŋ āĻāĻ•āĻ¤ā§āϰāĻŋāϤ āĻ•āϰ⧇:

  1. đŸ—„ī¸ āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ (Spanner): āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻž āĻŦā§āϝāĻ•ā§āϤāĻŋ, āĻĻāĻ•ā§āώāϤāĻž āĻ“ āϰāĻŋāϏ⧋āĻ°ā§āϏ⧇āϰ āĻŽāĻ§ā§āϝ⧇ āϜāϟāĻŋāϞ āϏāĻŽā§āĻĒāĻ°ā§āĻ• āĻ¸ā§āĻŸā§‹āϰ āĻ•āϰ⧁āύ
  2. 🔍 AI-āĻĒāϰāĻŋāϚāĻžāϞāĻŋāϤ āϏāĻžāĻ°ā§āϚ: āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āϏ⧇āĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• + āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āϚ
  3. 📸 āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āĻĒā§āϰāϏ⧇āϏāĻŋāĻ‚: āĻ›āĻŦāĻŋ, āĻŸā§‡āĻ•ā§āϏāϟ āĻ“ āĻ­āĻŋāĻĄāĻŋāĻ“ āĻĨ⧇āϕ⧇ āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāĻ°ā§āĻĄ āĻĄā§‡āϟāĻž āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰ⧁āύ
  4. 🤖 āĻŽāĻžāĻ˛ā§āϟāĻŋ-āĻāĻœā§‡āĻ¨ā§āϟ āĻ…āĻ°ā§āϕ⧇āĻ¸ā§āĻŸā§āϰ⧇āĻļāύ: āϜāϟāĻŋāϞ āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻĢā§āϞ⧋āϰ āϜāĻ¨ā§āϝ āĻŦāĻŋāĻļ⧇āώ āĻāĻœā§‡āĻ¨ā§āϟāĻĻ⧇āϰ āĻŽāĻ§ā§āϝ⧇ āϏāĻŽāĻ¨ā§āĻŦ⧟ āϏāĻžāϧāύ āĻ•āϰ⧁āύ
  5. 🧠 āĻĻā§€āĻ°ā§āϘāĻŽā§‡ā§ŸāĻžāĻĻā§€ āĻŽā§‡āĻŽāϰāĻŋ: Vertex AI Memory Bank-āĻāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āĻĒāĻ›āĻ¨ā§āĻĻāĻŽāϤ⧋ āϏāĻžāϜāĻŋā§Ÿā§‡ āύ⧇āĻ“ā§ŸāĻž

āĻ•āĻĨā§‹āĻĒāĻ•āĻĨāύ

⧍. āφāĻĒāύāĻŋ āϕ⧀ āϤ⧈āϰāĻŋ āĻ•āϰāĻŦ⧇āύ

āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ āύ⧇āϟāĻ“ā§ŸāĻžāĻ°ā§āĻ• āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ āϝāĻžāϤ⧇ āĻāϗ⧁āϞāĻŋ āφāϛ⧇:

  • đŸ—ēī¸ āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻž āĻŦā§āϝāĻ•ā§āϤāĻŋāĻĻ⧇āϰ āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇āϰ 3D āχāĻ¨ā§āϟāĻžāĻ°â€ā§āϝāĻžāĻ•ā§āϟāĻŋāĻ­ āĻ—ā§āϰāĻžāĻĢ āĻ­āĻŋāĻœā§āϝ⧁āϝāĻŧāĻžāϞāĻžāχāĻœā§‡āĻļāύ
  • 🔍 āχāĻ¨ā§āĻŸā§‡āϞāĻŋāĻœā§‡āĻ¨ā§āϟ āϏāĻžāĻ°ā§āϚ (āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ, āϏ⧇āĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻ“ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ)
  • 📸 āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āφāĻĒāϞ⧋āĻĄ āĻĒāĻžāχāĻĒāϞāĻžāχāύ (āĻ›āĻŦāĻŋ/āĻ­āĻŋāĻĄāĻŋāĻ“ āĻĨ⧇āϕ⧇ āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž)
  • 🤖 āϜāϟāĻŋāϞ āϟāĻžāĻ¸ā§āĻ• āĻ…āĻ°ā§āϕ⧇āĻ¸ā§āĻŸā§āϰ⧇āĻļāύ⧇āϰ āϜāĻ¨ā§āϝ āĻŽāĻžāĻ˛ā§āϟāĻŋ-āĻāĻœā§‡āĻ¨ā§āϟ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽ
  • 🧠 āĻĒāĻ›āĻ¨ā§āĻĻāĻŽāϤ⧋ āχāĻ¨ā§āϟāĻžāĻ°â€ā§āϝāĻžāĻ•āĻļāύ⧇āϰ āϜāĻ¨ā§āϝ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āχāĻ¨ā§āϟāĻŋāĻ—ā§āϰ⧇āĻļāύ

ā§Š. Core Technologies

āĻ•āĻŽā§āĻĒā§‹āύ⧇āĻ¨ā§āϟ

āĻĒā§āϰāϝ⧁āĻ•ā§āϤāĻŋ

āωāĻĻā§āĻĻ⧇āĻļā§āϝ

āĻĄā§‡āϟāĻžāĻŦ⧇āϏ

Cloud Spanner Graph

āύ⧋āĻĄ (āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ, āĻĻāĻ•ā§āώāϤāĻž) āĻāĻŦāĻ‚ āĻāϜ (āϏāĻŽā§āĻĒāĻ°ā§āĻ•) āĻ¸ā§āĻŸā§‹āϰ āĻ•āϰ⧁āύ

AI āϏāĻžāĻ°ā§āϚ

Gemini + Embeddings

āĻļāĻŦā§āĻĻ⧇āϰ āĻ…āĻ°ā§āĻĨāĻ—āϤ āĻŽāĻŋāϞ āĻŦā§‹āĻāĻž + āĻŽāĻŋāϞ āφāϛ⧇ āĻāĻŽāύ āϏāĻžāĻ°ā§āϚ

āĻāĻœā§‡āĻ¨ā§āϟ āĻĢā§āϰ⧇āĻŽāĻ“ā§ŸāĻžāĻ°ā§āĻ•

ADK (āĻāĻœā§‡āĻ¨ā§āϟ āĻĄā§‡āϭ⧇āϞāĻĒāĻŽā§‡āĻ¨ā§āϟ āĻ•āĻŋāϟ)

AI āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻĢā§āϞ⧋ āĻ…āĻ°ā§āϕ⧇āĻ¸ā§āĻŸā§āϰ⧇āϟ āĻ•āϰ⧁āύ

āĻŽā§‡āĻŽāϰāĻŋ

Vertex AI āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ•

āĻĻā§€āĻ°ā§āϘāĻŽā§‡ā§ŸāĻžāĻĻā§€ āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āĻĒāĻ›āĻ¨ā§āĻĻ āϏāĻŽā§āĻĒāĻ°ā§āĻ•āĻŋāϤ āĻ¸ā§āĻŸā§‡āĻžāϰ⧇āϜ

Frontend

React + Three.js

āχāĻ¨ā§āϟāĻžāĻ°â€ā§āϝāĻžāĻ•ā§āϟāĻŋāĻ­ 3D āĻ—ā§āϰāĻžāĻĢ āĻ­āĻŋāĻœā§āϝ⧁āϝāĻŧāĻžāϞāĻžāχāĻœā§‡āĻļāύ

⧍. đŸ› ī¸ āĻāύāĻ­āĻžā§ŸāϰāύāĻŽā§‡āĻ¨ā§āϟ āĻĒā§āϰāĻ¸ā§āϤ⧁āϤāĻŋ (āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻļāĻĒ⧇ āĻĨāĻžāĻ•āϞ⧇ āĻāϟāĻŋ āĻā§œāĻŋā§Ÿā§‡ āϝāĻžāύ)

āĻĒā§āϰāĻĨāĻŽ āĻ­āĻžāĻ—: āĻŦāĻŋāϞāĻŋāĻ‚ āĻ…ā§āϝāĻžāĻ•āĻžāωāĻ¨ā§āϟ āϚāĻžāϞ⧁ āĻ•āϰāĻž

āĻāχ āϕ⧋āĻĄāĻ˛ā§āϝāĻžāĻŦ āϰāĻžāύ āĻ•āϰāϤ⧇, āφāĻĒāύāĻžāϰ āĻāĻ•āϟāĻŋ āĻŦāĻŋāϞāĻŋāĻ‚ āĻ…ā§āϝāĻžāĻ•āĻžāωāĻ¨ā§āϟ āĻĒā§āϰāϝāĻŧā§‹āϜāύ āϝāĻžāϤ⧇ āĻ•āĻŋāϛ⧁ āĻ•ā§āϰ⧇āĻĄāĻŋāϟ āφāϛ⧇āĨ¤ āĻļ⧁āϰ⧁ āĻ•āϰāϤ⧇ āĻāχ āϕ⧋āĻĄāĻ˛ā§āϝāĻžāĻŦ⧇āϰ āωāĻĒāϰ⧇ āĻŦā§āϝāĻžāύāĻžāϰ⧇ āĻĻ⧇āĻ–āĻžāύ⧋ āĻ•ā§āϰ⧇āĻĄāĻŋāϟ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧁āύāĨ¤ āφāĻĒāύāĻŋ āφāϗ⧇ āĻĨ⧇āϕ⧇āχ āϕ⧋āύāĻ“ āĻŦāĻŋāϞāĻŋāĻ‚ āĻ…ā§āϝāĻžāĻ•āĻžāωāĻ¨ā§āĻŸā§‡āϰ āϏāĻžāĻĨ⧇ āĻ•āĻžāύ⧇āĻ•ā§āϟ āĻ•āϰ⧇ āĻĨāĻžāĻ•āϞ⧇, āĻāχ āϧāĻžāĻĒāϟāĻŋ āĻāĻĄāĻŧāĻŋā§Ÿā§‡ āϝ⧇āϤ⧇ āĻĒāĻžāϰ⧇āύāĨ¤

āĻĒāĻžāĻ°ā§āϟ āϟ⧁: āĻ“āĻĒ⧇āύ āĻāύāĻ­āĻžā§ŸāϰāύāĻŽā§‡āĻ¨ā§āϟ

  1. 👉 āϏāϰāĻžāϏāϰāĻŋ Cloud Shell Editor-āĻ āύ⧇āĻ­āĻŋāϗ⧇āϟ āĻ•āϰāϤ⧇ āĻāχ āϞāĻŋāĻ™ā§āϕ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ
  2. 👉 āφāϜ āϝ⧇āϕ⧋āύāĻ“ āϏāĻŽā§Ÿ āĻ…āύ⧁āĻŽā§‹āĻĻāύ āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āĻĒā§āϰāĻŽā§āĻĒāϟ āĻ•āϰāĻž āĻšāϞ⧇, āϚāĻžāϞāĻŋā§Ÿā§‡ āϝ⧇āϤ⧇ āĻ…āύ⧁āĻŽā§‹āĻĻāύ āĻ•āϰ⧁āύ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤ Cloud Shell āĻ…āύ⧁āĻŽā§‹āĻĻāύ āĻ•āϰāϤ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ
  3. 👉 āĻ¸ā§āĻ•ā§āϰāĻŋāύ⧇āϰ āύāĻŋāĻšā§‡ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āĻĻ⧇āĻ–āĻž āύāĻž āϗ⧇āϞ⧇, āĻāϟāĻŋ āϖ⧁āϞ⧁āύ:
    • āĻĻ⧇āϖ⧁āύ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ
    • āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞCloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āύāϤ⧁āύ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āϖ⧁āϞ⧁āύ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ
  4. 👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āφāĻĒāύāĻŋ āφāϗ⧇ āĻĨ⧇āϕ⧇āχ āϝāĻžāϚāĻžāχāĻ•ā§ƒāϤ āĻ•āĻŋāύāĻž āĻāĻŦāĻ‚ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟāϟāĻŋ āφāĻĒāύāĻžāϰ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āφāχāĻĄāĻŋāϤ⧇ āϏ⧇āϟ āĻ•āϰāĻž āφāϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ:
    gcloud auth list
    
  5. 👉đŸ’ģ GitHub āĻĨ⧇āϕ⧇ āĻŦ⧁āϟāĻ¸ā§āĻŸā§āĻ°ā§āϝāĻžāĻĒ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āĻ•ā§āϞ⧋āύ āĻ•āϰ⧁āύ:
    git clone https://github.com/gca-americas/way-back-home.git
    

āĻĒāĻžāĻ°ā§āϟ āϤāĻŋāύ: āύāϤ⧁āύ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻž

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, init āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āĻāĻ•ā§āϏāĻŋāĻ•āĻŋāωāĻŸā§‡āĻŦāϞ āĻ•āϰ⧁āύ āĻāĻŦāĻ‚ āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2
./init.sh

ā§Š. đŸ› ī¸ āĻāύāĻ­āĻžā§ŸāϰāύāĻŽā§‡āĻ¨ā§āϟ āϏ⧇āϟ-āφāĻĒ

ā§§. Cloud Shell āϖ⧁āϞ⧁āύ

Cloud Shell Editor āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻ¸ā§āĻ•ā§āϰāĻŋāύ⧇āϰ āύāĻŋāĻšā§‡ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āĻĻ⧇āĻ–āĻž āύāĻž āϗ⧇āϞ⧇, āĻāϟāĻŋ āϖ⧁āϞ⧁āύ:

  • āĻĻ⧇āϖ⧁āύ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ
  • Terminal āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ

Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āύāϤ⧁āύ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āϖ⧁āϞ⧁āύ

⧍. āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āĻ•āύāĻĢāĻŋāĻ—āĻžāϰ āĻ•āϰ⧁āύ

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āφāĻĒāύāĻžāϰ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āφāχāĻĄāĻŋ āϏ⧇āϟ āĻ•āϰ⧁āύ:

gcloud config set project $(cat ~/project_id.txt) --quiet

👉đŸ’ģ āĻĒā§āĻ°ā§Ÿā§‹āϜāĻ¨ā§€ā§Ÿ API āϚāĻžāϞ⧁ āĻ•āϰ⧁āύ (āĻāϤ⧇ ~⧍-ā§Š āĻŽāĻŋāύāĻŋāϟ āϏāĻŽā§Ÿ āϞāĻžāϗ⧇):

gcloud services enable compute.googleapis.com \
                       aiplatform.googleapis.com \
                       run.googleapis.com \
                       cloudbuild.googleapis.com \
                       artifactregistry.googleapis.com \
                       spanner.googleapis.com \
                       storage.googleapis.com

ā§Š. āϏ⧇āϟāφāĻĒ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āϰāĻžāύ āĻ•āϰ⧁āύ

👉đŸ’ģ āϏ⧇āϟāφāĻĒ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āĻāĻ•ā§āϏāĻŋāĻ•āĻŋāωāϟ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2
./setup.sh

āĻāϟāĻŋ āφāĻĒāύāĻžāϰ āϜāĻ¨ā§āϝ .env āϤ⧈āϰāĻŋ āĻ•āϰāĻŦ⧇āĨ¤ āφāĻĒāύāĻžāϰ cloudshell-āĻ, way_back_homeāĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āϖ⧁āϞ⧁āύāĨ¤ level_2 āĻĢā§‹āĻ˛ā§āĻĄāĻžāϰ⧇āϰ āĻŽāĻ§ā§āϝ⧇, āφāĻĒāύāĻŋ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ āϝ⧇ āφāĻĒāύāĻžāϰ āϜāĻ¨ā§āϝ .env āĻĢāĻžāχāϞ āϤ⧈āϰāĻŋ āĻ•āϰāĻž āĻšā§Ÿā§‡āϛ⧇āĨ¤ āφāĻĒāύāĻŋ āĻāϟāĻŋ āϖ⧁āρāĻœā§‡ āύāĻž āĻĒ⧇āϞ⧇, View -> Toggle Hidden File-āĻ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧇ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāϰ⧇āύāĨ¤ open_project

ā§Ē. āĻ¸ā§āϝāĻžāĻŽā§āĻĒ⧇āϞ āĻĄā§‡āϟāĻž āϞ⧋āĻĄ āĻ•āϰ⧁āύ

👉đŸ’ģ āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄā§‡ āύ⧇āĻ­āĻŋāϗ⧇āϟ āĻ•āϰ⧁āύ āĻāĻŦāĻ‚ āĻĄāĻŋāĻĒ⧇āĻ¨ā§āĻĄā§‡āĻ¨ā§āϏāĻŋ āχāύāĻ¸ā§āϟāϞ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2/backend
uv sync

👉đŸ’ģ āĻĒā§āϰāĻžāĻĨāĻŽāĻŋāĻ• āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ āĻĄā§‡āϟāĻž āϞ⧋āĻĄ āĻ•āϰ⧁āύ:

uv run python ~/way-back-home/level_2/backend/setup_data.py

āĻāϟāĻŋ āϤ⧈āϰāĻŋ āĻ•āϰ⧇:

  • Spanner āχāύāĻ¸ā§āĻŸā§āϝāĻžāĻ¨ā§āϏ (survivor-network)
  • āĻĄā§‡āϟāĻžāĻŦ⧇āϏ (graph-db)
  • āϏāĻŦ āύ⧋āĻĄ āĻ“ āĻāϜ āĻŸā§‡āĻŦāĻŋāϞ
  • āĻĒā§āϰāĻ¤ā§āϝāĻžāĻļāĻŋāϤ āφāωāϟāĻĒ⧁āϟ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āĻĒā§āϰāĻĒāĻžāĻ°ā§āϟāĻŋ āĻ—ā§āϰāĻžāĻĢ:
============================================================
SUCCESS! Database setup complete.
============================================================

Instance:  survivor-network
Database:  graph-db
Graph:     SurvivorGraph

Access your database at:
https://console.cloud.google.com/spanner/instances/survivor-network/databases/graph-db?project=waybackhome

āφāωāϟāĻĒ⧁āĻŸā§‡ Access your database at-āĻāϰ āĻĒāϰ⧇ āϞāĻŋāĻ™ā§āϕ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰāϞ⧇, āφāĻĒāύāĻŋ Google Cloud Console Spanner āϖ⧁āϞāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύāĨ¤

open_spanner

āĻāĻŦāĻ‚ āφāĻĒāύāĻŋ Google Cloud Console-āĻ Spanner āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ!

āĻ¸ā§āĻĒā§āϝāĻžāύāĻžāϰ

ā§Ē. 🚀 Spanner Studio-āϤ⧇ āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻž āĻ­āĻŋāĻœā§āϝ⧁⧟āĻžāϞāĻžāχāϜ āĻ•āϰāĻž

āĻāχ āĻ—āĻžāχāĻĄ āφāĻĒāύāĻžāϕ⧇ Spanner Studio āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āϏāϰāĻžāϏāϰāĻŋ Google Cloud Console-āĻ Survivor Network āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻž āĻ­āĻŋāĻœā§āϝ⧁āϝāĻŧāĻžāϞāĻžāχāϜ āĻ•āϰāϤ⧇ āĻāĻŦāĻ‚ āχāĻ¨ā§āϟāĻžāĻ°â€ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāϤ⧇ āϏāĻžāĻšāĻžāĻ¯ā§āϝ āĻ•āϰ⧇āĨ¤ āφāĻĒāύāĻžāϰ AI āĻāĻœā§‡āĻ¨ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻžāϰ āφāϗ⧇ āφāĻĒāύāĻžāϰ āĻĄā§‡āϟāĻž āϝāĻžāϚāĻžāχ āĻ•āϰāĻžāϰ āĻāĻŦāĻ‚ āĻ—ā§āϰāĻžāĻĢ āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāϰ āĻŦā§‹āĻāĻžāϰ āĻāϟāĻŋ āĻāĻ•āϟāĻŋ āĻĻ⧁āĻ°ā§āĻĻāĻžāĻ¨ā§āϤ āωāĻĒāĻžāϝāĻŧāĨ¤

ā§§. Spanner Studio āĻ…ā§āϝāĻžāĻ•ā§āϏ⧇āϏ āĻ•āϰ⧁āύ

  1. āĻļ⧇āώ āϧāĻžāĻĒ⧇, āϞāĻŋāĻ™ā§āϕ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧇ Spanner Studio āϖ⧁āϞāϤ⧇ āϭ⧁āϞāĻŦ⧇āύ āύāĻžāĨ¤

spanner_studio

⧍. āĻ—ā§āϰāĻžāĻĢ āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāϰ āĻŦā§‹āĻāĻž ("āĻŦāĻĄāĻŧ āĻ›āĻŦāĻŋ")

āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ āύ⧇āϟāĻ“ā§ŸāĻžāĻ°ā§āĻ• āĻĄā§‡āϟāĻžāϏ⧇āϟāϕ⧇ āĻāĻ•āϟāĻŋ āϞāϜāĻŋāĻ• āĻĒāĻžāϜāϞ āĻŦāĻž āϗ⧇āĻŽ āĻ¸ā§āĻŸā§‡āϟ āĻšāĻŋāϏ⧇āĻŦ⧇ āĻ­āĻžāĻŦ⧁āύ:

āĻāĻ¨ā§āϟāĻŋāϟāĻŋ

āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽā§‡ āĻ­ā§‚āĻŽāĻŋāĻ•āĻž

Analogy

āĻŦ⧇āρāĻšā§‡ āϝāĻžāĻ“ā§ŸāĻž āĻŦā§āϝāĻ•ā§āϤāĻŋ

āĻāĻœā§‡āĻ¨ā§āϟ/āĻĒā§āĻ˛ā§‡ā§ŸāĻžāϰ

āϖ⧇āĻ˛ā§‹ā§ŸāĻžā§œ

āĻŦāĻžā§Ÿā§‹āĻŽ

āϤāĻžāϰāĻž āϕ⧋āĻĨāĻžā§Ÿ āφāϛ⧇

āĻŽā§āϝāĻžāĻĒ āĻœā§‹āύ

āĻ¸ā§āĻ•āĻŋāϞ

āϤāĻžāϰāĻž āϕ⧀ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇

āĻ•ā§āώāĻŽāϤāĻž

āĻĒā§āĻ°ā§Ÿā§‹āϜāύ

āϤāĻžāĻĻ⧇āϰ āϕ⧀āϏ⧇āϰ āĻ…āĻ­āĻžāĻŦ (āϏāĻ‚āĻ•āϟ)

āĻ•ā§‹ā§Ÿā§‡āĻ¸ā§āϟ/āĻŽāĻŋāĻļāύ

āϰāĻŋāϏ⧇āĻžāĻ°ā§āϏ

āĻĒ⧃āĻĨāĻŋāĻŦā§€āϤ⧇ āϖ⧁āρāĻœā§‡ āĻĒāĻžāĻ“ā§ŸāĻž āφāχāĻŸā§‡āĻŽ

āϞ⧁āϟ

āϞāĻ•ā§āĻˇā§āϝ: AI āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āĻ•āĻžāϜ āĻšāϞ āĻŦāĻžāϝāĻŧā§‹āĻŽ (āϞ⧋āϕ⧇āĻļāύ āϏāĻ‚āĻ•ā§āϰāĻžāĻ¨ā§āϤ āϏ⧀āĻŽāĻžāĻŦāĻĻā§āϧāϤāĻž) āĻŦāĻŋāĻŦ⧇āϚāύāĻž āĻ•āϰ⧇ āĻĒā§āϰāϝāĻŧā§‹āϜāύ (āϏāĻŽāĻ¸ā§āϝāĻž)-āĻāϰ āϏāĻžāĻĨ⧇ āĻĻāĻ•ā§āώāϤāĻž (āϏāĻŽāĻžāϧāĻžāύ) āĻ•āĻžāύ⧇āĻ•ā§āϟ āĻ•āϰāĻžāĨ¤

🔗 āĻāϜ (āϏāĻŽā§āĻĒāĻ°ā§āĻ•):

  • SurvivorInBiome: āϞ⧇āĻžāϕ⧇āĻļāύ āĻŸā§āĻ°ā§āϝāĻžāĻ•āĻŋāĻ‚
  • SurvivorHasSkill: āĻ•ā§āώāĻŽāϤāĻžāϰ āχāύāϭ⧇āύāϟāϰāĻŋ
  • SurvivorHasNeed: āĻ…ā§āϝāĻžāĻ•ā§āϟāĻŋāĻ­ āϏāĻŽāĻ¸ā§āϝāĻžāϰ āϤāĻžāϞāĻŋāĻ•āĻž
  • SurvivorFoundResource: āφāχāĻŸā§‡āĻŽā§‡āϰ āχāύāϭ⧇āύāϟāϰāĻŋ
  • SurvivorCanHelp: āĻ…āύ⧁āĻŽāĻžāύ āĻ•āϰāĻž āϏāĻŽā§āĻĒāĻ°ā§āĻ• (AI āĻāϟāĻŋ āĻ—āĻŖāύāĻž āĻ•āϰ⧇!)

ā§Š. āĻ—ā§āϰāĻžāĻĢ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻ•āϰāĻž āĻšāĻšā§āϛ⧇

āĻĄā§‡āϟāĻžāϤ⧇ "āĻ¸ā§āĻŸā§‹āϰāĻŋ" āĻĻ⧇āĻ–āϤ⧇ āĻ•ā§Ÿā§‡āĻ•āϟāĻŋ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āϰāĻžāύ āĻ•āϰāĻž āϝāĻžāĻ•āĨ¤

Spanner Graph-āĻ GQL (āĻ—ā§āϰāĻžāĻĢ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻ˛ā§āϝāĻžāĻ™ā§āĻ—ā§ā§Ÿā§‡āϜ) āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāĻž āĻšā§ŸāĨ¤ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āϰāĻžāύ āĻ•āϰāϤ⧇, GRAPH SurvivorNetwork āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧁āύ āĻāĻŦāĻ‚ āϤāĻžāϰāĻĒāϰ⧇ āφāĻĒāύāĻžāϰ āĻŽā§āϝāĻžāϚ āĻĒā§āϝāĻžāϟāĻžāĻ°ā§āύ āϞāĻŋāϖ⧁āύāĨ¤

👉 āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ ā§§: āĻ—ā§āϞ⧋āĻŦāĻžāϞ āϰ⧋āĻ¸ā§āϟāĻžāϰ (āϕ⧇ āϕ⧋āĻĨāĻžā§Ÿ āφāϛ⧇?) āĻāϟāĻŋ āφāĻĒāύāĻžāϰ āĻĢāĻžāωāĻ¨ā§āĻĄā§‡āĻļāύ - āωāĻĻā§āϧāĻžāϰ āĻ…āĻĒāĻžāϰ⧇āĻļāύ⧇āϰ āϜāĻ¨ā§āϝ āϞ⧋āϕ⧇āĻļāύ āĻŦā§‹āĻāĻž āĻ…āĻ¤ā§āϝāĻ¨ā§āϤ āϗ⧁āϰ⧁āĻ¤ā§āĻŦāĻĒā§‚āĻ°ā§āĻŖāĨ¤

GRAPH SurvivorNetwork
MATCH result = (s:Survivors)-[:SurvivorInBiome]->(b:Biomes)
RETURN TO_JSON(result) AS json_result

āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ⧇āϰ āĻŽāϤ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ: query1

👉 āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ ⧍: āĻ¸ā§āĻ•āĻŋāϞ āĻŽā§āϝāĻžāĻŸā§āϰāĻŋāĻ•ā§āϏ (āĻĻāĻ•ā§āώāϤāĻž) āĻāĻ–āύ āφāĻĒāύāĻŋ āϜāĻžāύ⧇āύ āϝ⧇ āϕ⧇ āϕ⧋āĻĨāĻžā§Ÿ āφāϛ⧇, āĻāĻŦāĻžāϰ āϖ⧁āρāĻœā§‡ āĻĻ⧇āϖ⧁āύ āϕ⧇ āϕ⧀ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇āĨ¤

GRAPH SurvivorNetwork
MATCH result = (s:Survivors)-[h:SurvivorHasSkill]->(k:Skills)
RETURN TO_JSON(result) AS json_result

āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ⧇āϰ āĻŽāϤ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ: query2

👉 āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ ā§Š: āϕ⧇ āϏāĻ‚āĻ•āĻŸā§‡ āφāϛ⧇āύ? ("āĻŽāĻŋāĻļāύ āĻŦā§‹āĻ°ā§āĻĄ") āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻž āϝ⧇āϏāĻŦ āĻŦā§āϝāĻ•ā§āϤāĻŋāϰ āϏāĻžāĻšāĻžāĻ¯ā§āϝ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ āĻāĻŦāĻ‚ āϤāĻžāĻĻ⧇āϰ āϕ⧀ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ āϤāĻž āĻĻ⧇āϖ⧁āύāĨ¤

GRAPH SurvivorNetwork
MATCH result = (s:Survivors)-[h:SurvivorHasNeed]->(n:Needs)
RETURN TO_JSON(result) AS json_result

āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ⧇āϰ āĻŽāϤ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ: query3

🔎 [āϐāĻšā§āĻ›āĻŋāĻ•] āĻŽā§āϝāĻžāϚāĻŽā§‡āĻ•āĻŋāĻ‚ - āϕ⧇ āĻ•āĻžāϕ⧇ āϏāĻžāĻšāĻžāĻ¯ā§āϝ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇?

āĻāχāĻ–āĻžāύ⧇āχ āĻ—ā§āϰāĻžāĻĢāϟāĻŋ āĻļāĻ•ā§āϤāĻŋāĻļāĻžāϞ⧀ āĻšā§Ÿā§‡ āĻ“āϠ⧇! āĻāχ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻāĻŽāύ āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻž āĻŦā§āϝāĻ•ā§āϤāĻŋāĻĻ⧇āϰ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧇ āϝāĻžāĻĻ⧇āϰ āĻ•āĻžāϛ⧇ āĻāĻŽāύ āĻĻāĻ•ā§āώāϤāĻž āφāϛ⧇ āϝāĻž āĻ…āĻ¨ā§āϝāĻžāĻ¨ā§āϝ āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻž āĻŦā§āϝāĻ•ā§āϤāĻŋāĻĻ⧇āϰ āĻĒā§āϰāϝāĻŧā§‹āϜāύ āĻŽā§‡āϟāĻžāϤ⧇ āĻĒāĻžāϰ⧇āĨ¤

GRAPH SurvivorNetwork
MATCH result = (helper:Survivors)-[:SurvivorHasSkill]->(skill:Skills)-[:SkillTreatsNeed]->(need:Needs)<-[:SurvivorHasNeed]-(helpee:Survivors)
RETURN TO_JSON(result) AS json_result

āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ⧇āϰ āĻŽāϤ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ: query4

aside positive āĻāχ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āϕ⧀ āĻ•āϰ⧇:

āĻļ⧁āϧ⧁ "āĻĢāĻžāĻ°ā§āĻ¸ā§āϟ āĻāĻĄ āĻĒā§‹ā§œāĻž āĻ•ā§āώāϤ āϏāĻžāϰāĻžā§Ÿ" (āϝāĻž āĻ¸ā§āĻ•āĻŋāĻŽāĻž āĻĨ⧇āϕ⧇ āĻ¸ā§āĻĒāĻˇā§āϟ) āĻĻ⧇āĻ–āĻžāύ⧋āϰ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤ⧇, āĻāχ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āϖ⧁āρāĻœā§‡ āĻĒāĻžā§Ÿ:

  • āĻĄāσ āĻāϞ⧇āύāĻž āĻĢā§āϰāĻ¸ā§āϟ (āϝāĻžāϰ āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ āĻŸā§āϰ⧇āύāĻŋāĻ‚ āφāϛ⧇) → āϚāĻŋāĻ•āĻŋā§ŽāϏāĻž āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇āύ → āĻ•ā§āϝāĻžāĻĒā§āĻŸā§‡āύ āϤāĻžāύāĻžāĻ•āĻž (āϝāĻžāϰ āĻļāϰ⧀āϰ āĻĒā§ā§œā§‡ āϗ⧇āϛ⧇)
  • āĻĄā§‡āĻ­āĻŋāĻĄ āĻšā§‡āύ (āϝāĻžāϰ āĻ•āĻžāϛ⧇ āĻĢāĻžāĻ°ā§āĻ¸ā§āϟ āĻāĻĄ āφāϛ⧇) → āϚāĻŋāĻ•āĻŋā§ŽāϏāĻž āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇ → āϞ⧇. āĻĒāĻžāĻ°ā§āĻ• (āϝāĻžāϰ āĻ—ā§‹ā§œāĻžāϞāĻŋ āĻŽāϚāϕ⧇ āϗ⧇āϛ⧇)

āĻāϟāĻŋ āϕ⧇āύ āĻļāĻ•ā§āϤāĻŋāĻļāĻžāϞ⧀:

āφāĻĒāύāĻžāϰ AI āĻāĻœā§‡āĻ¨ā§āϟ āϕ⧀ āĻ•āϰāĻŦ⧇:

āϕ⧋āύāĻ“ āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀ "āϕ⧇ āĻĒā§‹ā§œāĻž āĻ•ā§āώāϤ āϚāĻŋāĻ•āĻŋā§ŽāϏāĻž āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇āύ?" āϜāĻŋāĻœā§āĻžāĻžāϏāĻž āĻ•āϰāϞ⧇, āĻāĻœā§‡āĻ¨ā§āϟ:

  1. āĻāĻ•āχ āϧāϰāύ⧇āϰ āĻ—ā§āϰāĻžāĻĢ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āϰāĻžāύ āĻ•āϰ⧁āύ
  2. āĻĢāϞāĻžāĻĢāϞ: "āĻĄāσ āĻĢā§āϰāĻ¸ā§āĻŸā§‡āϰ āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ āĻŸā§āϰ⧇āύāĻŋāĻ‚ āφāϛ⧇ āĻāĻŦāĻ‚ āϤāĻŋāύāĻŋ āĻ•ā§āϝāĻžāĻĒā§āĻŸā§‡āύ āϤāĻžāύāĻžāĻ•āĻžāϕ⧇ āϏāĻžāĻšāĻžāĻ¯ā§āϝ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ"
  3. āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϕ⧇ āχāĻ¨ā§āϟāĻžāϰāĻŽāĻŋāĻĄāĻŋā§Ÿā§‡āϟ āĻŸā§‡āĻŦāĻŋāϞ āĻŦāĻž āϏāĻŽā§āĻĒāĻ°ā§āĻ• āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āϜāĻžāύāϤ⧇ āĻšāĻŦ⧇ āύāĻž!

ā§Ģ. 🚀 Spanner-āĻ AI-āĻāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āĻĒāϰāĻŋāϚāĻžāϞāĻŋāϤ āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚

ā§§. āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āϕ⧇āύ? (āϕ⧋āύāĻ“ āĻ…ā§āϝāĻžāĻ•āĻļāύ āύ⧇āχ, āĻļ⧁āϧ⧁ āĻĒ⧜āĻž āϝāĻžāĻŦ⧇)

āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻžāϰ āĻĒāϰāĻŋāĻ¸ā§āĻĨāĻŋāϤāĻŋāϤ⧇, āϏāĻŽā§Ÿ āĻ…āĻ¤ā§āϝāĻ¨ā§āϤ āϗ⧁āϰ⧁āĻ¤ā§āĻŦāĻĒā§‚āĻ°ā§āĻŖāĨ¤ āϕ⧋āύāĻ“ āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ I need someone who can treat burns āĻŦāĻž Looking for a medic-āĻāϰ āĻŽāϤ⧋ āϜāϰ⧁āϰāĻŋ āĻĒāϰāĻŋāĻ¸ā§āĻĨāĻŋāϤāĻŋāϰ āĻ•āĻĨāĻž āϜāĻžāύāĻžāϞ⧇, āĻĄā§‡āϟāĻžāĻŦ⧇āϏ⧇ āϏāĻ āĻŋāĻ• āĻ¸ā§āĻ•āĻŋāϞ⧇āϰ āύāĻžāĻŽ āĻ…āύ⧁āĻŽāĻžāύ āĻ•āϰ⧇ āϏāĻŽā§Ÿ āύāĻˇā§āϟ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇āύ āύāĻžāĨ¤

āĻŦāĻžāĻ¸ā§āϤāĻŦ āĻĒāϰāĻŋāĻ¸ā§āĻĨāĻŋāϤāĻŋ: āĻŦ⧇āρāĻšā§‡ āϝāĻžāĻ“ā§ŸāĻž āĻŦā§āϝāĻ•ā§āϤāĻŋ: Captain Tanaka has burns—we need medical help NOW!

"medic" āĻļāĻŦā§āĻĻ⧇āϰ āϜāĻ¨ā§āϝ āĻĒā§āϰāϚāϞāĻŋāϤ āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āϏāĻžāĻ°ā§āϚ → ā§ĻāϟāĻŋ āĻĢāϞāĻžāĻĢāϞ ❌

āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āϏāĻš āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ → "āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ āĻŸā§āϰ⧇āύāĻŋāĻ‚", "āĻĢāĻžāĻ°ā§āĻ¸ā§āϟ āĻāĻĄ" āϖ⧁āρāĻœā§‡ āĻĒāĻžā§Ÿ ✅

āĻāĻœā§‡āĻ¨ā§āϟāĻĻ⧇āϰ āĻ āĻŋāĻ• āĻāϟāĻžāχ āĻĒā§āϰāϝāĻŧā§‹āϜāύ: āĻŦ⧁āĻĻā§āϧāĻŋāĻŽāĻžāύ, āĻŽāĻžāύ⧁āώ⧇āϰ āĻŽāϤ⧋ āϏāĻžāĻ°ā§āϚ āϝāĻž āĻļ⧁āϧ⧁ āϕ⧀āĻ“āϝāĻŧāĻžāĻ°ā§āĻĄ āύāϝāĻŧ, āωāĻĻā§āĻĻ⧇āĻļā§āϝāĻ“ āĻŦā§‹āĻā§‡āĨ¤

⧍. āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻŽāĻĄā§‡āϞ āϤ⧈āϰāĻŋ āĻ•āϰ⧁āύ

spanner_embedding

āĻāĻ–āύ Google-āĻāϰ text-embedding-004 āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āĻŸā§‡āĻ•ā§āϏāϟāϕ⧇ āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ā§Ÿā§‡ āĻ•āύāĻ­āĻžāĻ°ā§āϟ āĻ•āϰ⧇ āĻāĻŽāύ āĻāĻ•āϟāĻŋ āĻŽāĻĄā§‡āϞ āϤ⧈āϰāĻŋ āĻ•āϰāĻž āϝāĻžāĻ•āĨ¤

👉 Spanner Studio-āϤ⧇, āĻāχ SQL āϰāĻžāύ āĻ•āϰ⧁āύ ($YOUR_PROJECT_ID-āĻāϰ āϜāĻžā§ŸāĻ—āĻžā§Ÿ āφāĻĒāύāĻžāϰ āφāϏāϞ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āφāχāĻĄāĻŋ āϞāĻŋāϖ⧁āύ):

â€ŧī¸ Cloud Shell āĻāĻĄāĻŋāϟāϰ-āĻ, āĻĒ⧁āϰ⧋ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āĻĻ⧇āĻ–āϤ⧇ File -> Open Folder -> way-back-home/level_2 āϖ⧁āϞ⧁āύāĨ¤

project_id

👉 Spanner Studio-āϤ⧇ āĻāχ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āϰāĻžāύ āĻ•āϰāϤ⧇, āύāĻŋāĻšā§‡ āĻĻ⧇āĻ“ā§ŸāĻž āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻ•āĻĒāĻŋ āĻ•āϰ⧇ āĻĒ⧇āĻ¸ā§āϟ āĻ•āϰ⧁āύ āĻāĻŦāĻ‚ āϤāĻžāϰāĻĒāϰ⧇ 'āϰāĻžāύ āĻ•āϰ⧁āύ' āĻŦā§‹āϤāĻžāĻŽā§‡ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ:

CREATE OR REPLACE MODEL TextEmbeddings
INPUT(content STRING(MAX))
OUTPUT(embeddings STRUCT<values ARRAY<FLOAT32>>)
REMOTE OPTIONS (
    endpoint = '//aiplatform.googleapis.com/projects/$YOUR_PROJECT_ID/locations/us-central1/publishers/google/models/text-embedding-004'
);

āĻāϟāĻŋ āϕ⧀ āĻ•āϰ⧇:

  • Spanner-āĻ āĻ­āĻžāĻ°ā§āϚ⧁⧟āĻžāϞ āĻŽāĻĄā§‡āϞ āϤ⧈āϰāĻŋ āĻ•āϰ⧇ (āĻ¸ā§āĻĨāĻžāĻ¨ā§€ā§ŸāĻ­āĻžāĻŦ⧇ āϕ⧋āύāĻ“ āĻŽāĻĄā§‡āϞ āĻ“ā§Ÿā§‡āϟ āĻ¸ā§āĻŸā§‹āϰ āĻ•āϰāĻž āĻšā§Ÿ āύāĻž)
  • Vertex AI-āϤ⧇ Google-āĻāϰ text-embedding-004-āĻ āĻĒā§Ÿā§‡āĻ¨ā§āϟ āĻ•āϰ⧇
  • āĻ•āĻ¨ā§āĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰ⧇: āχāύāĻĒ⧁āϟ āĻšāϞ āĻŸā§‡āĻ•ā§āϏāϟ, āφāωāϟāĻĒ⧁āϟ āĻšāϞ ā§­ā§Ŧā§Ž-āĻĄāĻžāχāĻŽā§‡āύāĻļāύ āĻĢā§āϞ⧋āϟ āĻ…ā§āϝāĻžāϰ⧇

"āϰāĻŋāĻŽā§‹āϟ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ" āϕ⧇āύ?

  • Spanner āύāĻŋāĻœā§‡ āĻĨ⧇āϕ⧇ āĻŽāĻĄā§‡āϞ āϰāĻžāύ āĻ•āϰ⧇ āύāĻž
  • āφāĻĒāύāĻŋ ML.PREDICT āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāϞ⧇ āĻāϟāĻŋ API-āĻāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ Vertex AI-āϕ⧇ āĻ•āϞ āĻ•āϰ⧇
  • Zero-ETL: Python-āĻ āĻĄā§‡āϟāĻž āĻāĻ•ā§āϏāĻĒā§‹āĻ°ā§āϟ, āĻĒā§āϰāϏ⧇āϏ āĻ“ āφāĻŦāĻžāϰ āχāĻŽāĻĒā§‹āĻ°ā§āϟ āĻ•āϰāĻžāϰ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ āύ⧇āχ

Run āĻŦā§‹āϤāĻžāĻŽā§‡ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ, āĻāϟāĻŋ āϏāĻĢāϞ āĻšāϞ⧇, āφāĻĒāύāĻŋ āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ:

spanner_result

ā§Š. āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻ•āϞāĻžāĻŽ āϝ⧋āĻ— āĻ•āϰ⧁āύ

👉 āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻ¸ā§āĻŸā§‹āϰ āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āĻāĻ•āϟāĻŋ āĻ•āϞāĻžāĻŽ āϝ⧋āĻ— āĻ•āϰ⧁āύ:

ALTER TABLE Skills ADD COLUMN skill_embedding ARRAY<FLOAT32>;

Run āĻŦā§‹āϤāĻžāĻŽā§‡ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ, āĻāϟāĻŋ āϏāĻĢāϞ āĻšāϞ⧇, āφāĻĒāύāĻŋ āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ:

embedding_result

ā§Ē. āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻœā§‡āύāĻžāϰ⧇āϟ āĻ•āϰ⧁āύ

👉 āĻĒā§āϰāϤāĻŋāϟāĻŋ āĻ¸ā§āĻ•āĻŋāϞ⧇āϰ āϜāĻ¨ā§āϝ āϭ⧇āĻ•ā§āϟāϰ āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āϤ⧈āϰāĻŋ āĻ•āϰāϤ⧇ AI āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧁āύ:

UPDATE Skills
SET skill_embedding = (
    SELECT embeddings.values
    FROM ML.PREDICT(
        MODEL TextEmbeddings,
        (SELECT name AS content)
    )
)
WHERE skill_embedding IS NULL;

Run āĻŦā§‹āϤāĻžāĻŽā§‡ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ, āĻāϟāĻŋ āϏāĻĢāϞ āĻšāϞ⧇, āφāĻĒāύāĻŋ āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ:

skills_result

āϕ⧀ āĻšā§Ÿ: āĻĒā§āϰāϤāĻŋāϟāĻŋ āĻ¸ā§āĻ•āĻŋāϞ⧇āϰ āύāĻžāĻŽ (āϝ⧇āĻŽāύ, "āĻĢāĻžāĻ°ā§āĻ¸ā§āϟ āĻāĻĄ") ā§­ā§Ŧā§Ž-āĻĄāĻžāχāĻŽā§‡āύāĻļāύ āϭ⧇āĻ•ā§āϟāϰ⧇ āĻ•āύāĻ­āĻžāĻ°ā§āϟ āĻ•āϰāĻž āĻšā§Ÿ āϝāĻž āĻāϰ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻ…āĻ°ā§āĻĨāϕ⧇ āϤ⧁āϞ⧇ āϧāϰ⧇āĨ¤

ā§Ģ. āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ

👉 āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āϤ⧈āϰāĻŋ āĻ•āϰāĻž āĻšā§Ÿā§‡āϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āĻšā§‡āĻ• āĻ•āϰ⧁āύ:

SELECT 
    skill_id,
    name,
    ARRAY_LENGTH(skill_embedding) AS embedding_dimensions
FROM Skills
LIMIT 5;

āĻĒā§āϰāĻ¤ā§āϝāĻžāĻļāĻŋāϤ āφāωāϟāĻĒ⧁āϟ:

spanner_result

āĻāĻ–āύ āφāĻŽāϰāĻž āφāĻŽāĻžāĻĻ⧇āϰ āĻĻ⧃āĻļā§āϝāĻ•āĻ˛ā§āĻĒ āĻĨ⧇āϕ⧇ āϏāĻ āĻŋāĻ• āĻŦā§āϝāĻŦāĻšāĻžāϰ⧇āϰ āϕ⧇āϏ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻŋ: "āĻŽā§‡āĻĄāĻŋāĻ•" āĻļāĻŦā§āĻĻāϟāĻŋ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ āĻĻāĻ•ā§āώāϤāĻž āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰāĻžāĨ¤

👉 "medic"-āĻāϰ āĻŽāϤ⧋ āĻ¸ā§āĻ•āĻŋāϞ āϖ⧁āρāϜ⧁āύ:

WITH query_embedding AS (
    SELECT embeddings.values AS val
    FROM ML.PREDICT(MODEL TextEmbeddings, (SELECT "medic" AS content))
)
SELECT
    s.name AS skill_name,
    s.category,
    COSINE_DISTANCE(s.skill_embedding, (SELECT val FROM query_embedding)) AS distance
FROM Skills AS s
WHERE s.skill_embedding IS NOT NULL
ORDER BY distance ASC
LIMIT 10;
  • āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āϏāĻžāĻ°ā§āϚ āĻ•āϰāĻž āĻļāĻŦā§āĻĻ "medic"-āϕ⧇ āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ā§Ÿā§‡ āĻ•āύāĻ­āĻžāĻ°ā§āϟ āĻ•āϰ⧇
  • āĻāϟāĻŋ query_embedding āĻ…āĻ¸ā§āĻĨāĻžā§Ÿā§€ āĻŸā§‡āĻŦāĻŋāϞ⧇ āĻ¸ā§āĻŸā§‹āϰ āĻ•āϰ⧇

āĻĒā§āϰāĻ¤ā§āϝāĻžāĻļāĻŋāϤ āĻĢāϞāĻžāĻĢāϞ (āĻ•āĻŽ āĻĻā§‚āϰāĻ¤ā§āĻŦ = āφāϰāĻ“ āĻŦ⧇āĻļāĻŋ āĻŽāĻŋāϞ):

spanner_result

ā§­. āĻŦāĻŋāĻļā§āϞ⧇āώāϪ⧇āϰ āϜāĻ¨ā§āϝ Gemini āĻŽāĻĄā§‡āϞ āϤ⧈āϰāĻŋ āĻ•āϰ⧁āύ

spanner_gemini

👉 āĻāĻ•āϟāĻŋ āĻœā§‡āύāĻžāϰ⧇āϟāĻŋāĻ­ AI āĻŽāĻĄā§‡āϞ āϰ⧇āĻĢāĻžāϰ⧇āĻ¨ā§āϏ āϤ⧈āϰāĻŋ āĻ•āϰ⧁āύ ($YOUR_PROJECT_ID-āĻāϰ āϜāĻžā§ŸāĻ—āĻžā§Ÿ āφāĻĒāύāĻžāϰ āφāϏāϞ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āφāχāĻĄāĻŋ āϞāĻŋāϖ⧁āύ):

CREATE OR REPLACE MODEL GeminiPro
INPUT(prompt STRING(MAX))
OUTPUT(content STRING(MAX))
REMOTE OPTIONS (
    endpoint = '//aiplatform.googleapis.com/projects/$YOUR_PROJECT_ID/locations/us-central1/publishers/google/models/gemini-2.5-pro',
    default_batch_size = 1
);

āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻŽāĻĄā§‡āϞ āĻĨ⧇āϕ⧇ āĻĒāĻžāĻ°ā§āĻĨāĻ•ā§āϝ:

  • āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚: āĻŸā§‡āĻ•ā§āϏāϟ → āϭ⧇āĻ•ā§āϟāϰ (āϏāĻžāĻĻ⧃āĻļā§āϝ āϏāĻžāĻ°ā§āĻšā§‡āϰ āϜāĻ¨ā§āϝ)
  • Gemini: āĻŸā§‡āĻ•ā§āϏāϟ → āĻœā§‡āύāĻžāϰ⧇āϟ āĻ•āϰāĻž āĻŸā§‡āĻ•ā§āϏāϟ (āϝ⧁āĻ•ā§āϤāĻŋ/āĻŦāĻŋāĻļā§āϞ⧇āώāϪ⧇āϰ āϜāĻ¨ā§āϝ)

spanner_result

ā§Ž. āĻŽāĻžāύāĻžāύāϏāχ āĻ•āĻŋāύāĻž āϤāĻž āĻŦāĻŋāĻļā§āϞ⧇āώāĻŖ āĻ•āϰāϤ⧇ Gemini āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧁āύ

👉 āĻŽāĻŋāĻļāύ⧇āϰ āϜāĻ¨ā§āϝ āĻŽāĻžāύāĻžāύāϏāχ āĻ•āĻŋāύāĻž āϤāĻž āĻĻ⧇āĻ–āϤ⧇ āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ āĻĒā§‡ā§ŸāĻžāϰ āĻŦāĻŋāĻļā§āϞ⧇āώāĻŖ āĻ•āϰ⧁āύ:

WITH PairData AS (
    SELECT
        s1.name AS Name_A,
        s2.name AS Name_B,
        CONCAT(
            "Assess compatibility of these two survivors for a resource-gathering mission. ",
            "Survivor 1: ", s1.name, ". ",
            "Survivor 2: ", s2.name, ". ",
            "Give a score from 1-10 and a 1-sentence reason."
        ) AS prompt
    FROM Survivors s1
    JOIN Survivors s2 ON s1.survivor_id < s2.survivor_id
    LIMIT 1
)
SELECT
    Name_A,
    Name_B,
    content AS ai_assessment
FROM ML.PREDICT(
    MODEL GeminiPro,
    (SELECT Name_A, Name_B, prompt FROM PairData)
);

āĻĒā§āϰāĻ¤ā§āϝāĻžāĻļāĻŋāϤ āφāωāϟāĻĒ⧁āϟ:

Name_A          | Name_B            | ai_assessment
----------------|-------------------|----------------
"David Chen"    | "Dr. Elena Frost" | "**Score: 9/10** Their compatibility is extremely high as David's practical, hands-on scavenging skills are perfectly complemented by Dr. Frost's specialized knowledge to identify critical medical supplies and avoid biological hazards."

ā§Ŧ. 🚀 āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āĻšā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āφāĻĒāύāĻžāϰ Graph RAG āĻāĻœā§‡āĻ¨ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻž

ā§§. āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽ āφāĻ°ā§āĻ•āĻŋāĻŸā§‡āĻ•āϚāĻžāϰ āĻ“āĻ­āĻžāϰāĻ­āĻŋāω

āĻāχ āĻŦāĻŋāĻ­āĻžāĻ—āϟāĻŋ āĻāĻ•āϟāĻŋ āĻŽāĻžāĻ˛ā§āϟāĻŋ-āĻŽā§‡āĻĨāĻĄ āϏāĻžāĻ°ā§āϚ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽ āϤ⧈āϰāĻŋ āĻ•āϰ⧇ āϝāĻž āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āϧāϰāύ⧇āϰ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻŽā§āϝāĻžāύ⧇āϜ āĻ•āϰāĻžāϰ āϏ⧁āĻŦāĻŋāϧāĻž āĻĻā§‡ā§ŸāĨ¤ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽā§‡āϰ āϤāĻŋāύāϟāĻŋ āĻ˛ā§‡ā§ŸāĻžāϰ āφāϛ⧇: āĻāĻœā§‡āĻ¨ā§āϟ āĻ˛ā§‡ā§ŸāĻžāϰ, āϟ⧁āϞ āĻ˛ā§‡ā§ŸāĻžāϰ, āĻĒāϰāĻŋāώ⧇āĻŦāĻž āĻ˛ā§‡ā§ŸāĻžāϰāĨ¤

architecture_hybrid_search

āϤāĻŋāύāϟāĻŋ āĻ˛ā§‡ā§ŸāĻžāϰ āϕ⧇āύ?

  • āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āĻŦāĻŋāĻˇā§Ÿā§‡āϰ āĻĒ⧃āĻĨāϕ⧀āĻ•āϰāĻŖ: āĻāĻœā§‡āĻ¨ā§āϟ āχāύāĻŸā§‡āĻ¨ā§āĻŸā§‡āϰ āωāĻĒāϰ, āϟ⧁āϞ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ⧇āϰ āωāĻĒāϰ āĻāĻŦāĻ‚ āĻĒāϰāĻŋāώ⧇āĻŦāĻž āĻĒā§āĻ°ā§Ÿā§‹āϗ⧇āϰ āωāĻĒāϰ āĻĢā§‹āĻ•āĻžāϏ āĻ•āϰ⧇
  • āĻĢā§āϞ⧇āĻ•ā§āϏāĻŋāĻŦāĻŋāϞāĻŋāϟāĻŋ: āĻāĻœā§‡āĻ¨ā§āϟ āύāĻŋāĻ°ā§āĻĻāĻŋāĻˇā§āϟ āĻĒāĻĻā§āϧāϤāĻŋ āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇ āĻ…āĻĨāĻŦāĻž AI-āϕ⧇ āĻ…āĻŸā§‹-āϰ⧁āϟ āĻ•āϰāϤ⧇ āĻĻāĻŋāϤ⧇ āĻĒāĻžāϰ⧇
  • āĻ…āĻĒā§āϟāĻŋāĻŽāĻžāχāĻœā§‡āĻļāύ: āĻĒāĻĻā§āϧāϤāĻŋ āϜāĻžāύāĻž āĻĨāĻžāĻ•āϞ⧇, āĻŦā§āϝ⧟āĻŦāĻšā§āϞ AI āĻŦāĻŋāĻļā§āϞ⧇āώāĻŖ āĻāĻĄāĻŧāĻŋā§Ÿā§‡ āϝ⧇āϤ⧇ āĻĒāĻžāϰ⧇

āĻāχ āĻŦāĻŋāĻ­āĻžāϗ⧇, āφāĻĒāύāĻŋ āĻĒā§āϰāĻžāĻĨāĻŽāĻŋāĻ•āĻ­āĻžāĻŦ⧇ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ (RAG) āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰāĻŦ⧇āύ - āĻļ⧁āϧ⧁ āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āύ⧟, āĻ…āĻ°ā§āĻĨ āĻ…āύ⧁āϝāĻžā§Ÿā§€ āĻĢāϞāĻžāĻĢāϞ āĻ–ā§‹āρāϜāĻžāĨ¤ āĻĒāϰ⧇, āφāĻŽāϰāĻž āĻŦā§āϝāĻžāĻ–ā§āϝāĻž āĻ•āϰāĻŦ āϕ⧀āĻ­āĻžāĻŦ⧇ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āϚ āĻāĻ•āĻžāϧāĻŋāĻ• āĻĒāĻĻā§āϧāϤāĻŋ āĻŽāĻžāĻ°ā§āϜ āĻ•āϰ⧇āĨ¤

⧍. RAG āĻĒāϰāĻŋāώ⧇āĻŦāĻž āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰāĻž

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/services/hybrid_search_service.py

# TODO: REPLACE_SQL āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāϜ⧁āύ

āĻāχ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

        # This is your working query from the successful run!
        sql = """
            WITH query_embedding AS (
                SELECT embeddings.values AS val
                FROM ML.PREDICT(
                    MODEL TextEmbeddings,
                    (SELECT @query AS content)
                )
            )
            SELECT
                s.survivor_id,
                s.name AS survivor_name,
                s.biome,
                sk.skill_id,
                sk.name AS skill_name,
                sk.category,
                COSINE_DISTANCE(
                    sk.skill_embedding, 
                    (SELECT val FROM query_embedding)
                ) AS distance
            FROM Survivors s
            JOIN SurvivorHasSkill shs ON s.survivor_id = shs.survivor_id
            JOIN Skills sk ON shs.skill_id = sk.skill_id
            WHERE sk.skill_embedding IS NOT NULL
            ORDER BY distance ASC
            LIMIT @limit
        """

ā§Š. āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ āϟ⧁āϞ āĻĄā§‡āĻĢāĻŋāύāĻŋāĻļāύ

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/tools/hybrid_search_tools.py

hybrid_search_tools.py-āĻ, # TODO: REPLACE_SEMANTIC_SEARCH_TOOL āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āύāĻŋāύ

👉āĻāχ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

async def semantic_search(query: str, limit: int = 10) -> str:
    """
    Force semantic (RAG) search using embeddings.
    
    Use this when you specifically want to find things by MEANING,
    not just matching keywords. Great for:
    - Finding conceptually similar items
    - Handling vague or abstract queries
    - When exact terms are unknown
    
    Example: "healing abilities" will find "first aid", "surgery", 
    "herbalism" even though no keywords match exactly.
    
    Args:
        query: What you're looking for (describe the concept)
        limit: Maximum results
        
    Returns:
        Semantically similar results ranked by relevance
    """
    try:
        service = _get_service()
        result = service.smart_search(
            query, 
            force_method=SearchMethod.RAG,
            limit=limit
        )
        
        return _format_results(
            result["results"],
            result["analysis"],
            show_analysis=True
        )
        
    except Exception as e:
        return f"Error in semantic search: {str(e)}"

āĻāĻœā§‡āĻ¨ā§āϟ āĻ•āĻ–āύ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇:

  • āĻāĻ•āχ āϧāϰāύ⧇āϰ āĻ•āĻŋāϛ⧁ āĻ–ā§‹āρāϜāĻžāϰ āϜāĻ¨ā§āϝ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ ("X-āĻāϰ āĻŽāϤ⧋ āĻ•āĻŋāϛ⧁ āϖ⧁āρāĻœā§‡ āĻĻāĻžāĻ“")
  • āϧāĻžāϰāĻŖāĻžāĻ—āϤ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ ("āύāĻŋāϰāĻžāĻŽā§Ÿ āĻ•āϰāĻžāϰ āĻ•ā§āώāĻŽāϤāĻž")
  • āĻ…āĻ°ā§āĻĨ āĻŦā§‹āĻāĻž āϝāĻ–āύ āĻ…āĻ¤ā§āϝāĻ¨ā§āϤ āϗ⧁āϰ⧁āĻ¤ā§āĻŦāĻĒā§‚āĻ°ā§āĻŖ

ā§Ē. āĻāĻœā§‡āĻ¨ā§āϟ āĻĄāĻŋāϏāĻŋāĻļāύ āĻ—āĻžāχāĻĄ (āύāĻŋāĻ°ā§āĻĻ⧇āĻļāĻžāĻŦāϞ⧀)

āĻāĻœā§‡āĻ¨ā§āϟ āϏāĻ‚āĻœā§āĻžāĻžā§Ÿ, āϏ⧇āĻŽāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ āϏāĻŽā§āĻĒāĻ°ā§āĻ•āĻŋāϤ āĻ…āĻ‚āĻļāϟāĻŋ āĻ•āĻĒāĻŋ āĻ•āϰ⧇ āύāĻŋāĻ°ā§āĻĻ⧇āĻļ⧇ āĻĒ⧇āĻ¸ā§āϟ āĻ•āϰ⧁āύāĨ¤

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/agent.py

āϏāĻ āĻŋāĻ• āϟ⧁āϞ āĻŦ⧇āϛ⧇ āύāĻŋāϤ⧇ āĻāĻœā§‡āĻ¨ā§āϟ āĻāχ āύāĻŋāĻ°ā§āĻĻ⧇āĻļāĻžāĻŦāϞ⧀ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇:

👉agent.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_SEARCH_LOGIC āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

- `semantic_search`: Force RAG/embedding search
  Use for: "Find similar to X", conceptual queries, unknown terminology
  Example: "Find skills related to healing"

👉āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ # TODO: ADD_SEARCH_TOOLāĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

    semantic_search,         # Force RAG

ā§Ģ. āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āϚ āϕ⧀āĻ­āĻžāĻŦ⧇ āĻ•āĻžāϜ āĻ•āϰ⧇ āϤāĻž āĻŦā§‹āĻāĻž (āĻļ⧁āϧ⧁āĻŽāĻžāĻ¤ā§āϰ āĻĒāĻĄāĻŧāĻž, āϕ⧋āύāĻ“ āĻ…ā§āϝāĻžāĻ•āĻļāύ āĻĒā§āϰāϝāĻŧā§‹āϜāύ āύ⧇āχ)

⧍-ā§Ē āύāĻŽā§āĻŦāϰ āϧāĻžāĻĒ⧇, āφāĻĒāύāĻŋ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ (RAG) āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰ⧇āϛ⧇āύ, āĻāϟāĻŋ āĻšāϞ āĻŽā§‚āϞ āϏāĻžāĻ°ā§āϚ āĻĒāĻĻā§āϧāϤāĻŋ āϝāĻž āĻ…āĻ°ā§āĻĨ āĻ…āύ⧁āϝāĻžā§Ÿā§€ āĻĢāϞāĻžāĻĢāϞ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧇āĨ¤ āϤāĻŦ⧇ āφāĻĒāύāĻŋ āĻšā§ŸāϤ āϞāĻ•ā§āĻˇā§āϝ āĻ•āϰ⧇āϛ⧇āύ āϝ⧇ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽāϟāĻŋāϕ⧇ "āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āϚ" āĻŦāϞāĻž āĻšā§ŸāĨ¤ āĻāχāϏāĻŦ āĻ•āĻŋāϛ⧁ āϕ⧀āĻ­āĻžāĻŦ⧇ āĻāĻ•āϏāĻžāĻĨ⧇ āĻ•āĻžāϜ āĻ•āϰ⧇ āϤāĻž āĻāĻ–āĻžāύ⧇ āĻĻ⧇āĻ“ā§ŸāĻž āĻšāϞ:

āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āĻŽāĻžāĻ°ā§āϜ āϕ⧀āĻ­āĻžāĻŦ⧇ āĻ•āĻžāϜ āĻ•āϰ⧇:

way-back-home/level_2/backend/services/hybrid_search_service.py āĻĢāĻžāχāϞ⧇, hybrid_search() āĻ•āϞ āĻ•āϰāĻž āĻšāϞ⧇, āĻĒāϰāĻŋāώ⧇āĻŦāĻžāϟāĻŋ āĻĻ⧁āϟāĻŋ āϏāĻžāĻ°ā§āϚāχ āϰāĻžāύ āĻ•āϰ⧇ āĻāĻŦāĻ‚ āĻĢāϞāĻžāĻĢāϞ āĻŽāĻžāĻ°ā§āϜ āĻ•āϰ⧇:

# Location: backend/services/hybrid_search_service.py

    rank_kw = keyword_ranks.get(surv_id, float('inf'))
    rank_rag = rag_ranks.get(surv_id, float('inf'))

    rrf_score = 0.0
    if rank_kw != float('inf'):
        rrf_score += 1.0 / (K + rank_kw)
    if rank_rag != float('inf'):
        rrf_score += 1.0 / (K + rank_rag)

    combined_score = rrf_score

āĻāχ āϕ⧋āĻĄāĻ˛ā§āϝāĻžāĻŦ⧇āϰ āϜāĻ¨ā§āϝ, āφāĻĒāύāĻŋ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ āĻ•āĻŽā§āĻĒā§‹āύ⧇āĻ¨ā§āϟ (RAG) āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰ⧇āϛ⧇āύ, āϝāĻž āĻšāϞ āĻĢāĻžāωāĻ¨ā§āĻĄā§‡āĻļāύāĨ¤ āĻĒāϰāĻŋāώ⧇āĻŦāĻžā§Ÿ āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āĻ“ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āĻĒāĻĻā§āϧāϤāĻŋ āφāϗ⧇ āĻĨ⧇āϕ⧇āχ āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰāĻž āĻšā§Ÿā§‡āϛ⧇ - āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āϟ āϤāĻŋāύāϟāĻŋāχ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ!

āĻ…āĻ­āĻŋāύāĻ¨ā§āĻĻāύ! āφāĻĒāύāĻŋ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āĻšā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ Graph RAG āĻāĻœā§‡āĻ¨ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻžāϰ āĻ•āĻžāϜ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āĻ•āϰ⧇āϛ⧇āύ!

ā§­. 🚀 ADK Web-āĻāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āϟ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻž

āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āϟ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻžāϰ āϏāĻŦāĻšā§‡ā§Ÿā§‡ āϏāĻšāϜ āωāĻĒāĻžā§Ÿ āĻšāϞ adk web āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāĻž, āϝāĻž āĻŦāĻŋāĻ˛ā§āϟ-āχāύ āĻšā§āϝāĻžāϟ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ⧇āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āϟ āϞāĻžā§āϚ āĻ•āϰ⧇āĨ¤

ā§§. āĻāĻœā§‡āĻ¨ā§āϟ āϰāĻžāύ āĻ•āϰāĻž āĻšāĻšā§āϛ⧇

👉đŸ’ģ āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄ āĻĄāĻŋāϰ⧇āĻ•ā§āϟāϰāĻŋāϤ⧇ (āϝ⧇āĻ–āĻžāύ⧇ āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āϏāĻ‚āĻœā§āĻžāĻžāϝāĻŧāĻŋāϤ āĻ•āϰāĻž āĻšāϝāĻŧ⧇āϛ⧇) āύ⧇āĻ­āĻŋāϗ⧇āϟ āĻ•āϰ⧁āύ āĻāĻŦāĻ‚ āĻ“āϝāĻŧ⧇āĻŦ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ āϚāĻžāϞ⧁ āĻ•āϰ⧁āύ::

cd ~/way-back-home/level_2/backend
uv run adk web

āĻāχ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ -āĻ āϏāĻ‚āĻœā§āĻžāĻžā§ŸāĻŋāϤ āĻāĻœā§‡āĻ¨ā§āϟ āĻļ⧁āϰ⧁ āĻ•āϰ⧇

agent/agent.py

āĻāĻŦāĻ‚ āĻĒāϰ⧀āĻ•ā§āώāĻžāϰ āϜāĻ¨ā§āϝ āĻāĻ•āϟāĻŋ āĻ“ā§Ÿā§‡āĻŦ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ āĻ–ā§‹āϞ⧇āĨ¤

👉 URL āϖ⧁āϞ⧁āύ:

āĻ•āĻŽāĻžāĻ¨ā§āĻĄāϟāĻŋ āĻāĻ•āϟāĻŋ āĻ¸ā§āĻĨāĻžāύ⧀āϝāĻŧ URL āφāωāϟāĻĒ⧁āϟ āĻ•āϰāĻŦ⧇ (āϏāĻžāϧāĻžāϰāĻŖāϤ http://127.0.0.1:8000 āĻŦāĻž āĻ…āύ⧁āϰ⧂āĻĒ)āĨ¤ āφāĻĒāύāĻžāϰ āĻŦā§āϰāĻžāωāϜāĻžāϰ⧇ āĻāϟāĻŋ āϖ⧁āϞ⧁āύāĨ¤

adk web

URL-āĻ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰāĻžāϰ āĻĒāϰ⧇, āφāĻĒāύāĻŋ ADK Web UI āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύāĨ¤ āωāĻĒāϰ⧇ āĻŦāĻžāρāĻĻāĻŋāϕ⧇āϰ āϕ⧋āĻŖ āĻĨ⧇āϕ⧇ "āĻāĻœā§‡āĻ¨ā§āϟ" āĻŦ⧇āϛ⧇ āύāĻŋā§Ÿā§‡āϛ⧇āύ āĻ•āĻŋāύāĻž āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰ⧁āύāĨ¤

adk_ui

⧍. āϏāĻžāĻ°ā§āϚ āĻ•āϰāĻžāϰ āĻ•ā§āώāĻŽāϤāĻž āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻž āĻšāĻšā§āϛ⧇

āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āφāĻĒāύāĻžāϰ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻŦ⧁āĻĻā§āϧāĻŋāĻŽāĻ¤ā§āϤāĻžāϰ āϏāĻžāĻĨ⧇ āϰ⧁āϟ āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āĻĄāĻŋāϜāĻžāχāύ āĻ•āϰāĻž āĻšā§Ÿā§‡āϛ⧇āĨ¤ āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āϏāĻžāĻ°ā§āϚ āĻĒāĻĻā§āϧāϤāĻŋ āϕ⧀āĻ­āĻžāĻŦ⧇ āĻ•āĻžāϜ āĻ•āϰ⧇ āϤāĻž āĻĻ⧇āĻ–āϤ⧇ āĻšā§āϝāĻžāϟ āωāχāĻ¨ā§āĻĄā§‹āϤ⧇ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āχāύāĻĒ⧁āϟāϗ⧁āϞāĻŋ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āĻĻ⧇āϖ⧁āύāĨ¤

āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āύāĻž āĻŽāĻŋāϞāϞ⧇āĻ“, āĻ…āĻ°ā§āĻĨ āĻ“ āϧāĻžāϰāĻŖāĻžāϰ āωāĻĒāϰ āĻ­āĻŋāĻ¤ā§āϤāĻŋ āĻ•āϰ⧇ āφāχāĻŸā§‡āĻŽ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧇āĨ¤

āĻŸā§‡āĻ¸ā§āϟ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ: (āύāĻŋāĻšā§‡ āĻĨ⧇āϕ⧇ āϝ⧇āϕ⧋āύāĻ“ āĻāĻ•āϟāĻŋ āĻŦ⧇āϛ⧇ āύāĻŋāύ)

Who can help with injuries?
What abilities are related to survival?

āϕ⧀ āϕ⧀ āϖ⧁āρāϜāĻŦ⧇āύ:

  • āĻ•āĻžāϰāĻŖ āĻĻāĻ°ā§āĻļāĻžāύ⧋āϰ āϏāĻŽā§Ÿ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻŦāĻž RAG āϏāĻžāĻ°ā§āĻšā§‡āϰ āωāĻ˛ā§āϞ⧇āĻ– āĻ•āϰāϤ⧇ āĻšāĻŦ⧇āĨ¤
  • āφāĻĒāύāĻŋ āĻāĻŽāύ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ āϝāĻž āϧāĻžāϰāĻŖāĻžāĻ—āϤāĻ­āĻžāĻŦ⧇ āϏāĻŽā§āĻĒāĻ°ā§āĻ•āĻŋāϤ (āϝ⧇āĻŽāύ, "āĻĢāĻžāĻ°ā§āĻ¸ā§āϟ āĻāχāĻĄ" āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āϜāĻŋāĻœā§āĻžāĻžāϏāĻž āĻ•āϰāĻžāϰ āϏāĻŽāϝāĻŧ "āϏāĻžāĻ°ā§āϜāĻžāϰāĻŋ")āĨ¤
  • āĻĢāϞāĻžāĻĢāϞ⧇ đŸ§Ŧ āφāχāĻ•āύ āĻĨāĻžāĻ•āĻŦ⧇āĨ¤

āϜāϟāĻŋāϞ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋāϰ āϜāĻ¨ā§āϝ āϏ⧇āĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻŦā§‹āĻāĻžāϰ āϏāĻžāĻĨ⧇ āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āĻĢāĻŋāĻ˛ā§āϟāĻžāϰ āĻāĻ•āĻ¤ā§āϰāĻŋāϤ āĻ•āϰ⧇āĨ¤

āĻŸā§‡āĻ¸ā§āϟ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ:(āύāĻŋāĻšā§‡ āωāĻ˛ā§āϞ⧇āĻ– āĻ•āϰāĻž āϝ⧇āϕ⧋āύāĻ“ āĻāĻ•āϟāĻŋ āĻŦ⧇āϛ⧇ āύāĻŋāύ)

Find someone who can fly a plane in the volcanic area
Who has healing abilities in the FOSSILIZED?
Who has healing abilities in the mountains?

āϕ⧀ āϕ⧀ āϖ⧁āρāϜāĻŦ⧇āύ:

  • āĻ•āĻžāϰāĻŖ āϞ⧇āĻ–āĻžāϰ āĻ•ā§āώ⧇āĻ¤ā§āϰ⧇ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āĻšā§‡āϰ āĻ•āĻĨāĻž āωāĻ˛ā§āϞ⧇āĻ– āĻ•āϰāϤ⧇ āĻšāĻŦ⧇āĨ¤
  • āĻĢāϞāĻžāĻĢāϞ āĻĻ⧁āϟāĻŋ āĻŽāĻžāύāĻĻāĻŖā§āĻĄā§‡āϰ (āϧāĻžāϰāĻŖāĻž + āϞ⧋āϕ⧇āĻļāύ/āĻŦāĻŋāĻ­āĻžāĻ—) āϏāĻžāĻĨ⧇ āĻŽāĻŋāϞāϤ⧇ āĻšāĻŦ⧇āĨ¤
  • āĻĻ⧁āϟāĻŋ āĻĒāĻĻā§āϧāϤāĻŋāϤ⧇āχ āĻĒāĻžāĻ“ā§ŸāĻž āĻĢāϞāĻžāĻĢāϞ⧇ 🔀 āφāχāĻ•āύ āĻĨāĻžāĻ•āĻŦ⧇ āĻāĻŦāĻ‚ āϏ⧇āϗ⧁āϞāĻŋ āϏāĻŦāĻšā§‡ā§Ÿā§‡ āωāĻĒāϰ⧇ āĻ°â€ā§āϝāĻžāĻ™ā§āĻ• āĻ•āϰāĻž āĻšāĻŦ⧇āĨ¤

👉đŸ’ģ āφāĻĒāύāĻžāϰ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻž āĻšā§Ÿā§‡ āϗ⧇āϞ⧇, āφāĻĒāύāĻžāϰ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āϞāĻžāχāύ⧇ Ctrl+C āĻĒā§āϰ⧇āϏ āĻ•āϰ⧇ āĻĒā§āϰāϏ⧇āϏāϟāĻŋ āĻļ⧇āώ āĻ•āϰ⧁āύāĨ¤

ā§Ž. 🚀 āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύ āϚāĻžāϞāĻžāύ⧋

āĻĢ⧁āϞ āĻ¸ā§āĻŸā§āϝāĻžāĻ• āφāĻ°ā§āĻ•āĻŋāĻŸā§‡āĻ•āϚāĻžāϰ āĻ“āĻ­āĻžāϰāĻ­āĻŋāω

architecture_fullstack

SessionService āĻ“ āϰāĻžāύāĻžāϰ āϝ⧋āĻ— āĻ•āϰ⧁āύ

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ chat.py āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ (āϚāĻžāϞāĻŋā§Ÿā§‡ āϝāĻžāĻ“ā§ŸāĻžāϰ āφāϗ⧇ "ctrl+C" āĻĒā§āϰ⧇āϏ āĻ•āϰ⧇ āφāϗ⧇āϰ āĻĒā§āϰāϏ⧇āϏāϟāĻŋ āĻļ⧇āώ āĻ•āϰ⧇āϛ⧇āύ āĻ•āĻŋāύāĻž āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰ⧁āύ):

cloudshell edit ~/way-back-home/level_2/backend/api/routes/chat.py

👉chat.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_INMEMORY_SERVICES āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

    session_service = InMemorySessionService()
    memory_service = InMemoryMemoryService()

👉chat.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_RUNNER āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

runner = Runner(
    agent=root_agent, 
    session_service=session_service,
    memory_service=memory_service,
    app_name="survivor-network"
)

ā§§. āφāĻŦ⧇āĻĻāύ āĻļ⧁āϰ⧁ āĻ•āϰ⧁āύ

āφāϗ⧇āϰ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āĻāĻ–āύāĻ“ āϚāĻžāϞ⧁ āĻĨāĻžāĻ•āϞ⧇, Ctrl+C āĻĒā§āϰ⧇āϏ āĻ•āϰ⧇ āϏ⧇āϟāĻŋ āĻŦāĻ¨ā§āϧ āĻ•āϰ⧁āύāĨ¤

👉đŸ’ģ āĻ…ā§āϝāĻžāĻĒ āϚāĻžāϞ⧁ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2/
./start_app.sh

āĻāϟāĻŋ āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄā§‡ āϏāĻĢāϞāĻ­āĻžāĻŦ⧇ āĻļ⧁āϰ⧁ āĻšāϞ⧇, āφāĻĒāύāĻŋ āύāĻŋāĻšā§‡ āĻĻ⧇āĻ–āĻžāύ⧋ Local: http://localhost:5173/" āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ: āϏāĻžāĻŽāύ⧇

👉 āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āĻĨ⧇āϕ⧇ āϞ⧋āĻ•āĻžāϞ: http://localhost:5173/ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤

āĻ•āĻĨā§‹āĻĒāĻ•āĻĨāύ

āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ:

Find skills similar to healing

āĻšā§āϝāĻžāϟ

āϕ⧀ āĻšā§Ÿ:

  • āĻāĻœā§‡āĻ¨ā§āϟ āĻŽāĻŋāϞ āĻĨāĻžāĻ•āĻž āϏāĻ‚āĻ•ā§āϰāĻžāĻ¨ā§āϤ āĻ…āύ⧁āϰ⧋āϧ āĻļāύāĻžāĻ•ā§āϤ āĻ•āϰ⧇
  • "healing"-āĻāϰ āϜāĻ¨ā§āϝ āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āĻœā§‡āύāĻžāϰ⧇āϟ āĻ•āϰ⧇
  • āĻ…āĻ°ā§āĻĨāĻ—āϤāĻ­āĻžāĻŦ⧇ āĻāĻ•āχ āϧāϰāύ⧇āϰ āĻĻāĻ•ā§āώāϤāĻž āϖ⧁āρāĻœā§‡ āĻĒ⧇āϤ⧇ āϕ⧋āϏāĻžāχāύ āĻĻā§‚āϰāĻ¤ā§āĻŦ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇
  • āĻĢāϞāĻžāĻĢāϞ: āĻĒā§āϰāĻžāĻĨāĻŽāĻŋāĻ• āϚāĻŋāĻ•āĻŋā§ŽāϏāĻž (āϝāĻĻāĻŋāĻ“ āύāĻžāĻŽā§‡āϰ āϏāĻžāĻĨ⧇ "āύāĻŋāϰāĻžāĻŽā§Ÿ" āĻļāĻŦā§āĻĻāϟāĻŋāϰ āĻŽāĻŋāϞ āύ⧇āχ)

āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ:

Find medical skills in the mountains

āϕ⧀ āĻšā§Ÿ:

  1. āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āĻ•āĻŽā§āĻĒā§‹āύ⧇āĻ¨ā§āϟ: category='medical'-āĻāϰ āϜāĻ¨ā§āϝ āĻĢāĻŋāĻ˛ā§āϟāĻžāϰ āĻ•āϰ⧁āύ
  2. āϏ⧇āĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻ•āĻŽā§āĻĒā§‹āύ⧇āĻ¨ā§āϟ: "āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ" āĻāĻŽā§āĻŦ⧇āĻĄ āĻ•āϰ⧁āύ āĻāĻŦāĻ‚ āĻŽāĻŋāϞ āĻ…āύ⧁āϝāĻžā§Ÿā§€ āĻ°â€ā§āϝāĻžāĻ™ā§āĻ• āĻ•āϰ⧁āύ
  3. āĻŽāĻžāĻ°ā§āϜ āĻ•āϰ⧁āύ: āĻĢāϞāĻžāĻĢāϞ āĻāĻ•āĻ¤ā§āϰāĻŋāϤ āĻ•āϰ⧁āύ, āĻĻ⧁āϟāĻŋ āĻĒāĻĻā§āϧāϤāĻŋāϤ⧇āχ āĻĒāĻžāĻ“ā§ŸāĻž āĻĢāϞāĻžāĻĢāϞāϕ⧇ āĻ…āĻ—ā§āϰāĻžāϧāĻŋāĻ•āĻžāϰ āĻĻāĻŋāύ 🔀

āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ (āϐāĻšā§āĻ›āĻŋāĻ•):

Who is good at survival and in the forest?

āϕ⧀ āĻšā§Ÿ:

  • āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āϖ⧁āρāĻœā§‡ āĻĒāĻžāĻ“ā§ŸāĻž āϗ⧇āϛ⧇: biome='forest'
  • āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻĢāĻžāχāĻ¨ā§āĻĄ: "āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϞ"-āĻāϰ āĻŽāϤ⧋ āĻ¸ā§āĻ•āĻŋāϞ
  • āϏ⧇āϰāĻž āĻĢāϞāĻžāĻĢāϞ⧇āϰ āϜāĻ¨ā§āϝ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āĻĻ⧁'āϟāĻŋāϕ⧇āχ āĻāĻ•āĻ¤ā§āϰāĻŋāϤ āĻ•āϰ⧇

👉đŸ’ģ āφāĻĒāύāĻžāϰ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻž āĻšā§Ÿā§‡ āϗ⧇āϞ⧇, āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇ Ctrl+C āĻĒā§āϰ⧇āϏ āĻ•āϰ⧇ āĻāϟāĻŋ āĻļ⧇āώ āĻ•āϰ⧁āύāĨ¤

ā§Ē. (!ONLY FOR WORKSHOP ATTENDEE) Update your location

👉đŸ’ģ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āĻ•āϰāĻžāϰ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āϚāĻžāϞāĻžāύ:

cd ~/way-back-home/level_2
./set_level_2.sh

āĻāĻ–āύ waybackhome.dev āϖ⧁āϞ⧁āύ āĻāĻŦāĻ‚ āφāĻĒāύāĻžāϰ āϞ⧋āϕ⧇āĻļāύ āφāĻĒāĻĄā§‡āϟ āĻšā§Ÿā§‡ āϗ⧇āϛ⧇ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύāĨ¤ āϞ⧇āϭ⧇āϞ ⧍ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āĻ…āĻ­āĻŋāύāĻ¨ā§āĻĻāύ!

āĻšā§‚āĻĄāĻŧāĻžāĻ¨ā§āϤ āĻĢāϞāĻžāĻĢāϞ

⧝. â˜•ī¸ [āϐāĻšā§āĻ›āĻŋāĻ•] āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āĻĒāĻžāχāĻĒāϞāĻžāχāύ (āĻļ⧁āϧ⧁āĻŽāĻžāĻ¤ā§āϰ āĻĒāĻĄāĻŧāĻž āϝāĻžāĻŦ⧇) — āϟ⧁āϞāĻŋāĻ‚ āĻ˛ā§‡ā§ŸāĻžāϰ

āφāĻŽāĻžāĻĻ⧇āϰ āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āĻĒāĻžāχāĻĒāϞāĻžāχāύ āϕ⧇āύ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ?

āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϞ āύ⧇āϟāĻ“ā§ŸāĻžāĻ°ā§āĻ• āĻļ⧁āϧ⧁ āĻŸā§‡āĻ•ā§āϏāϟ āύ⧟āĨ¤ āϘāϟāύāĻžāĻ¸ā§āĻĨāϞ⧇ āĻĨāĻžāĻ•āĻž āĻŦ⧇āρāĻšā§‡ āϝāĻžāĻ“ā§ŸāĻž āĻŦā§āϝāĻ•ā§āϤāĻŋāϰāĻž āϏāϰāĻžāϏāϰāĻŋ āĻšā§āϝāĻžāĻŸā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āĻ…āϏāĻ‚āĻ—āĻ āĻŋāϤ āĻĄā§‡āϟāĻž āĻĒāĻžāĻ āĻžāύ:

  • 📸 āĻ›āĻŦāĻŋ: āϰāĻŋāϏ⧋āĻ°ā§āϏ, āĻŦāĻŋāĻĒāĻĻ āĻŦāĻž āϏāϰāĻžā§āϜāĻžāĻŽā§‡āϰ āĻĢāĻŸā§‹
  • đŸŽĨ āĻ­āĻŋāĻĄāĻŋāĻ“: āĻ¸ā§āĻŸā§āϝāĻžāϟāĻžāϏ āϰāĻŋāĻĒā§‹āĻ°ā§āϟ āĻŦāĻž SOS āĻŦā§āϰāĻĄāĻ•āĻžāĻ¸ā§āϟ
  • 📄 āĻŸā§‡āĻ•ā§āϏāϟ: āĻĢāĻŋāĻ˛ā§āĻĄ āύ⧋āϟ āĻŦāĻž āϞāĻ—

āφāĻŽāϰāĻž āϕ⧋āύ āĻĢāĻžāχāϞ āĻĒā§āϰāϏ⧇āϏ āĻ•āϰāĻ›āĻŋ?

āφāϗ⧇āϰ āϧāĻžāĻĒ⧇ āφāĻŽāϰāĻž āφāϗ⧇ āĻĨ⧇āϕ⧇ āĻĨāĻžāĻ•āĻž āĻĄā§‡āϟāĻž āϏāĻžāĻ°ā§āϚ āĻ•āϰ⧇āĻ›āĻŋ, āĻ•āĻŋāĻ¨ā§āϤ⧁ āĻāĻ–āĻžāύ⧇ āφāĻŽāϰāĻž āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž āĻĢāĻžāχāϞ āĻĒā§āϰāϏ⧇āϏ āĻ•āϰāĻŋāĨ¤ chat.py āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ āĻĢāĻžāχāϞ āĻ…ā§āϝāĻžāϟāĻžāϚāĻŽā§‡āĻ¨ā§āϟ āĻĄāĻžā§ŸāύāĻžāĻŽāĻŋāĻ•āĻ­āĻžāĻŦ⧇ āĻŽā§āϝāĻžāύ⧇āϜ āĻ•āϰ⧇:

āϏ⧋āĻ°ā§āϏ

āĻ•āĻ¨ā§āĻŸā§‡āĻ¨ā§āϟ

āϞāĻ•ā§āĻˇā§āϝ

āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āĻ…ā§āϝāĻžāϟāĻžāϚāĻŽā§‡āĻ¨ā§āϟ

āĻ›āĻŦāĻŋ/āĻ­āĻŋāĻĄāĻŋāĻ“/āĻŸā§‡āĻ•ā§āϏāϟ

āĻ—ā§āϰāĻžāĻĢ⧇ āϝ⧋āĻ— āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āϤāĻĨā§āϝ

āĻšā§āϝāĻžāϟ āĻ•āύāĻŸā§‡āĻ•ā§āϏāϟ

"āĻāĻ–āĻžāύ⧇ āϏāĻžāĻĒā§āϞāĻžāĻ‡ā§Ÿā§‡āϰ āĻāĻ•āϟāĻŋ āĻĢāĻŸā§‹ āĻĻ⧇āĻ“ā§ŸāĻž āĻšāϞ"

āωāĻĻā§āĻĻ⧇āĻļā§āϝ āĻ“ āĻ…āϤāĻŋāϰāĻŋāĻ•ā§āϤ āĻŦāĻŋāĻŦāϰāĻŖ

āĻĒāϰāĻŋāĻ•āĻ˛ā§āĻĒāĻŋāϤ āĻĒāĻĻā§āϧāϤāĻŋ: āϏāĻŋāĻ•ā§‹ā§Ÿā§‡āĻ¨ā§āϏāĻŋ⧟āĻžāϞ āĻāĻœā§‡āĻ¨ā§āϟ āĻĒāĻžāχāĻĒāϞāĻžāχāύ

āφāĻŽāϰāĻž āĻāĻ•āϟāĻŋ āϏāĻŋāĻ•ā§‹ā§Ÿā§‡āĻ¨ā§āϏāĻŋ⧟āĻžāϞ āĻāĻœā§‡āĻ¨ā§āϟ (multimedia_agent.py) āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāĻŋ āϝāĻž āĻŦāĻŋāĻļ⧇āώ āĻāĻœā§‡āĻ¨ā§āϟāĻĻ⧇āϰ āĻāĻ•āϏāĻžāĻĨ⧇ āĻšā§‡āχāύ āĻ•āϰ⧇:

architecture_uploading

āĻāϟāĻŋ backend/agent/multimedia_agent.py-āĻ SequentialAgent āĻšāĻŋāϏ⧇āĻŦ⧇ āϏāĻ‚āĻœā§āĻžāĻžā§ŸāĻŋāϤ āĻ•āϰāĻž āĻšā§Ÿā§‡āϛ⧇āĨ¤

āϟ⧁āϞāĻŋāĻ‚ āĻ˛ā§‡ā§ŸāĻžāϰ āĻ•ā§āώāĻŽāϤāĻž āĻĒā§āϰāĻĻāĻžāύ āĻ•āϰ⧇ āϝāĻž āĻāĻœā§‡āĻ¨ā§āϟāϰāĻž āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇āĨ¤ āϟ⧁āϞ "āϕ⧀āĻ­āĻžāĻŦ⧇" āĻšā§āϝāĻžāĻ¨ā§āĻĄā§‡āϞ āĻ•āϰ⧇ — āĻĢāĻžāχāϞ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž, āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž āĻāĻŦāĻ‚ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ⧇ āϏ⧇āĻ­ āĻ•āϰāĻžāĨ¤

ā§§. āϟ⧁āϞ āĻĢāĻžāχāϞ āϖ⧁āϞ⧁āύ

👉đŸ’ģ āĻĢāĻžāχāϞāϟāĻŋ level_2/backend/agent/tools/extraction_tools.py āϖ⧁āϞ⧁āύ āĻ…āĻĨāĻŦāĻž āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āϟāĻžāχāĻĒ āĻ•āϰ⧇ āϖ⧁āϞ⧁āύāĨ¤ āύāϤ⧁āύ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āϖ⧁āϞ⧁āύāĨ¤ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/tools/extraction_tools.py

⧍. upload_media āϟ⧁āϞ āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰ⧁āύ

āĻāχ āϟ⧁āϞ Google Cloud Storage-āĻ āϞ⧋āĻ•āĻžāϞ āĻĢāĻžāχāϞ āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧇āĨ¤

👉 def upload_media(file_path: str, survivor_id: Optional[str] = None) -> Dict[str, Any]:-āĻ, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄāϟāĻŋ GCS-āĻ āĻĢāĻžāχāϞ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻžāϰ āĻāĻŦāĻ‚ āĻāϰ āϧāϰāύ āĻļāύāĻžāĻ•ā§āϤ āĻ•āϰāĻžāϰ āĻĒāĻĻā§āϧāϤāĻŋ āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇:

    """
    Upload media file to GCS and detect its type.
    
    Args:
        file_path: Path to the local file
        survivor_id: Optional survivor ID to associate with upload
        
    Returns:
        Dict with gcs_uri, media_type, and status
    """
    try:
        if not file_path:
            return {"status": "error", "error": "No file path provided"}
        
        # Strip quotes if present
        file_path = file_path.strip().strip("'").strip('"')
        
        if not os.path.exists(file_path):
            return {"status": "error", "error": f"File not found: {file_path}"}
        
        gcs_uri, media_type, signed_url = gcs_service.upload_file(file_path, survivor_id)
        
        return {
            "status": "success",
            "gcs_uri": gcs_uri,
            "signed_url": signed_url,
            "media_type": media_type.value,
            "file_name": os.path.basename(file_path),
            "survivor_id": survivor_id
        }
    except Exception as e:
        logger.error(f"Upload failed: {e}")
        return {"status": "error", "error": str(e)}

ā§Š. extract_from_media āϟ⧁āϞ āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰ⧁āύ

āĻāχ āϟ⧁āϞāϟāĻŋ āĻšāϞ āĻāĻ•āϟāĻŋ āϰāĻžāωāϟāĻžāϰ — āĻāϟāĻŋ media_type āĻšā§‡āĻ• āĻ•āϰ⧇ āĻāĻŦāĻ‚ āϏāĻ āĻŋāĻ• āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟāϰ⧇ (āĻŸā§‡āĻ•ā§āϏāϟ, āĻ›āĻŦāĻŋ āĻŦāĻž āĻ­āĻŋāĻĄāĻŋāĻ“) āĻĒāĻžāĻ āĻžā§ŸāĨ¤

async def extract_from_media(gcs_uri: str, media_type: str, signed_url: Optional[str] = None) -> Dict[str, Any]:-āĻ, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄāϟāĻŋ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž āĻŽāĻŋāĻĄāĻŋāϝāĻŧāĻž āĻĨ⧇āϕ⧇ āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻŦāĻ‚ āϏāĻŽā§āĻĒāĻ°ā§āĻ• āϕ⧀āĻ­āĻžāĻŦ⧇ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāϤ⧇ āĻšāϝāĻŧ āϤāĻžāϰ āϏāĻžāĻĨ⧇ āϏāĻŽā§āĻĒāĻ°ā§āĻ•āĻŋāϤāĨ¤

    """
    Extract entities and relationships from uploaded media.
    
    Args:
        gcs_uri: GCS URI of the uploaded file
        media_type: Type of media (text/image/video)
        signed_url: Optional signed URL for public/temporary access
        
    Returns:
        Dict with extraction results
    """
    try:
        if not gcs_uri:
             return {"status": "error", "error": "No GCS URI provided"}

        # Select appropriate extractor
        if media_type == MediaType.TEXT.value or media_type == "text":
            result = await text_extractor.extract(gcs_uri)
        elif media_type == MediaType.IMAGE.value or media_type == "image":
            result = await image_extractor.extract(gcs_uri)
        elif media_type == MediaType.VIDEO.value or media_type == "video":
            result = await video_extractor.extract(gcs_uri)
        else:
            return {"status": "error", "error": f"Unsupported media type: {media_type}"}
            
        # Inject signed URL into broadcast info if present
        if signed_url:
            if not result.broadcast_info:
                result.broadcast_info = {}
            result.broadcast_info['thumbnail_url'] = signed_url
        
        return {
            "status": "success",
            "extraction_result": result.to_dict(), # Return valid JSON dict instead of object
            "summary": result.summary,
            "entities_count": len(result.entities),
            "relationships_count": len(result.relationships),
            "entities": [e.to_dict() for e in result.entities],
            "relationships": [r.to_dict() for r in result.relationships]
        }
    except Exception as e:
        logger.error(f"Extraction failed: {e}")
        return {"status": "error", "error": str(e)}

āϕ⧀ āĻĒā§āĻ°ā§Ÿā§‹āĻ— āϏāĻ‚āĻ•ā§āϰāĻžāĻ¨ā§āϤ āĻŦāĻŋāĻŦāϰāĻŖ:

  • āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āχāύāĻĒ⧁āϟ: āφāĻŽāϰāĻž generate_content-āĻ āĻŸā§‡āĻ•ā§āϏāϟ āĻĒā§āϰāĻŽā§āĻĒāϟ (_get_extraction_prompt()) āĻāĻŦāĻ‚ āχāĻŽā§‡āϜ āĻ…āĻŦāĻœā§‡āĻ•ā§āϟ, āĻĻ⧁āϟāĻŋāχ āĻĒāĻžāϏ āĻ•āϰāĻŋāĨ¤
  • āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāĻ°ā§āĻĄ āφāωāϟāĻĒ⧁āϟ: response_mime_type="application/json" āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰ⧇ āϝ⧇ LLM āϏāĻ āĻŋāĻ• JSON āϰāĻŋāϟāĻžāĻ°ā§āύ āĻ•āϰ⧇, āϝāĻž āĻĒāĻžāχāĻĒāϞāĻžāχāύ⧇āϰ āϜāĻ¨ā§āϝ āĻ…āĻ¤ā§āϝāĻ¨ā§āϤ āϗ⧁āϰ⧁āĻ¤ā§āĻŦāĻĒā§‚āĻ°ā§āĻŖāĨ¤
  • āĻ­āĻŋāĻœā§āϝ⧁⧟āĻžāϞ āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āϞāĻŋāĻ™ā§āĻ•āĻŋāĻ‚: āĻĒā§āϰāĻŽā§āĻĒāĻŸā§‡ āĻĒāϰāĻŋāϚāĻŋāϤ āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻ…āĻ¨ā§āϤāĻ°ā§āϭ⧁āĻ•ā§āϤ āĻĨāĻžāϕ⧇ āϝāĻžāϤ⧇ Gemini āύāĻŋāĻ°ā§āĻĻāĻŋāĻˇā§āϟ āĻ…āĻ•ā§āώāϰ āϚāĻŋāύāϤ⧇ āĻĒāĻžāϰ⧇āĨ¤

ā§Ē. save_to_spanner āϟ⧁āϞ āĻĒā§āĻ°ā§Ÿā§‹āĻ— āĻ•āϰ⧁āύ

āĻāχ āϟ⧁āϞ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻŦāĻ‚ āϏāĻŽā§āĻĒāĻ°ā§āĻ• Spanner Graph DB-āϤ⧇ āϏ⧇āĻ­ āĻ•āϰ⧇ āϰāĻžāϖ⧇āĨ¤

👉 def save_to_spanner(extraction_result: Any, survivor_id: Optional[str] = None) -> Dict[str, Any]:-āĻ, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄāϟāĻŋ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻŦāĻ‚ āϏāĻŽā§āĻĒāĻ°ā§āĻ• Spanner Graph DB-āϤ⧇ āϕ⧀āĻ­āĻžāĻŦ⧇ āϏ⧇āĻ­ āĻ•āϰāϤ⧇ āĻšā§Ÿ āϏ⧇āχ āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇āĨ¤

    """
    Save extracted entities and relationships to Spanner Graph DB.
    
    Args:
        extraction_result: ExtractionResult object (or dict from previous step if passed as dict)
        survivor_id: Optional survivor ID to associate with the broadcast
        
    Returns:
        Dict with save statistics
    """
    try:
        # Handle if extraction_result is passed as the wrapper dict from extract_from_media
        result_obj = extraction_result
        if isinstance(extraction_result, dict) and 'extraction_result' in extraction_result:
             result_obj = extraction_result['extraction_result']
        
        # If result_obj is a dict (from to_dict()), reconstruct it
        if isinstance(result_obj, dict):
            from extractors.base_extractor import ExtractionResult
            result_obj = ExtractionResult.from_dict(result_obj)
        
        if not result_obj:
            return {"status": "error", "error": "No extraction result provided"}
            
        stats = spanner_service.save_extraction_result(result_obj, survivor_id)
        
        return {
            "status": "success",
            "entities_created": stats['entities_created'],
            "entities_existing": stats['entities_found_existing'],
            "relationships_created": stats['relationships_created'],
            "broadcast_id": stats['broadcast_id'],
            "errors": stats['errors'] if stats['errors'] else None
        }
    except Exception as e:
        logger.error(f"Spanner save failed: {e}")
        return {"status": "error", "error": str(e)}

āĻāĻœā§‡āĻ¨ā§āϟāĻĻ⧇āϰ āĻšāĻžāχ-āϞ⧇āϭ⧇āϞ āϟ⧁āϞ āĻĻ⧇āĻ“ā§ŸāĻžāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡, āφāĻŽāϰāĻž āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āϝ⧁āĻ•ā§āϤāĻŋ āĻĻ⧇āĻ“ā§ŸāĻžāϰ āĻ•ā§āώāĻŽāϤāĻžāϕ⧇ āĻ•āĻžāĻœā§‡ āϞāĻžāĻ—āĻžāύ⧋āϰ āĻĒāĻžāĻļāĻžāĻĒāĻžāĻļāĻŋ āĻĄā§‡āϟāĻž āχāĻ¨ā§āϟāĻŋāĻ—ā§āϰāĻŋāϟāĻŋ āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰāĻŋāĨ¤

ā§Ģ. GCS āĻĒāϰāĻŋāώ⧇āĻŦāĻž āφāĻĒāĻĄā§‡āϟ āĻ•āϰ⧁āύ

GCSService, Google Cloud Storage-āĻ āφāϏāϞ āĻĢāĻžāχāϞ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻžāϰ āĻŦāĻŋāώ⧟āϟāĻŋ āĻŽā§āϝāĻžāύ⧇āϜ āĻ•āϰ⧇āĨ¤

👉đŸ’ģ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ level_2/backend/services/gcs_service.py, āĻ…āĻĨāĻŦāĻž āφāĻĒāύāĻŋ Cloud Shell Editor-āĻ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞāϤ⧇ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇ āϟāĻžāχāĻĒ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇āύ:

cloudshell edit ~/way-back-home/level_2/backend/services/gcs_service.py

👉 def upload_file(self, file_path: str, survivor_id: Optional[str] = None) -> Tuple[str, MediaType, str]:-āĻ, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄāϟāĻŋ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻŦāĻ‚ āϏāĻŽā§āĻĒāĻ°ā§āĻ• Spanner Graph DB-āϤ⧇ āϕ⧀āĻ­āĻžāĻŦ⧇ āϏ⧇āĻ­ āĻ•āϰāϤ⧇ āĻšā§Ÿ āϏ⧇āχ āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇āĨ¤

        blob = self.bucket.blob(blob_name)
        blob.upload_from_filename(file_path)

āĻāϟāĻŋ āĻāĻ•āϟāĻŋ āĻĒāϰāĻŋāώ⧇āĻŦāĻžāϤ⧇ āĻ…ā§āϝāĻžāĻŦāĻ¸ā§āĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻžāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡, āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ GCS āĻŦāĻžāϕ⧇āϟ, āĻŦā§āϞāĻŦ āύāĻžāĻŽ āĻŦāĻž āĻ¸ā§āĻŦāĻžāĻ•ā§āώāϰāĻŋāϤ URL āĻœā§‡āύāĻžāϰ⧇āĻļāύ āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āϜāĻžāύāϤ⧇ āĻšāĻŦ⧇ āύāĻžāĨ¤ āĻāϟāĻŋ āĻļ⧁āϧ⧁ "āφāĻĒāϞ⧋āĻĄ" āĻ•āϰāϤ⧇ āĻŦāϞ⧇āĨ¤

ā§Ŧ. āĻāĻœā§‡āĻ¨ā§āϟāĻŋāĻ• āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻĢā§āϞ⧋ > āĻĒā§āϰāĻĨāĻžāĻ—āϤ āĻĒāĻĻā§āϧāϤāĻŋāϰ āĻšā§‡ā§Ÿā§‡ āϕ⧇āύ āĻ­āĻžāϞ⧋?

āĻāĻœā§‡āĻ¨ā§āϟāĻŋāĻ• āĻ…ā§āϝāĻžāĻĄāĻ­āĻžāĻ¨ā§āĻŸā§‡āϜ:

āĻĢāĻŋāϚāĻžāϰ

āĻŦā§āϝāĻžāϚ āĻĒāĻžāχāĻĒāϞāĻžāχāύ

āχāϭ⧇āĻ¨ā§āϟ-āϚāĻžāϞāĻŋāϤ

āĻāĻœā§‡āĻ¨ā§āϟāĻŋāĻ• āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻĢā§āϞ⧋

āϜāϟāĻŋāϞāϤāĻž

āĻ•āĻŽ (ā§§āϟāĻŋ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ)

āĻŦ⧇āĻļāĻŋ (ā§ĢāϟāĻŋāϰ āĻŦ⧇āĻļāĻŋ āĻĒāϰāĻŋāώ⧇āĻŦāĻž)

āĻ•āĻŽ (ā§§āϟāĻŋ Python āĻĢāĻžāχāϞ: multimedia_agent.py)

āĻ¸ā§āĻŸā§‡āϟ āĻŽā§āϝāĻžāύ⧇āϜāĻŽā§‡āĻ¨ā§āϟ

āĻ—ā§āϞ⧋āĻŦāĻžāϞ āϭ⧇āϰāĻŋā§Ÿā§‡āĻŦ⧇āϞ

āĻšāĻžāĻ°ā§āĻĄ (āĻĄāĻŋāĻ•āĻžāĻĒāĻ˛ā§āĻĄ)

āχāωāύāĻŋāĻĢāĻžā§Ÿā§‡āĻĄ (āĻāĻœā§‡āĻ¨ā§āϟ āĻ¸ā§āĻŸā§‡āϟ)

āϏāĻŽāĻ¸ā§āϝāĻž āĻŽā§āϝāĻžāύ⧇āϜ āĻ•āϰāĻž

āĻ•ā§āĻ°ā§āϝāĻžāĻļ⧇āϏ

āϏāĻžāχāϞ⧇āĻ¨ā§āϟ āϞāĻ—

āχāĻ¨ā§āϟāĻžāĻ°â€ā§āϝāĻžāĻ•ā§āϟāĻŋāĻ­ ("āφāĻŽāĻŋ āĻ“āχ āĻĢāĻžāχāϞāϟāĻŋ āĻĒ⧜āϤ⧇ āĻĒāĻžāϰāĻŋāύāĻŋ")

āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āĻŽāϤāĻžāĻŽāϤ

āĻ•āύāϏ⧋āϞ āĻĒā§āϰāĻŋāĻ¨ā§āϟ

āĻĒā§‹āϞāĻŋāĻ‚ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ

āĻ…āĻŦāĻŋāϞāĻŽā§āĻŦ⧇ (āĻšā§āϝāĻžāĻŸā§‡āϰ āĻ…āĻ‚āĻļ)

āĻ…āĻ­āĻŋāϝ⧋āϜāύāϝ⧋āĻ—ā§āϝāϤāĻž

āĻĢāĻŋāĻ•ā§āϏāĻĄ āϞāϜāĻŋāĻ•

āϰāĻŋāϜāĻŋāĻĄ āĻĢāĻžāĻ‚āĻļāύ

āχāĻ¨ā§āĻŸā§‡āϞāĻŋāĻœā§‡āĻ¨ā§āϟ (LLM āĻĒāϰāĻŦāĻ°ā§āϤ⧀ āϧāĻžāĻĒ āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰ⧇)

āĻĒā§āϰāϏāĻ™ā§āĻ— āϏāĻšā§‡āϤāύāϤāĻž

āϕ⧋āύāĻ“āϟāĻŋāχ āύ⧟

āϕ⧋āύāĻ“āϟāĻŋāχ āύ⧟

āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ (āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āωāĻĻā§āĻĻ⧇āĻļā§āϝ āϜāĻžāύ⧇)

āĻāϟāĻŋ āϕ⧇āύ āϗ⧁āϰ⧁āĻ¤ā§āĻŦāĻĒā§‚āĻ°ā§āĻŖ: multimedia_agent.py (ā§ĒāϟāĻŋ āϏāĻžāĻŦ-āĻāĻœā§‡āĻ¨ā§āϟ āϏāĻš āĻāĻ•āϟāĻŋ SequentialAgent: āφāĻĒāϞ⧋āĻĄ → āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ → āϏ⧇āĻ­ → āϏāĻžāϰāϏāĻ‚āĻ•ā§āώ⧇āĻĒ) āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇, āφāĻŽāϰāĻž āϜāϟāĻŋāϞ āχāύāĻĢā§āϰāĻžāĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāϰ āĻāĻŦāĻ‚ āĻ­āĻ™ā§āϗ⧁āϰ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟāϗ⧁āϞāĻŋāϕ⧇ āχāĻ¨ā§āĻŸā§‡āϞāĻŋāĻœā§‡āĻ¨ā§āϟ, āĻ•āĻĨā§‹āĻĒāĻ•āĻĨāύāĻŽā§‚āϞāĻ• āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύ āϞāϜāĻŋāĻ• āĻĻāĻŋāϝāĻŧ⧇ āĻĒā§āϰāϤāĻŋāĻ¸ā§āĻĨāĻžāĻĒāύ āĻ•āϰāĻŋāĨ¤

ā§§ā§Ļ. â˜•ī¸ [āϐāĻšā§āĻ›āĻŋāĻ•] āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āĻĒāĻžāχāĻĒāϞāĻžāχāύ (āĻļ⧁āϧ⧁āĻŽāĻžāĻ¤ā§āϰ āĻĒāĻĄāĻŧāĻž āϝāĻžāĻŦ⧇) — āĻāĻœā§‡āĻ¨ā§āϟ āĻ˛ā§‡ā§ŸāĻžāϰ

āĻāĻœā§‡āĻ¨ā§āϟ āĻ˛ā§‡ā§ŸāĻžāϰ āχāĻ¨ā§āĻŸā§‡āϞāĻŋāĻœā§‡āĻ¨ā§āϏ āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰ⧇ — āĻāĻœā§‡āĻ¨ā§āϟāϰāĻž āϟāĻžāĻ¸ā§āĻ• āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āĻ•āϰāϤ⧇ āϟ⧁āϞ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇āĨ¤ āĻĒā§āϰāϤāĻŋāϟāĻŋ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āĻāĻ•āϟāĻŋ āύāĻŋāĻ°ā§āĻĻāĻŋāĻˇā§āϟ āĻ­ā§‚āĻŽāĻŋāĻ•āĻž āĻĨāĻžāϕ⧇ āĻāĻŦāĻ‚ āĻāϟāĻŋ āĻĒāϰāĻŦāĻ°ā§āϤ⧀ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āĻ•āĻžāϛ⧇ āĻĒā§āϰāϏāĻ™ā§āĻ—āϟāĻŋ āĻĒāĻžāϏ āĻ•āϰ⧇āĨ¤ āĻŽāĻžāĻ˛ā§āϟāĻŋāĻāĻœā§‡āĻ¨ā§āϟ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽā§‡āϰ āφāĻ°ā§āĻ•āĻŋāĻŸā§‡āĻ•āϚāĻžāϰ āĻĄāĻžā§ŸāĻžāĻ—ā§āϰāĻžāĻŽ āύāĻŋāĻšā§‡ āĻĻ⧇āĻ“ā§ŸāĻž āĻšāϞāĨ¤

agent_diagram

ā§§. āĻāĻœā§‡āĻ¨ā§āϟ āĻĢāĻžāχāϞ āϖ⧁āϞ⧁āύ

👉đŸ’ģ āĻĢāĻžāχāϞāϟāĻŋ level_2/backend/agent/multimedia_agent.py āϖ⧁āϞ⧁āύ āĻ…āĻĨāĻŦāĻž āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āϟāĻžāχāĻĒ āĻ•āϰ⧇ āϖ⧁āϞ⧁āύāĨ¤ āύāϤ⧁āύ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āϖ⧁āϞ⧁āύāĨ¤ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/multimedia_agent.py

⧍. āφāĻĒāϞ⧋āĻĄ āĻāĻœā§‡āĻ¨ā§āϟ āĻĄāĻŋāĻĢāĻžāχāύ āĻ•āϰāĻž

āĻāχ āĻāĻœā§‡āĻ¨ā§āϟ āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āĻŽā§‡āϏ⧇āϜ āĻĨ⧇āϕ⧇ āĻĢāĻžāχāϞ⧇āϰ āĻĒāĻžāĻĨ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰ⧇ GCS-āĻ āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧇āĨ¤

👉multimedia_agent.py āĻĢāĻžāχāϞ⧇, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡, āĻāϟāĻŋ upload_agent āϤ⧈āϰāĻŋ āĻ•āϰ⧇ āϝāĻž GCS-āĻ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž āĻšāĻšā§āϛ⧇:

upload_agent = LlmAgent(
    name="UploadAgent",
    model="gemini-2.5-flash",
    instruction="""Extract the file path from the user's message and upload it.

Use `upload_media(file_path, survivor_id)` to upload the file.
The survivor_id is optional - include it if the user mentions a specific survivor (e.g., "survivor Sarah" -> "Sarah").
If the user provides a path like "/path/to/file", use that.

Return the upload result with gcs_uri and media_type.""",
    tools=[upload_media],
    output_key="upload_result"
)

ā§Š. āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•āĻļāύ āĻāĻœā§‡āĻ¨ā§āϟ āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰ⧁āύ

āĻāχ āĻāĻœā§‡āĻ¨ā§āϟ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž āĻŽāĻŋāĻĄāĻŋ⧟āĻž "āĻĻ⧇āϖ⧇" āĻāĻŦāĻ‚ Gemini Vision āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇ āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāĻ°ā§āĻĄ āĻĄā§‡āϟāĻž āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰ⧇āĨ¤

👉multimedia_agent.py āĻĢāĻžāχāϞ⧇, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āϏāĻš, āĻāϟāĻŋ extraction_agent āϤ⧈āϰāĻŋ āĻ•āϰ⧇ āϝāĻž āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž āĻŽāĻŋāĻĄāĻŋāϝāĻŧāĻž āĻĨ⧇āϕ⧇ āϤāĻĨā§āϝ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰ⧇:

extraction_agent = LlmAgent(
    name="ExtractionAgent", 
    model="gemini-2.5-flash",
    instruction="""Extract information from the uploaded media.

Previous step result: {upload_result}

Use `extract_from_media(gcs_uri, media_type, signed_url)` with the values from the upload result.
The gcs_uri is in upload_result['gcs_uri'], media_type in upload_result['media_type'], and signed_url in upload_result['signed_url'].

Return the extraction results including entities and relationships found.""",
    tools=[extract_from_media],
    output_key="extraction_result"
)

āϞāĻ•ā§āĻˇā§āϝ āĻ•āϰ⧁āύ āϕ⧀āĻ­āĻžāĻŦ⧇ instruction āϰ⧇āĻĢāĻžāϰ⧇āĻ¨ā§āϏ {upload_result} — āĻāχāĻ­āĻžāĻŦ⧇ ADK-āϤ⧇ āĻāĻœā§‡āĻ¨ā§āϟāĻĻ⧇āϰ āĻŽāĻ§ā§āϝ⧇ āĻ¸ā§āĻŸā§‡āϟ āĻĒāĻžāϏ āĻ•āϰāĻž āĻšā§ŸāĨ¤

ā§Ē. Spanner Agent-āĻāϰ āϏāĻ‚āĻœā§āĻžāĻž āĻĻāĻŋāύ

āĻāχ āĻāĻœā§‡āĻ¨ā§āϟ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻ“ āϏāĻŽā§āĻĒāĻ°ā§āĻ• āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ⧇ āϏ⧇āĻ­ āĻ•āϰ⧇āĨ¤

👉multimedia_agent.py āĻĢāĻžāχāϞ⧇, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡, āĻāϟāĻŋ spanner_agent āϤ⧈āϰāĻŋ āĻ•āϰ⧇ āϝāĻž āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž āϤāĻĨā§āϝ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ⧇ āϏ⧇āĻ­ āĻ•āϰ⧇:

spanner_agent = LlmAgent(
    name="SpannerAgent",
    model="gemini-2.5-flash", 
    instruction="""Save the extracted information to the database.

Upload result: {upload_result}
Extraction result: {extraction_result}

Use `save_to_spanner(extraction_result, survivor_id)` to save to Spanner.
Pass the WHOLE `extraction_result` object/dict from the previous step.
Include survivor_id if it was provided in the upload step.

Return the save statistics.""",
    tools=[save_to_spanner],
    output_key="spanner_result"
)

āĻāχ āĻāĻœā§‡āĻ¨ā§āϟ āĻĒā§‚āĻ°ā§āĻŦāĻŦāĻ°ā§āϤ⧀ āωāϭ⧟ āϧāĻžāĻĒ (upload_result āĻāĻŦāĻ‚ extraction_result) āĻĨ⧇āϕ⧇ āĻ•āĻ¨ā§āĻŸā§‡āĻ•ā§āϏāϟ āĻĒāĻžā§ŸāĨ¤

ā§Ģ. āϏāĻžāϰāϏāĻ‚āĻ•ā§āώ⧇āĻĒ āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āĻĄāĻŋāĻĢāĻžāχāύ āĻ•āϰ⧁āύ

āĻāχ āĻāĻœā§‡āĻ¨ā§āϟ āφāϗ⧇āϰ āϏāĻŦ āϧāĻžāĻĒ āĻĨ⧇āϕ⧇ āĻĒāĻžāĻ“ā§ŸāĻž āĻĢāϞāĻžāĻĢāϞāϕ⧇ āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āĻĒāĻ•ā§āώ⧇ āϏ⧁āĻŦāĻŋāϧāĻžāϜāύāĻ• āωāĻ¤ā§āϤāϰ⧇ āϏāĻ‚āĻļā§āϞ⧇āώāĻŋāϤ āĻ•āϰ⧇āĨ¤

👉multimedia_agent.py āĻĢāĻžāχāϞ⧇, āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡, āĻāϟāĻŋ summary_agent-āĻāϰ āϜāĻ¨ā§āϝ āĻĒā§āϰāĻŽā§āĻĒāϟ āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰ⧇ āϝāĻž āĻĢāϞāĻžāĻĢāϞāϕ⧇ āϏāĻ‚āĻ•ā§āώ⧇āĻĒāĻŋāϤ āĻ•āϰ⧇:

USE_MEMORY_BANK = os.getenv("USE_MEMORY_BANK", "false").lower() == "true"
save_msg = "6. Mention that the data is also being synced to the memory bank." if USE_MEMORY_BANK else ""

summary_instruction = f"""Provide a user-friendly summary of the media processing.

Upload: {{upload_result}}
Extraction: {{extraction_result}}
Database: {{spanner_result}}

Summarize:
1. What file was processed (name and type)
2. Key information extracted (survivors, skills, needs, resources found) - list names and counts
3. Relationships identified
4. What was saved to the database (broadcast ID, number of entities)
5. Any issues encountered
{save_msg}

Be concise but informative."""

āĻāχ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āϕ⧋āύāĻ“ āϟ⧁āϞ⧇āϰ āĻĒā§āĻ°ā§Ÿā§‹āϜāύ āύ⧇āχ — āĻāϟāĻŋ āĻļ⧁āϧ⧁ āĻļā§‡ā§ŸāĻžāϰ āĻ•āϰāĻž āĻ•āύāĻŸā§‡āĻ•ā§āϏāϟ āĻĒāĻĄāĻŧ⧇ āĻāĻŦāĻ‚ āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āϜāĻ¨ā§āϝ āĻāĻ•āϟāĻŋ āĻĒāϰāĻŋāĻˇā§āĻ•āĻžāϰ āϏāĻžāϰāϏāĻ‚āĻ•ā§āώ⧇āĻĒ āϤ⧈āϰāĻŋ āĻ•āϰ⧇āĨ¤

🧠 āφāĻ°ā§āĻ•āĻŋāĻŸā§‡āĻ•āϚāĻžāϰ āϏāĻžāĻŽāĻžāϰāĻŋ

āĻ¸ā§āϤāϰ

āĻĢāĻžāχāϞ

āĻĻāĻžā§ŸāĻŋāĻ¤ā§āĻŦ

āϟ⧁āϞāĻŋāĻ‚

extraction_tools.py + gcs_service.py

āϕ⧀āĻ­āĻžāĻŦ⧇ — āφāĻĒāϞ⧋āĻĄ, āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ, āϏ⧇āĻ­ āĻ•āϰ⧁āύ

Agent

multimedia_agent.py

āϕ⧀ — āĻĒāĻžāχāĻĒāϞāĻžāχāύ āĻ…āĻ°ā§āϕ⧇āĻ¸ā§āĻŸā§āϰ⧇āϟ āĻ•āϰāĻž

ā§§ā§§. 🚀 āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āĻĄā§‡āϟāĻž āĻĒāĻžāχāĻĒāϞāĻžāχāύ — āĻ…āĻ°ā§āϕ⧇āĻ¸ā§āĻŸā§āϰ⧇āĻļāύ

āφāĻŽāĻžāĻĻ⧇āϰ āύāϤ⧁āύ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽā§‡āϰ āĻŽā§‚āϞ āĻ­āĻŋāĻ¤ā§āϤāĻŋ āĻšāϞ backend/agent/multimedia_agent.py-āĻ āϏāĻ‚āĻœā§āĻžāĻžā§ŸāĻŋāϤ MultimediaExtractionPipelineāĨ¤ āĻāϟāĻŋ ADK (āĻāĻœā§‡āĻ¨ā§āϟ āĻĄā§‡āϭ⧇āϞāĻĒāĻŽā§‡āĻ¨ā§āϟ āĻ•āĻŋāϟ) āĻĨ⧇āϕ⧇ āϏāĻŋāĻ•ā§‹ā§Ÿā§‡āĻ¨ā§āϏāĻŋ⧟āĻžāϞ āĻāĻœā§‡āĻ¨ā§āϟ āĻĒā§āϝāĻžāϟāĻžāĻ°ā§āύ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇āĨ¤

ā§§. āϏāĻŋāĻ•ā§‹ā§Ÿā§‡āĻ¨ā§āϏāĻŋ⧟āĻžāϞ āϕ⧇āύ?

āφāĻĒāϞ⧋āĻĄ āĻĒā§āϰāϏ⧇āϏ āĻ•āϰāĻžāϰ āĻŦāĻŋāώ⧟āϟāĻŋ āĻāĻ•āϟāĻŋ āϞāĻŋāύāĻŋ⧟āĻžāϰ āĻĄāĻŋāĻĒ⧇āĻ¨ā§āĻĄā§‡āĻ¨ā§āϏāĻŋ āĻšā§‡āύ⧇āϰ āĻŽāϤ⧋:

  1. āφāĻĒāύāĻžāϰ āĻ•āĻžāϛ⧇ āĻĢāĻžāχāϞ āύāĻž āĻĨāĻžāĻ•āϞ⧇ āφāĻĒāύāĻŋ āĻĄā§‡āϟāĻž āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ āύāĻž (āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧁āύ)āĨ¤
  2. āφāĻĒāύāĻŋ āĻĄā§‡āϟāĻž āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āύāĻž āĻ•āϰāĻž āĻĒāĻ°ā§āϝāĻ¨ā§āϤ āϤāĻž āϏ⧇āĻ­ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ āύāĻž (āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•āĻļāύ)āĨ¤
  3. āĻĢāϞāĻžāĻĢāϞ āύāĻž āĻĒāĻžāĻ“ā§ŸāĻž āĻĒāĻ°ā§āϝāĻ¨ā§āϤ āφāĻĒāύāĻŋ āϏāĻžāϰāϏāĻ‚āĻ•ā§āώ⧇āĻĒ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ āύāĻž (āϏ⧇āĻ­ āĻ•āϰ⧁āύ)āĨ¤

āĻāϰ āϜāĻ¨ā§āϝ SequentialAgent āĻāĻ•āĻĻāĻŽ āωāĻĒāϝ⧁āĻ•ā§āϤāĨ¤ āĻāϟāĻŋ āĻāĻ•āϟāĻŋ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āφāωāϟāĻĒ⧁āϟāϕ⧇ āĻĒāϰāĻŦāĻ°ā§āϤ⧀ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āĻ•āύāĻŸā§‡āĻ•ā§āϏāϟ/āχāύāĻĒ⧁āϟ āĻšāĻŋāϏ⧇āĻŦ⧇ āĻĒāĻžāϏ āĻ•āϰ⧇āĨ¤

⧍. āĻāĻœā§‡āĻ¨ā§āϟ āĻĄā§‡āĻĢāĻŋāύāĻŋāĻļāύ

āφāϏ⧁āύ āĻĻ⧇āϖ⧇ āύ⧇āĻ“ā§ŸāĻž āϝāĻžāĻ•, āϕ⧀āĻ­āĻžāĻŦ⧇ multimedia_agent.py-āĻāϰ āύāĻŋāĻšā§‡ āĻĒāĻžāχāĻĒāϞāĻžāχāύ āĻ…ā§āϝāĻžāϏ⧇āĻŽā§āĻŦāϞ āĻ•āϰāĻž āĻšā§Ÿ: 👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/multimedia_agent.py

āĻāϟāĻŋ āφāϗ⧇āϰ āĻĻ⧁āϟāĻŋ āϧāĻžāĻĒ āĻĨ⧇āϕ⧇ āχāύāĻĒ⧁āϟ āĻ—ā§āϰāĻšāĻŖ āĻ•āϰ⧇āĨ¤ # TODO: REPLACE_ORCHESTRATION āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻĻ⧇āϖ⧁āύāĨ¤ āĻāχ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

    sub_agents=[upload_agent, extraction_agent, spanner_agent, summary_agent]

ā§Š. āϰ⧁āϟ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āϏāĻžāĻĨ⧇ āĻ•āĻžāύ⧇āĻ•ā§āϟ āĻ•āϰ⧁āύ

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/agent.py

# TODO: REPLACE_ADD_SUBAGENT āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻĻ⧇āϖ⧁āύāĨ¤ āĻāχ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

    sub_agents=[multimedia_agent],

āĻāχ āĻāĻ•āϟāĻŋ āĻ…āĻŦāĻœā§‡āĻ•ā§āϟ āĻ•āĻžāĻ°ā§āϝāĻ•āϰāĻ­āĻžāĻŦ⧇ āϚāĻžāϰāϟāĻŋ "āĻŦāĻŋāĻļ⧇āώāĻœā§āĻž"āϕ⧇ āĻāĻ•āϟāĻŋ āĻ•āϞ āĻ•āϰāĻž āϝāĻžā§Ÿ āĻāĻŽāύ āĻāĻ¨ā§āϟāĻŋāϟāĻŋāϤ⧇ āĻŦāĻžāĻ¨ā§āĻĄā§‡āϞ āĻ•āϰ⧇āĨ¤

ā§Ē. āĻāĻœā§‡āĻ¨ā§āϟāĻĻ⧇āϰ āĻŽāĻ§ā§āϝ⧇ āĻĄā§‡āϟāĻž āĻĢā§āϞ⧋

āĻĒā§āϰāϤāĻŋāϟāĻŋ āĻāĻœā§‡āĻ¨ā§āϟ āϤāĻžāϰ āφāωāϟāĻĒ⧁āϟ āĻāĻ•āϟāĻŋ āĻļ⧇āϝāĻŧāĻžāϰ āĻ•āϰāĻž āĻ•āύāĻŸā§‡āĻ•ā§āϏāĻŸā§‡ āĻ¸ā§āĻŸā§‹āϰ āĻ•āϰ⧇ āϝāĻž āĻĒāϰāĻŦāĻ°ā§āϤ⧀ āĻāĻœā§‡āĻ¨ā§āϟāϰāĻž āĻ…ā§āϝāĻžāĻ•ā§āϏ⧇āϏ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇:

architecture_uploading

ā§Ģ. āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύ āϖ⧁āϞ⧁āύ (āĻ…ā§āϝāĻžāĻĒ āĻāĻ–āύāĻ“ āϚāĻžāϞ⧁ āĻĨāĻžāĻ•āϞ⧇ āĻāĻĄāĻŧāĻŋā§Ÿā§‡ āϝāĻžāύ)

👉đŸ’ģ āĻ…ā§āϝāĻžāĻĒ āϚāĻžāϞ⧁ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2/
./start_app.sh

👉 āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āĻĨ⧇āϕ⧇ āϞ⧋āĻ•āĻžāϞ: http://localhost:5173/ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤

ā§Ŧ. āĻŸā§‡āĻ¸ā§āϟ āĻ›āĻŦāĻŋ āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧁āύ

👉 āĻšā§āϝāĻžāϟ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ⧇, āĻāĻ–āĻžāύ āĻĨ⧇āϕ⧇ āϝ⧇āϕ⧋āύāĻ“ āĻĢāĻŸā§‹ āĻŦ⧇āϛ⧇ āύāĻŋāύ āĻāĻŦāĻ‚ UI-āϤ⧇ āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧁āύ:

āĻšā§āϝāĻžāϟ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ⧇, āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āφāĻĒāύāĻžāϰ āύāĻŋāĻ°ā§āĻĻāĻŋāĻˇā§āϟ āĻĒā§āϰāϏāĻ™ā§āĻ— āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āĻŦāϞ⧁āύ:

Here is the survivor note

āϤāĻžāϰāĻĒāϰ āĻāĻ–āĻžāύ⧇ āĻ›āĻŦāĻŋ āĻ…ā§āϝāĻžāϟāĻžāϚ āĻ•āϰ⧁āύāĨ¤

upload_input

upload_result

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āφāĻĒāύāĻžāϰ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻž āĻšā§Ÿā§‡ āϗ⧇āϞ⧇, āĻĒā§āϰāϏ⧇āϏ āĻļ⧇āώ āĻ•āϰāϤ⧇ "Ctrl+C" āĻĒā§āϰ⧇āϏ āĻ•āϰ⧁āύāĨ¤

ā§Ŧ. GCS āĻŦāĻžāϕ⧇āĻŸā§‡ āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āφāĻĒāϞ⧋āĻĄāĻŋāĻ‚ āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ

  • Google Cloud Console Storage āϖ⧁āϞ⧁āύāĨ¤
  • āĻ•ā§āϞāĻžāωāĻĄ āĻ¸ā§āĻŸā§‹āϰ⧇āĻœā§‡ "āĻŦāĻžāϕ⧇āϟ" āĻŦ⧇āϛ⧇ āύāĻŋāύ

gcs

  • āφāĻĒāύāĻžāϰ āĻŦāĻžāϕ⧇āϟ āĻŦ⧇āϛ⧇ āύāĻŋāύ āĻāĻŦāĻ‚ media-āĻ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤

āĻŽāĻŋāĻĄāĻŋ⧟āĻž

  • āφāĻĒāύāĻžāϰ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāĻž āĻ›āĻŦāĻŋ āĻāĻ–āĻžāύ⧇ āĻĻ⧇āϖ⧁āύāĨ¤ uploaded_img

ā§­. Spanner-āĻ āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āφāĻĒāϞ⧋āĻĄāĻŋāĻ‚ āϝāĻžāϚāĻžāχ āĻ•āϰāĻž (āϐāĻšā§āĻ›āĻŋāĻ•)

test_photo1-āĻāϰ āϜāĻ¨ā§āϝ UI-āϤ⧇ āφāωāϟāĻĒ⧁āĻŸā§‡āϰ āωāĻĻāĻžāĻšāϰāĻŖ āύāĻŋāĻšā§‡ āĻĻ⧇āĻ“ā§ŸāĻž āĻšāϞāĨ¤

  • Google Cloud Console Spanner āϖ⧁āϞ⧁āύāĨ¤
  • āφāĻĒāύāĻžāϰ āχāύāĻ¸ā§āĻŸā§āϝāĻžāĻ¨ā§āϏ āĻŦ⧇āϛ⧇ āύāĻŋāύ: Survivor Network
  • āφāĻĒāύāĻžāϰ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ āĻŦ⧇āϛ⧇ āύāĻŋāύ: graph-db
  • āĻŦāĻžāρāĻĻāĻŋāϕ⧇āϰ āϏāĻžāχāĻĄāĻŦāĻžāϰ⧇, Spanner Studio āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ

👉 Spanner Studio-āϤ⧇, āύāϤ⧁āύ āĻĄā§‡āϟāĻž āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻ•āϰ⧁āύ:

SELECT 
  s.name AS Survivor,
  s.role AS Role,
  b.name AS Biome,
  r.name AS FoundResource,
  s.created_at
FROM Survivors s
LEFT JOIN SurvivorInBiome sib ON s.survivor_id = sib.survivor_id
LEFT JOIN Biomes b ON sib.biome_id = b.biome_id
LEFT JOIN SurvivorFoundResource sfr ON s.survivor_id = sfr.survivor_id
LEFT JOIN Resources r ON sfr.resource_id = r.resource_id
ORDER BY s.created_at DESC;

āφāĻŽāϰāĻž āύāĻŋāĻšā§‡āϰ āĻĢāϞāĻžāĻĢāϞ āĻĻ⧇āϖ⧇ āĻāϟāĻŋ āϝāĻžāϚāĻžāχ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŋ:

spanner_verify

⧧⧍. â˜•ī¸ [āϐāĻšā§āĻ›āĻŋāĻ•] āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ⧇āϰ āϏāĻžāĻĨ⧇ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ•

ā§§. āĻŽā§‡āĻŽāϰāĻŋ āϕ⧀āĻ­āĻžāĻŦ⧇ āĻ•āĻžāϜ āĻ•āϰ⧇

āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽāϟāĻŋ āϤāĻžā§ŽāĻ•ā§āώāĻŖāĻŋāĻ• āĻĒā§āϰāϏāĻ™ā§āĻ— āĻāĻŦāĻ‚ āĻĻā§€āĻ°ā§āϘāĻŽā§‡āϝāĻŧāĻžāĻĻā§€ āĻļāĻŋāĻ•ā§āώāĻž āωāĻ­āϝāĻŧāχ āĻĒāϰāĻŋāϚāĻžāϞāύāĻž āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āĻāĻ•āϟāĻŋ āĻĄā§āϝāĻŧāĻžāϞ-āĻŽā§‡āĻŽāϰāĻŋ āĻĒāĻĻā§āϧāϤāĻŋ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧇āĨ¤

memory_bank

⧍. āĻŽā§‡āĻŽāϰāĻŋ āϟāĻĒāĻŋāĻ• āϕ⧀?

āĻŽā§‡āĻŽāϰāĻŋ āϟāĻĒāĻŋāĻ• āϤāĻĨā§āϝ⧇āϰ āϏ⧇āχ āĻŦāĻŋāĻ­āĻžāĻ— āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰ⧇ āϝāĻž āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āĻ•āĻĨā§‹āĻĒāĻ•āĻĨāύ āϜ⧁āĻĄāĻŧ⧇ āĻŽāύ⧇ āϰāĻžāĻ–āϤ⧇ āĻšāĻŦ⧇āĨ¤ āĻāϗ⧁āϞāĻŋāϕ⧇ āĻŦāĻŋāĻ­āĻŋāĻ¨ā§āύ āϧāϰāύ⧇āϰ āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀āϰ āĻĒāĻ›āĻ¨ā§āĻĻ⧇āϰ āϜāĻ¨ā§āϝ āĻĢāĻžāχāϞāĻŋāĻ‚ āĻ•ā§āϝāĻžāĻŦāĻŋāύ⧇āϟ āĻšāĻŋāϏ⧇āĻŦ⧇ āĻ­āĻžāĻŦ⧁āύāĨ¤

āφāĻŽāĻžāĻĻ⧇āϰ ⧍āϟāĻŋ āĻŦāĻŋāώ⧟:

  1. search_preferences: āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀ āϕ⧀āĻ­āĻžāĻŦ⧇ āϏāĻžāĻ°ā§āϚ āĻ•āϰāϤ⧇ āĻĒāĻ›āĻ¨ā§āĻĻ āĻ•āϰ⧇āύ
    • āϤāĻžāϰāĻž āĻ•āĻŋ āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ āύāĻžāĻ•āĻŋ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ āĻĒāĻ›āĻ¨ā§āĻĻ āĻ•āϰ⧇āύ?
    • āϤāĻžāϰāĻž āĻĒā§āϰāĻžā§ŸāĻļāχ āϕ⧋āύ āĻĻāĻ•ā§āώāϤāĻž/āĻŦāĻžā§Ÿā§‹āĻŽ āϏāĻžāĻ°ā§āϚ āĻ•āϰ⧇āύ?
    • āĻŽā§‡āĻŽāϰāĻŋāϰ āωāĻĻāĻžāĻšāϰāĻŖ: "āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀ āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ āĻĻāĻ•ā§āώāϤāĻžāϰ āϜāĻ¨ā§āϝ āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āϏāĻžāĻ°ā§āϚ āĻĒāĻ›āĻ¨ā§āĻĻ āĻ•āϰ⧇āύ"
  2. urgent_needs_context: āϤāĻžāϰāĻž āϕ⧋āύ āϏāĻ™ā§āĻ•āϟ āĻŸā§āĻ°ā§āϝāĻžāĻ• āĻ•āϰāϛ⧇
    • āϤāĻžāϰāĻž āϕ⧋āύ āϰāĻŋāϏ⧋āĻ°ā§āϏ āĻŽāύāĻŋāϟāϰ āĻ•āϰāϛ⧇?
    • āϕ⧋āύ āϕ⧋āύ āĻŦ⧇āρāĻšā§‡ āĻĨāĻžāĻ•āĻž āĻŦā§āϝāĻ•ā§āϤāĻŋāĻĻ⧇āϰ āύāĻŋā§Ÿā§‡ āϤāĻžāϰāĻž āϚāĻŋāĻ¨ā§āϤāĻŋāϤ?
    • āĻŽā§‡āĻŽāϰāĻŋāϰ āωāĻĻāĻžāĻšāϰāĻŖ: "āĻŦā§āϝāĻŦāĻšāĻžāϰāĻ•āĻžāϰ⧀ āωāĻ¤ā§āϤāϰ āĻ•ā§āϝāĻžāĻŽā§āĻĒ⧇āϰ āĻ“āώ⧁āϧ⧇āϰ āϘāĻžāϟāϤāĻŋ āĻŸā§āĻ°ā§āϝāĻžāĻ• āĻ•āϰāϛ⧇āύ"

ā§Š. āĻŽā§‡āĻŽāϰāĻŋ āϟāĻĒāĻŋāĻ• āϏ⧇āϟ-āφāĻĒ āĻ•āϰāĻž

āĻ•āĻžāĻ¸ā§āϟāĻŽ āĻŽā§‡āĻŽāϰāĻŋ āϟāĻĒāĻŋāĻ• āĻĨ⧇āϕ⧇ āĻŦā§‹āĻāĻž āϝāĻžā§Ÿ āϝ⧇ āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āϕ⧀ āĻŽāύ⧇ āϰāĻžāĻ–āϤ⧇ āĻšāĻŦ⧇āĨ¤ āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāĻžāϰ āϏāĻŽā§Ÿ āĻāϗ⧁āϞāĻŋ āĻ•āύāĻĢāĻŋāĻ—āĻžāϰ āĻ•āϰāĻž āĻšā§ŸāĨ¤

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/deploy_agent.py

āĻāϟāĻŋ āφāĻĒāύāĻžāϰ āĻāĻĄāĻŋāϟāϰ⧇ ~/way-back-home/level_2/backend/deploy_agent.py āĻ–ā§‹āϞ⧇āĨ¤

āϕ⧋āύ āϤāĻĨā§āϝ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ“ āϏ⧇āĻ­ āĻ•āϰāϤ⧇ āĻšāĻŦ⧇ āϏ⧇āχ āĻŦāĻŋāĻˇā§Ÿā§‡ LLM-āϕ⧇ āύāĻŋāĻ°ā§āĻĻ⧇āĻļ āĻĻāĻŋāϤ⧇ āφāĻŽāϰāĻž āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāϰ MemoryTopic āĻ…āĻŦāĻœā§‡āĻ•ā§āϟ āύāĻŋāĻ°ā§āϧāĻžāϰāĻŖ āĻ•āϰāĻŋāĨ¤

👉deploy_agent.py āĻĢāĻžāχāϞ⧇, # TODO: SET_UP_TOPIC-āĻāϰ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤ⧇ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤāϟāĻŋ āϞāĻŋāϖ⧁āύ:

# backend/deploy_agent.py

    custom_topics = [
        # Topic 1: Survivor Search Preferences
        MemoryTopic(
            custom_memory_topic=CustomMemoryTopic(
                label="search_preferences",
                description="""Extract the user's preferences for how they search for survivors. Include:
                - Preferred search methods (keyword, semantic, direct lookup)
                - Common filters used (biome, role, status)
                - Specific skills they value or frequently look for
                - Geographic areas of interest (e.g., "forest biome", "mountain outpost")
                
                Example: "User prefers semantic search for finding similar skills."
                Example: "User frequently checks for survivors in the Swamp Biome."
                """,
            )
        ),
        # Topic 2: Urgent Needs Context
        MemoryTopic(
            custom_memory_topic=CustomMemoryTopic(
                label="urgent_needs_context",
                description="""Track the user's focus on urgent needs and resource shortages. Include:
                - Specific resources they are monitoring (food, medicine, ammo)
                - Critical situations they are tracking
                - Survivors they are particularly concerned about
                
                Example: "User is monitoring the medicine shortage in the Northern Camp."
                Example: "User is looking for a doctor for the injured survivors."
                """,
            )
        )
    ]

ā§Ē. āĻāĻœā§‡āĻ¨ā§āϟ āχāĻ¨ā§āϟāĻŋāĻ—ā§āϰ⧇āĻļāύ

āϤāĻĨā§āϝ āϏ⧇āĻ­ āĻ“ āĻĢāĻŋāϰāĻŋā§Ÿā§‡ āφāύāĻžāϰ āϜāĻ¨ā§āϝ āĻāĻœā§‡āĻ¨ā§āϟ āϕ⧋āĻĄāϕ⧇ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āϜāĻžāύāϤ⧇ āĻšāĻŦ⧇āĨ¤

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/agent/agent.py

āĻāϟāĻŋ āφāĻĒāύāĻžāϰ āĻāĻĄāĻŋāϟāϰ⧇ ~/way-back-home/level_2/backend/agent/agent.py āĻ–ā§‹āϞ⧇āĨ¤

āĻāĻœā§‡āĻ¨ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻž

āĻāĻœā§‡āĻ¨ā§āϟ āϤ⧈āϰāĻŋ āĻ•āϰāĻžāϰ āϏāĻŽā§Ÿ, āχāĻ¨ā§āϟāĻžāĻ°â€ā§āϝāĻžāĻ•āĻļāύ⧇āϰ āĻĒāϰ⧇ āϏ⧇āĻļāύ āϝāĻžāϤ⧇ āĻŽā§‡āĻŽāϰāĻŋāϤ⧇ āϏ⧇āĻ­ āĻšā§Ÿ āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰāϤ⧇ āφāĻŽāϰāĻž after_agent_callback āĻĒāĻžāϏ āĻ•āϰāĻŋāĨ¤ āĻšā§āϝāĻžāĻŸā§‡āϰ āωāĻ¤ā§āϤāϰ āĻĻ⧇āĻ“ā§ŸāĻžāϰ āĻ—āϤāĻŋ āϝāĻžāϤ⧇ āĻ•āĻŽā§‡ āύāĻž āϝāĻžā§Ÿ, āϏ⧇āχ āϜāĻ¨ā§āϝ add_session_to_memory āĻĢāĻžāĻ‚āĻļāύ āĻ…ā§āϝāĻžāϏāĻŋāĻ™ā§āĻ•ā§āϰ⧋āύāĻžāϏāĻ­āĻžāĻŦ⧇ āϰāĻžāύ āĻ•āϰ⧇āĨ¤

👉agent.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_ADD_SESSION_MEMORY āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

async def add_session_to_memory(
        callback_context: CallbackContext
) -> Optional[types.Content]:
    """Automatically save completed sessions to memory bank in the background"""
    if hasattr(callback_context, "_invocation_context"):
        invocation_context = callback_context._invocation_context
        if invocation_context.memory_service:
            # Use create_task to run this in the background without blocking the response
            asyncio.create_task(
                invocation_context.memory_service.add_session_to_memory(
                    invocation_context.session
                )
            )
            logger.info("Scheduled session save to memory bank in background")

āĻŦā§āϝāĻžāĻ•āĻ—ā§āϰāĻžāωāĻ¨ā§āĻĄ āϏ⧇āĻ­āĻŋāĻ‚

👉agent.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_ADD_MEMORY_BANK_TOOL āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāĻžāĻ˛ā§āĻŸā§‡ āĻĻāĻŋāύ:

if USE_MEMORY_BANK:
    agent_tools.append(PreloadMemoryTool())

👉agent.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_ADD_CALLBACK āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

    after_agent_callback=add_session_to_memory if USE_MEMORY_BANK else None

Vertex AI āϏ⧇āĻļāύ āĻĒāϰāĻŋāώ⧇āĻŦāĻž āϏ⧇āϟ-āφāĻĒ āĻ•āϰāĻž

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ Cloud Shell āĻāĻĄāĻŋāϟāϰ⧇ chat.py āĻĢāĻžāχāϞāϟāĻŋ āϖ⧁āϞ⧁āύ:

cloudshell edit ~/way-back-home/level_2/backend/api/routes/chat.py

👉chat.py āĻĢāĻžāχāϞ⧇, # TODO: REPLACE_VERTEXAI_SERVICES āĻ•āĻŽā§‡āĻ¨ā§āϟāϟāĻŋ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰ⧁āύ, āĻāχ āĻĒ⧁āϰ⧋ āϞāĻžāχāύāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āϕ⧋āĻĄ āĻĻāĻŋā§Ÿā§‡ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰ⧁āύ:

    session_service = VertexAiSessionService(
        project=project_id,
        location=location,
        agent_engine_id=agent_engine_id
    )
    memory_service = VertexAiMemoryBankService(
        project=project_id,
        location=location,
        agent_engine_id=agent_engine_id
    )

ā§§ā§Š. â˜•ī¸ [āϐāĻšā§āĻ›āĻŋāĻ•] āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ⧇āϰ āϏāĻžāĻĨ⧇ āĻāĻœā§‡āĻ¨ā§āϟ āĻ…ā§āϝāĻžāϟāĻžāϚ āĻ•āϰ⧁āύ

ā§§. āϏ⧇āϟ-āφāĻĒ āĻ“ āĻĄā§‡āĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ

āĻŽā§‡āĻŽāϰāĻŋ āĻĢāĻŋāϚāĻžāϰ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻžāϰ āφāϗ⧇, āφāĻĒāύāĻžāϕ⧇ āύāϤ⧁āύ āĻŽā§‡āĻŽāϰāĻŋ āϟāĻĒāĻŋāĻ• āϏāĻš āĻāĻœā§‡āĻ¨ā§āϟ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāϤ⧇ āĻšāĻŦ⧇ āĻāĻŦāĻ‚ āφāĻĒāύāĻžāϰ āĻāύāĻ­āĻžā§ŸāϰāύāĻŽā§‡āĻ¨ā§āϟ āϏāĻ āĻŋāĻ•āĻ­āĻžāĻŦ⧇ āĻ•āύāĻĢāĻŋāĻ—āĻžāϰ āĻ•āϰāĻž āφāϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰāϤ⧇ āĻšāĻŦ⧇āĨ¤

āĻāχ āĻĒā§āϰāϏ⧇āϏ āĻŽā§āϝāĻžāύ⧇āϜ āĻ•āϰāĻžāϰ āϜāĻ¨ā§āϝ āφāĻŽāϰāĻž āĻāĻ•āϟāĻŋ āĻ•āύāϭ⧇āύāĻŋā§Ÿā§‡āĻ¨ā§āϏ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āĻĒā§āϰāĻĻāĻžāύ āĻ•āϰ⧇āĻ›āĻŋāĨ¤

āĻĄāĻŋāĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āϚāĻžāϞāĻžāύ⧋ āĻšāĻšā§āϛ⧇

👉đŸ’ģ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻĄāĻŋāĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āϰāĻžāύ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2
./deploy_and_update_env.sh

āĻāχ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āĻ…ā§āϝāĻžāĻ•āĻļāύāϗ⧁āϞāĻŋ āϏāĻŽā§āĻĒāĻžāĻĻāύ āĻ•āϰ⧇:

  • Vertex AI-āĻāϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āĻāĻœā§‡āĻ¨ā§āϟ āĻ“ āĻŽā§‡āĻŽāϰāĻŋ āϟāĻĒāĻŋāĻ• āϰ⧇āϜāĻŋāĻ¸ā§āϟāĻžāϰ āĻ•āϰāϤ⧇ backend/deploy_agent.py āϰāĻžāύ āĻ•āϰ⧇āĨ¤
  • āύāϤ⧁āύ āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ āφāχāĻĄāĻŋ āĻ•ā§āϝāĻžāĻĒāϚāĻžāϰ āĻ•āϰ⧇āĨ¤
  • AGENT_ENGINE_ID-āĻāϰ āϏāĻžāĻĨ⧇ āφāĻĒāύāĻžāϰ .env āĻĢāĻžāχāϞ āĻ…āĻŸā§‹āĻŽā§‡āϟāĻŋāĻ• āφāĻĒāĻĄā§‡āϟ āĻ•āϰ⧇āĨ¤
  • āφāĻĒāύāĻžāϰ .env āĻĢāĻžāχāϞ⧇ USE_MEMORY_BANK=TRUE āϏ⧇āϟ āĻ•āϰāĻž āφāϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰ⧇āĨ¤

[!IMPORTANT] āφāĻĒāύāĻŋ deploy_agent.py-āĻ custom_topics-āĻ āĻĒāϰāĻŋāĻŦāĻ°ā§āϤāύ āĻ•āϰāϞ⧇, Agent Engine āφāĻĒāĻĄā§‡āϟ āĻ•āϰāϤ⧇ āφāĻĒāύāĻžāϕ⧇ āĻ…āĻŦāĻļā§āϝāχ āĻāχ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āφāĻŦāĻžāϰ āϰāĻžāύ āĻ•āϰāϤ⧇ āĻšāĻŦ⧇āĨ¤

āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ

āĻāĻ–āύ āφāĻĒāύāĻŋ āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āĻāĻ•āϟāĻŋ āĻĒāĻ›āĻ¨ā§āĻĻ āĻļāĻŋāĻ–āĻŋā§Ÿā§‡ āĻāĻŦāĻ‚ āϏ⧇āĻļāύ āϜ⧁āĻĄāĻŧ⧇ āĻāϟāĻŋ āĻŦāϜāĻžā§Ÿ āφāϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āĻšā§‡āĻ• āĻ•āϰ⧇ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āĻ•āĻžāϜ āĻ•āϰāϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āϝāĻžāϚāĻžāχ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύāĨ¤

āϧāĻžāĻĒ āĻāĻ•āĨ¤ āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύāϟāĻŋ āϖ⧁āϞāĻŦ⧇āύ?

āύāĻŋāĻšā§‡ āωāĻ˛ā§āϞ⧇āĻ– āĻ•āϰāĻž āύāĻŋāĻ°ā§āĻĻ⧇āĻļāĻžāĻŦāϞ⧀ āĻ…āύ⧁āϏāϰāĻŖ āĻ•āϰ⧇ āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύāϟāĻŋ āφāĻŦāĻžāϰ āϖ⧁āϞ⧁āύ: āφāϗ⧇āϰ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞāϟāĻŋ āĻāĻ–āύāĻ“ āϚāĻžāϞ⧁ āĻĨāĻžāĻ•āϞ⧇, Ctrls+C āĻĒā§āϰ⧇āϏ āĻ•āϰ⧇ āĻāϟāĻŋ āĻŦāĻ¨ā§āϧ āĻ•āϰ⧁āύāĨ¤

👉đŸ’ģ āĻ…ā§āϝāĻžāĻĒ āϚāĻžāϞ⧁ āĻ•āϰ⧁āύ:

cd ~/way-back-home/level_2/
./start_app.sh

👉 āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ āĻĨ⧇āϕ⧇ āϞ⧋āĻ•āĻžāϞ: http://localhost:5173/ āĻŦāĻŋāĻ•āĻ˛ā§āĻĒ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤

āϧāĻžāĻĒ āĻĻ⧁āχāĨ¤ āĻŸā§‡āĻ•ā§āϏāϟ āϏāĻš āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰāĻž āĻšāĻšā§āϛ⧇

āĻšā§āϝāĻžāϟ āχāĻ¨ā§āϟāĻžāϰāĻĢ⧇āϏ⧇, āĻāĻœā§‡āĻ¨ā§āϟāϕ⧇ āφāĻĒāύāĻžāϰ āύāĻŋāĻ°ā§āĻĻāĻŋāĻˇā§āϟ āĻĒā§āϰāϏāĻ™ā§āĻ— āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āĻŦāϞ⧁āύ:

"I'm planning a medical rescue mission in the mountains. I need survivors with first aid and climbing skills."

👉 āĻŦā§āϝāĻžāĻ•āĻ—ā§āϰāĻžāωāĻ¨ā§āĻĄā§‡ āĻŽā§‡āĻŽāϰāĻŋ āĻĒā§āϰāϏ⧇āϏ āĻšāĻ“ā§ŸāĻžāϰ āϜāĻ¨ā§āϝ ~ā§Šā§Ļ āϏ⧇āϕ⧇āĻ¨ā§āĻĄ āĻ…āĻĒ⧇āĻ•ā§āώāĻž āĻ•āϰ⧁āύāĨ¤

āϧāĻžāĻĒ āϤāĻŋāύāĨ¤ āύāϤ⧁āύ āϏ⧇āĻļāύ āĻļ⧁āϰ⧁ āĻ•āϰ⧁āύ

āĻŦāĻ°ā§āϤāĻŽāĻžāύ āĻ•āĻĨā§‹āĻĒāĻ•āĻĨāύ⧇āϰ āχāϤāĻŋāĻšāĻžāϏ (āĻ¸ā§āĻŦāĻ˛ā§āĻĒāĻŽā§‡ā§ŸāĻžāĻĻā§€ āĻŽā§‡āĻŽāϰāĻŋ) āĻŽā§āϛ⧇ āĻĢ⧇āϞāϤ⧇ āĻĒ⧃āĻˇā§āĻ āĻžāϟāĻŋ āϰāĻŋāĻĢā§āϰ⧇āĻļ āĻ•āϰ⧁āύāĨ¤

āφāĻĒāύāĻŋ āφāϗ⧇ āϝ⧇ āĻĒā§āϰāϏāĻ™ā§āĻ— āĻĻāĻŋā§Ÿā§‡āϛ⧇āύ āϤāĻžāϰ āωāĻĒāϰ āύāĻŋāĻ°ā§āĻ­āϰ āĻ•āϰ⧇ āĻĒā§āϰāĻļā§āύ āϜāĻŋāĻœā§āĻžāĻžāϏāĻž āĻ•āϰ⧁āύ:

"What kind of missions am I interested in?"

āĻĒā§āϰāĻ¤ā§āϝāĻžāĻļāĻŋāϤ āωāĻ¤ā§āϤāϰ:

"āφāĻĒāύāĻžāϰ āφāϗ⧇āϰ āĻ•āĻĨā§‹āĻĒāĻ•āĻĨāύ⧇āϰ āĻ­āĻŋāĻ¤ā§āϤāĻŋāϤ⧇, āφāĻĒāύāĻŋ āĻāϗ⧁āϞāĻŋāϤ⧇ āφāĻ—ā§āϰāĻšā§€:

  • āĻŽā§‡āĻĄāĻŋāϕ⧇āϞ āϰ⧇āϏāĻ•āĻŋāω āĻŽāĻŋāĻļāύ
  • āĻĒāĻžāĻšāĻžāĻĄāĻŧ/āωāĻšā§āϚ-āωāĻšā§āϚāϤāĻž āĻ…āĻĒāĻžāϰ⧇āĻļāύ
  • āĻĒā§āĻ°ā§Ÿā§‹āϜāĻ¨ā§€ā§Ÿ āĻĻāĻ•ā§āώāϤāĻž: āĻĒā§āϰāĻžāĻĨāĻŽāĻŋāĻ• āϚāĻŋāĻ•āĻŋā§ŽāϏāĻž, āĻ•ā§āϞāĻžāχāĻŽā§āĻŦāĻŋāĻ‚

āφāĻĒāύāĻŋ āĻ•āĻŋ āϚāĻžāύ āϝ⧇ āφāĻŽāĻŋ āĻāχ āĻŽāĻžāύāĻĻāĻŖā§āĻĄā§‡āϰ āϏāĻžāĻĨ⧇ āĻŽā§‡āϞ⧇ āĻāĻŽāύ āĻœā§€āĻŦāĻŋāϤ āĻŦā§āϝāĻ•ā§āϤāĻŋāĻĻ⧇āϰ āϖ⧁āρāĻœā§‡ āĻŦ⧇āϰ āĻ•āϰāĻŋ?"

āϚāϤ⧁āĻ°ā§āĻĨ āϧāĻžāĻĒāĨ¤ āĻ›āĻŦāĻŋ āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧇ āĻĒāϰ⧀āĻ•ā§āώāĻž āĻ•āϰ⧁āύ

āĻāĻ•āϟāĻŋ āĻ›āĻŦāĻŋ āφāĻĒāϞ⧋āĻĄ āĻ•āϰ⧇ āϜāĻŋāĻœā§āĻžāĻžāϏāĻž āĻ•āϰ⧁āύ:

remember this

āφāĻĒāύāĻŋ āĻāĻ–āĻžāύ⧇ āĻĻ⧇āĻ–āĻžāύ⧋ āϝ⧇āϕ⧋āύāĻ“ āĻĢāĻŸā§‹ āĻŦāĻž āφāĻĒāύāĻžāϰ āύāĻŋāĻœā§‡āϰ āĻĢāĻŸā§‹ āĻŦ⧇āϛ⧇ āύāĻŋā§Ÿā§‡ UI-āϤ⧇ āφāĻĒāϞ⧋āĻĄ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ:

āϧāĻžāĻĒ āĻĒāĻžāρāϚāĨ¤ Vertex AI āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ⧇ āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ

Google Cloud Console Agent Engine-āĻ āϝāĻžāύ

  1. āωāĻĒāϰ⧇ āĻŦāĻžāρāĻĻāĻŋāϕ⧇ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āϏāĻŋāϞ⧇āĻ•ā§āϟāϰ āĻĨ⧇āϕ⧇ āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āĻŦ⧇āϛ⧇ āύāĻŋā§Ÿā§‡āϛ⧇āύ āĻ•āĻŋāύāĻž āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰ⧁āύ:āĻĒā§āϰ⧋āĻœā§‡āĻ•ā§āϟ āϏāĻŋāϞ⧇āĻ•ā§āϟāϰ
  2. āφāϗ⧇āϰ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āĻĨ⧇āϕ⧇ āφāĻĒāύāĻŋ āϝ⧇ āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰ⧇āϛ⧇āύ āϏ⧇āϟāĻŋ āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ use_memory_bank.sh:āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύāφāĻĒāύāĻŋ āϝ⧇ āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ āϤ⧈āϰāĻŋ āĻ•āϰ⧇āϛ⧇āύ āϏ⧇āϟāĻŋāϤ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤
  3. āĻāχ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāĻž āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ Memories āĻŸā§āϝāĻžāĻŦ⧇ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύ, āφāĻĒāύāĻŋ āĻāĻ–āĻžāύ⧇ āϏāĻŦ āĻŽā§‡āĻŽāϰāĻŋ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύāĨ¤āĻŽā§‡āĻŽāϰāĻŋ āĻĻ⧇āϖ⧁āύ

👉đŸ’ģ āĻŸā§‡āĻ¸ā§āϟāĻŋāĻ‚ āĻļ⧇āώ āĻšā§Ÿā§‡ āϗ⧇āϞ⧇, āφāĻĒāύāĻžāϰ āϟāĻžāĻ°ā§āĻŽāĻŋāύāĻžāϞ⧇, āĻĒā§āϰāϏ⧇āϏ āĻļ⧇āώ āĻ•āϰāϤ⧇ "Ctrl + C" āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤

🎉 āĻ…āĻ­āĻŋāύāĻ¨ā§āĻĻāύ! āφāĻĒāύāĻŋ āĻāχāĻŽāĻžāĻ¤ā§āϰ āφāĻĒāύāĻžāϰ āĻāĻœā§‡āĻ¨ā§āĻŸā§‡āϰ āϏāĻžāĻĨ⧇ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āĻ…ā§āϝāĻžāϟāĻžāϚ āĻ•āϰ⧇āϛ⧇āύ!

ā§§ā§Ē. â˜•ī¸ [āϐāĻšā§āĻ›āĻŋāĻ•] Cloud Run-āĻ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰ⧁āύ

ā§§. āĻĄāĻŋāĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āϰāĻžāύ āĻ•āϰ⧁āύ

👉đŸ’ģ āĻĄāĻŋāĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āϚāĻžāϞāĻžāύ:

cd ~/way-back-home/level_2
./deploy_cloud_run.sh

āĻāϟāĻŋ āϏāĻĢāϞāĻ­āĻžāĻŦ⧇ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāĻžāϰ āĻĒāϰ⧇, āφāĻĒāύāĻŋ URL āĻĒāĻžāĻŦ⧇āύ, āĻāϟāĻŋ āφāĻĒāύāĻžāϰ āϜāĻ¨ā§āϝ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāĻž URL! āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāĻž āĻšā§Ÿā§‡āϛ⧇

👉đŸ’ģ URL āύ⧇āĻ“ā§ŸāĻžāϰ āφāϗ⧇, āĻāϟāĻŋ āϰāĻžāύ āĻ•āϰ⧇ āĻ…āύ⧁āĻŽāϤāĻŋ āĻĻāĻŋāύ:

source .env && gcloud run services add-iam-policy-binding survivor-frontend --region $REGION --member=allUsers --role=roles/run.invoker && gcloud run services add-iam-policy-binding survivor-backend --region $REGION --member=allUsers --role=roles/run.invoker

āĻĄā§‡āĻĒā§āϞ⧟ āĻ•āϰāĻž URL-āĻ āϝāĻžāύ āĻāĻŦāĻ‚ āϏ⧇āĻ–āĻžāύ⧇ āφāĻĒāύāĻžāϰ āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύ āϞāĻžāχāĻ­ āĻĻ⧇āĻ–āϤ⧇ āĻĒāĻžāĻŦ⧇āύ!

⧍. āĻŦāĻŋāĻ˛ā§āĻĄ āĻĒāĻžāχāĻĒāϞāĻžāχāύ āϏāĻŽā§āĻĒāĻ°ā§āϕ⧇ āĻŦā§‹āĻāĻž

cloudbuild.yaml āĻĢāĻžāχāϞāϟāĻŋ āύāĻŋāĻŽā§āύāϞāĻŋāĻ–āĻŋāϤ āĻ•ā§āϰāĻŽāĻŋāĻ• āϧāĻžāĻĒāϗ⧁āϞāĻŋ āϏāĻ‚āĻœā§āĻžāĻžāϝāĻŧāĻŋāϤ āĻ•āϰ⧇:

  1. āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄ āĻŦāĻŋāĻ˛ā§āĻĄ: backend/Dockerfile āĻĨ⧇āϕ⧇ āĻĄāĻ•āĻžāϰ āχāĻŽā§‡āϜ āϤ⧈āϰāĻŋ āĻ•āϰ⧇āĨ¤
  2. āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄ āĻĄāĻŋāĻĒā§āϞ⧟: Cloud Run-āĻ āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄ āĻ•āĻ¨ā§āĻŸā§‡āύāĻžāϰ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰ⧇āĨ¤
  3. URL āĻ•ā§āϝāĻžāĻĒāϚāĻžāϰ āĻ•āϰ⧁āύ: āύāϤ⧁āύ āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄ URL āĻĒāĻžāύāĨ¤
  4. āĻĢā§āϰāĻ¨ā§āϟāĻāĻ¨ā§āĻĄ āĻŦāĻŋāĻ˛ā§āĻĄ:
    • āĻĄāĻŋāĻĒ⧇āĻ¨ā§āĻĄā§‡āĻ¨ā§āϏāĻŋ āχāύāĻ¸ā§āϟāϞ āĻ•āϰ⧇āĨ¤
    • VITE_API_URL= āχāύāĻœā§‡āĻ•ā§āϟ āĻ•āϰ⧇ React āĻ…ā§āϝāĻžāĻĒ āϤ⧈āϰāĻŋ āĻ•āϰ⧇āĨ¤
  5. āĻĢā§āϰāĻ¨ā§āϟāĻāĻ¨ā§āĻĄ āχāĻŽā§‡āϜ: frontend/Dockerfile āĻĨ⧇āϕ⧇ Docker āχāĻŽā§‡āϜ āϤ⧈āϰāĻŋ āĻ•āϰ⧇ (āĻ¸ā§āĻŸā§āϝāĻžāϟāĻŋāĻ• āĻ…ā§āϝāĻžāϏ⧇āϟ āĻĒā§āϝāĻžāϕ⧇āϜ āĻ•āϰāĻž)āĨ¤
  6. āĻĢā§āϰāĻ¨ā§āϟāĻāĻ¨ā§āĻĄ āĻĄā§‡āĻĒā§āϞ⧟: āĻĢā§āϰāĻ¨ā§āϟāĻāĻ¨ā§āĻĄ āĻ•āĻ¨ā§āĻŸā§‡āύāĻžāϰ āĻĄā§‡āĻĒā§āϞ⧟ āĻ•āϰ⧇āĨ¤

ā§Š. āĻĄā§‡āĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ āϝāĻžāϚāĻžāχ āĻ•āϰ⧁āύ

āĻŦāĻŋāĻ˛ā§āĻĄ āϏāĻŽā§āĻĒā§‚āĻ°ā§āĻŖ āĻšā§Ÿā§‡ āϗ⧇āϞ⧇ (āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āĻŸā§‡āϰ āĻŽāĻžāĻ§ā§āϝāĻŽā§‡ āĻĻ⧇āĻ“ā§ŸāĻž āϞāĻ— āϞāĻŋāĻ™ā§āĻ• āĻšā§‡āĻ• āĻ•āϰ⧁āύ), āφāĻĒāύāĻŋ āĻāϗ⧁āϞāĻŋ āϝāĻžāϚāĻžāχ āĻ•āϰāϤ⧇ āĻĒāĻžāϰāĻŦ⧇āύ:

  1. Cloud Run Console-āĻ āϝāĻžāύāĨ¤
  2. survivor-frontend āĻĒāϰāĻŋāώ⧇āĻŦāĻž āϖ⧁āρāϜ⧁āύāĨ¤
  3. āĻ…ā§āϝāĻžāĻĒā§āϞāĻŋāϕ⧇āĻļāύ āϖ⧁āϞāϤ⧇ URL-āĻ āĻ•ā§āϞāĻŋāĻ• āĻ•āϰ⧁āύāĨ¤
  4. āĻĢā§āϰāĻ¨ā§āϟāĻāĻ¨ā§āĻĄ āĻŦā§āϝāĻžāĻ•āĻāĻ¨ā§āĻĄā§‡āϰ āϏāĻžāĻĨ⧇ āϝ⧋āĻ—āĻžāϝ⧋āĻ— āĻ•āϰāϤ⧇ āĻĒāĻžāϰāϛ⧇ āĻ•āĻŋāύāĻž āϤāĻž āύāĻŋāĻļā§āϚāĻŋāϤ āĻ•āϰāϤ⧇ āĻāĻ•āϟāĻŋ āϏāĻžāĻ°ā§āϚ āĻ•ā§‹ā§Ÿā§‡āϰāĻŋ āĻ•āϰ⧁āύāĨ¤

(āϐāĻšā§āĻ›āĻŋāĻ•) ā§Ē. āĻŽā§āϝāĻžāύ⧁⧟āĻžāϞ āĻĄāĻŋāĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ

āφāĻĒāύāĻŋ āϝāĻĻāĻŋ āĻŽā§āϝāĻžāύ⧁⧟āĻžāϞāĻŋ āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āϚāĻžāϞāĻžāϤ⧇ āϚāĻžāύ āĻŦāĻž āĻĒā§āϰāϏ⧇āϏāϟāĻŋ āφāϰāĻ“ āĻ­āĻžāϞ⧋āĻ­āĻžāĻŦ⧇ āĻŦ⧁āĻāϤ⧇ āϚāĻžāύ, āϤāĻžāĻšāϞ⧇ āϏāϰāĻžāϏāϰāĻŋ cloudbuild.yaml āϕ⧀āĻ­āĻžāĻŦ⧇ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰāĻŦ⧇āύ āϤāĻž āĻāĻ–āĻžāύ⧇ āĻĻ⧇āĻ“ā§ŸāĻž āĻšāϞāĨ¤

cloudbuild.yaml āϤ⧈āϰāĻŋ āĻ•āϰāĻž āĻšāĻšā§āϛ⧇

cloudbuild.yaml āĻĢāĻžāχāϞ Google Cloud Build-āϕ⧇ āĻŦāϞ⧇ āϝ⧇ āϕ⧋āύ āϕ⧋āύ āϧāĻžāĻĒ āĻāĻ•ā§āϏāĻŋāĻ•āĻŋāωāϟ āĻ•āϰāϤ⧇ āĻšāĻŦ⧇āĨ¤

  • āϧāĻžāĻĒ: āĻĒāϰāĻĒāϰ āĻ…ā§āϝāĻžāĻ•āĻļāύ⧇āϰ āϤāĻžāϞāĻŋāĻ•āĻžāĨ¤ āĻĒā§āϰāϤāĻŋāϟāĻŋ āϧāĻžāĻĒ āĻāĻ•āϟāĻŋ āĻ•āĻ¨ā§āĻŸā§‡āύāĻžāϰ⧇ āϚāϞ⧇ (āϝ⧇āĻŽāύ, docker, gcloud, node, bash)āĨ¤
  • substitutions: āĻŦāĻŋāĻ˛ā§āĻĄ āϟāĻžāχāĻŽā§‡ āĻĒāĻžāϏ āĻ•āϰāĻž āϝ⧇āϤ⧇ āĻĒāĻžāϰ⧇ āĻāĻŽāύ āϭ⧇āϰāĻŋā§Ÿā§‡āĻŦ⧇āϞ (āϝ⧇āĻŽāύ, $_REGION)āĨ¤
  • workspace: āĻāĻ•āϟāĻŋ āĻļā§‡ā§ŸāĻžāϰ āĻ•āϰāĻž āĻĄāĻŋāϰ⧇āĻ•ā§āϟāϰāĻŋ āϝ⧇āĻ–āĻžāύ⧇ āϧāĻžāĻĒāϗ⧁āϞāĻŋ āĻĢāĻžāχāϞ āĻļā§‡ā§ŸāĻžāϰ āĻ•āϰāϤ⧇ āĻĒāĻžāϰ⧇ (āϝ⧇āĻŽāύ āφāĻŽāϰāĻž āϝ⧇āĻ­āĻžāĻŦ⧇ backend_url.txt āĻļā§‡ā§ŸāĻžāϰ āĻ•āϰāĻŋ)āĨ¤

āĻĄāĻŋāĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ āϰāĻžāύ āĻ•āϰāĻž āĻšāĻšā§āϛ⧇

āĻ¸ā§āĻ•ā§āϰāĻŋāĻĒā§āϟ āĻ›āĻžāĻĄāĻŧāĻž āĻŽā§āϝāĻžāύ⧁⧟āĻžāϞāĻŋ āĻĄāĻŋāĻĒā§āϞ⧟ āĻ•āϰāϤ⧇, gcloud builds submit āĻ•āĻŽāĻžāĻ¨ā§āĻĄ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻ•āϰ⧁āύāĨ¤ āφāĻĒāύāĻžāϕ⧇ āĻ…āĻŦāĻļā§āϝāχ āĻĒā§āϰāϝāĻŧā§‹āϜāύ⧀āϝāĻŧ āϏāĻžāĻŦāĻ¸ā§āϟāĻŋāϟāĻŋāωāĻļāύ āϭ⧇āϰāĻŋāϝāĻŧ⧇āĻŦāϞ āĻĒāĻžāϏ āĻ•āϰāϤ⧇ āĻšāĻŦ⧇āĨ¤

# Load your env vars first or replace these values manually
export PROJECT_ID=your-project-id
export REGION=us-central1

gcloud builds submit --config cloudbuild.yaml \
    --project "$PROJECT_ID" \
    --substitutions _REGION="us-central1",_GOOGLE_API_KEY="",_AGENT_ENGINE_ID="your-agent-id",_USE_MEMORY_BANK="TRUE",_GOOGLE_GENAI_USE_VERTEXAI="TRUE"

ā§§ā§Ģ. āωāĻĒāϏāĻ‚āĻšāĻžāϰ

ā§§. āφāĻĒāύāĻŋ āϕ⧀ āϤ⧈āϰāĻŋ āĻ•āϰ⧇āϛ⧇āύ

✅ āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ: āύ⧋āĻĄ (āϏāĻžāϰāĻ­āĻžāχāĻ­āĻžāϰ, āĻĻāĻ•ā§āώāϤāĻž) āĻāĻŦāĻ‚ āĻāϜ (āϏāĻŽā§āĻĒāĻ°ā§āĻ•) āϏāĻš Spanner
✅ AI āϏāĻžāĻ°ā§āϚ: āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ āϏāĻš āϕ⧀āĻ“ā§ŸāĻžāĻ°ā§āĻĄ, āϏāĻŋāĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻāĻŦāĻ‚ āĻšāĻžāχāĻŦā§āϰāĻŋāĻĄ āϏāĻžāĻ°ā§āϚ
✅ āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ āĻĒāĻžāχāĻĒāϞāĻžāχāύ: Gemini-āĻāϰ āϏāĻžāĻšāĻžāĻ¯ā§āϝ⧇ āĻ›āĻŦāĻŋ/āĻ­āĻŋāĻĄāĻŋāĻ“ āĻĨ⧇āϕ⧇ āĻāĻ¨ā§āϟāĻŋāϟāĻŋ āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰāĻž
✅ āĻŽāĻžāĻ˛ā§āϟāĻŋ-āĻāĻœā§‡āĻ¨ā§āϟ āϏāĻŋāĻ¸ā§āĻŸā§‡āĻŽ: ADK-āĻāϰ āϏāĻžāĻĨ⧇ āϕ⧋-āĻ…āĻ°ā§āĻĄāĻŋāύ⧇āϟ āĻ•āϰāĻž āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻĢā§āϞ⧋
✅ āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ•: Vertex AI-āĻāϰ āϏāĻžāĻĨ⧇ āĻĻā§€āĻ°ā§āϘāĻŽā§‡ā§ŸāĻžāĻĻā§€ āĻĒāĻ›āĻ¨ā§āĻĻāĻŽāϤ⧋ āϏ⧇āϟ āĻ•āϰāĻž
✅ āĻĒā§āϰ⧋āĻĄāĻžāĻ•āĻļāύ āĻĄā§‡āĻĒā§āϞ⧟āĻŽā§‡āĻ¨ā§āϟ: Cloud Run + āĻāĻœā§‡āĻ¨ā§āϟ āχāĻžā§āϜāĻŋāύ

⧍. āφāĻ°ā§āĻ•āĻŋāĻŸā§‡āĻ•āϚāĻžāϰ āϏāĻ‚āĻ•ā§āϰāĻžāĻ¨ā§āϤ āϏāĻžāϰāϏāĻ‚āĻ•ā§āώ⧇āĻĒ

architecture_fullstack

ā§Š. āĻļ⧇āĻ–āĻžāϰ āĻŽā§‚āϞ āĻŦāĻŋāώ⧟

  1. Graph RAG: āχāĻ¨ā§āĻŸā§‡āϞāĻŋāĻœā§‡āĻ¨ā§āϟ āϏāĻžāĻ°ā§āĻšā§‡āϰ āϜāĻ¨ā§āϝ āϏ⧇āĻŽā§āϝāĻžāĻ¨ā§āϟāĻŋāĻ• āĻāĻŽā§āĻŦ⧇āĻĄāĻŋāĻ‚ā§Ÿā§‡āϰ āϏāĻžāĻĨ⧇ āĻ—ā§āϰāĻžāĻĢ āĻĄā§‡āϟāĻžāĻŦ⧇āϏ āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāϰāϕ⧇ āĻāĻ•āĻ¤ā§āϰāĻŋāϤ āĻ•āϰ⧇
  2. āĻŽāĻžāĻ˛ā§āϟāĻŋ-āĻāĻœā§‡āĻ¨ā§āϟ āĻĒā§āϝāĻžāϟāĻžāĻ°ā§āύ: āϜāϟāĻŋāϞ, āĻŽāĻžāĻ˛ā§āϟāĻŋ-āĻ¸ā§āĻŸā§‡āĻĒ āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻĢā§āϞ⧋āϰ āϜāĻ¨ā§āϝ āϏāĻŋāĻ•ā§‹ā§Ÿā§‡āĻ¨ā§āϏāĻŋ⧟āĻžāϞ āĻĒāĻžāχāĻĒāϞāĻžāχāύ
  3. āĻŽāĻžāĻ˛ā§āϟāĻŋāĻŽā§‹āĻĄāĻžāϞ AI: āφāύāĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāĻ°ā§āĻĄ āĻŽāĻŋāĻĄāĻŋ⧟āĻž (āĻ›āĻŦāĻŋ/āĻ­āĻŋāĻĄāĻŋāĻ“) āĻĨ⧇āϕ⧇ āĻ¸ā§āĻŸā§āϰāĻžāĻ•āϚāĻžāĻ°ā§āĻĄ āĻĄā§‡āϟāĻž āĻāĻ•ā§āϏāĻŸā§āĻ°ā§āϝāĻžāĻ•ā§āϟ āĻ•āϰ⧁āύ
  4. āĻ¸ā§āĻŸā§‡āϟāĻĢ⧁āϞ āĻāĻœā§‡āĻ¨ā§āϟ: āĻŽā§‡āĻŽāϰāĻŋ āĻŦā§āϝāĻžāĻ™ā§āĻ• āϏ⧇āĻļāύ āϜ⧁āĻĄāĻŧ⧇ āĻĒāĻ›āĻ¨ā§āĻĻāĻŽāϤ⧋ āϏ⧇āϟ āĻ•āϰāĻžāϰ āϏ⧁āĻŦāĻŋāϧāĻž āĻĻā§‡ā§Ÿ

ā§Ē. āĻ“ā§ŸāĻžāĻ°ā§āĻ•āĻļāĻĒ āĻ•āĻ¨ā§āĻŸā§‡āĻ¨ā§āϟ

ā§Ģ. āϰāĻŋāϏ⧋āĻ°ā§āϏ