ЁЯдЦ Graph RAG, ADK, рдФрд░ Memory Bank рдХреА рдорджрдж рд╕реЗ рдорд▓реНрдЯреАрдореЙрдбрд▓ рдПрдЖрдИ рдПрдЬреЗрдВрдЯ рдмрдирд╛рдирд╛

1. рдкрд░рд┐рдЪрдп

рдХрд╡рд░

1. рдЪреБрдиреМрддреА

рдЖрдкрджрд╛ рдХреЗ рд╕рдордп, рдЕрд▓рдЧ-рдЕрд▓рдЧ рдЬрдЧрд╣реЛрдВ рдкрд░ рдореМрдЬреВрдж рд▓реЛрдЧреЛрдВ рдХреА рдорджрдж рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдбреЗрдЯрд╛ рдХреЛ рдмреЗрд╣рддрд░ рддрд░реАрдХреЗ рд╕реЗ рдореИрдиреЗрдЬ рдХрд░рдиреЗ рдФрд░ рдЦреЛрдЬрдиреЗ рдХреА рдЬрд╝рд░реВрд░рдд рд╣реЛрддреА рд╣реИ. рдРрд╕рд╛ рдЗрд╕рд▓рд┐рдП, рдХреНрдпреЛрдВрдХрд┐ рд╣рд░ рд╡реНрдпрдХреНрддрд┐ рдХреА рдЬрд╝рд░реВрд░рддреЗрдВ, рдХреМрд╢рд▓, рдФрд░ рд╕рдВрд╕рд╛рдзрди рдЕрд▓рдЧ-рдЕрд▓рдЧ рд╣реЛрддреЗ рд╣реИрдВ. рдЗрд╕ рд╡рд░реНрдХрд╢реЙрдк рдореЗрдВ, рдЖрдкрдХреЛ рдПрдХ рдРрд╕рд╛ рдкреНрд░реЛрдбрдХреНрд╢рди рдПрдЖрдИ рд╕рд┐рд╕реНрдЯрдо рдмрдирд╛рдирд╛ рд╕рд┐рдЦрд╛рдпрд╛ рдЬрд╛рдПрдЧрд╛ рдЬрд┐рд╕рдореЗрдВ рдпреЗ рд╢рд╛рдорд┐рд▓ рд╣реИрдВ:

  1. ЁЯЧДя╕П рдЧреНрд░рд╛рдлрд╝ рдбреЗрдЯрд╛рдмреЗрд╕ (Spanner): рдЗрд╕рдореЗрдВ рдмрдЪреЗ рд╣реБрдП рд▓реЛрдЧреЛрдВ, рдЙрдирдХреА рд╕реНрдХрд┐рд▓, рдФрд░ рд╕рдВрд╕рд╛рдзрдиреЛрдВ рдХреЗ рдмреАрдЪ рдХреЗ рдЬрдЯрд┐рд▓ рд╕рдВрдмрдВрдзреЛрдВ рдХреЛ рд╕реНрдЯреЛрд░ рдХрд┐рдпрд╛ рдЬрд╛рддрд╛ рд╣реИ
  2. ЁЯФН рдПрдЖрдИ рдХреА рдорджрдж рд╕реЗ рдХрд╛рдо рдХрд░рдиреЗ рд╡рд╛рд▓реА рд╕рд░реНрдЪ рдХреА рд╕реБрд╡рд┐рдзрд╛: рдПрдВрдмреЗрдбрд┐рдВрдЧ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдХреЗ, рд╕рд┐рдореИрдВрдЯрд┐рдХ рдФрд░ рдХреАрд╡рд░реНрдб рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ рдХреА рд╕реБрд╡рд┐рдзрд╛
  3. ЁЯУ╕ рдорд▓реНрдЯреАрдореЙрдбрд▓ рдкреНрд░реЛрд╕реЗрд╕рд┐рдВрдЧ: рдЗрдореЗрдЬ, рдЯреЗрдХреНрд╕реНрдЯ, рдФрд░ рд╡реАрдбрд┐рдпреЛ рд╕реЗ рд╕реНрдЯреНрд░рдХреНрдЪрд░реНрдб рдбреЗрдЯрд╛ рдПрдХреНрд╕рдЯреНрд░реИрдХреНрдЯ рдХрд░рдирд╛
  4. ЁЯдЦ рдорд▓реНрдЯреА-рдПрдЬреЗрдВрдЯ рдСрд░реНрдХреЗрд╕реНрдЯреНрд░реЗрд╢рди: рдореБрд╢реНрдХрд┐рд▓ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ рдХреЗ рд▓рд┐рдП, рдЦрд╛рд╕ рдПрдЬреЗрдВрдЯ рдХреЗ рд╕рд╛рде рдорд┐рд▓рдХрд░ рдХрд╛рдо рдХрд░реЗрдВ
  5. ЁЯза Long-Term Memory: Vertex AI Memory Bank рдХреА рдорджрдж рд╕реЗ, рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреА рдкрд╕рдВрдж рдХреЗ рдореБрддрд╛рдмрд┐рдХрд╝ рдЕрдиреБрднрд╡ рджреЗрдирд╛

рдмрд╛рддрдЪреАрдд

2. рдЖрдкрдХреЛ рдХреНрдпрд╛ рдмрдирд╛рдирд╛ рд╣реЛрдЧрд╛

рд╕рд░реНрд╡рд╛рдЗрд╡рд░ рдиреЗрдЯрд╡рд░реНрдХ рдЧреНрд░рд╛рдлрд╝ рдбреЗрдЯрд╛рдмреЗрд╕, рдЬрд┐рд╕рдореЗрдВ рдпреЗ рд╢рд╛рдорд┐рд▓ рд╣реИрдВ:

  • ЁЯЧ║я╕П рд╣реЛрд▓реЛрдХреЙрд╕реНрдЯ рд╕реЗ рдмрдЪреЗ рд▓реЛрдЧреЛрдВ рдХреЗ рдмреАрдЪ рдХреЗ рд╕рдВрдмрдВрдзреЛрдВ рдХреЛ рджрд┐рдЦрд╛рдиреЗ рд╡рд╛рд▓рд╛ 3D рдЗрдВрдЯрд░реИрдХреНрдЯрд┐рд╡ рдЧреНрд░рд╛рдлрд╝ рд╡рд┐рдЬрд╝реБрдЕрд▓рд╛рдЗрдЬрд╝реЗрд╢рди
  • ЁЯФН рдЗрдВрдЯреЗрд▓рд┐рдЬреЗрдВрдЯ рд╕рд░реНрдЪ (рдХреАрд╡рд░реНрдб, рд╕рд┐рдореИрдВрдЯрд┐рдХ, рдФрд░ рд╣рд╛рдЗрдмреНрд░рд┐рдб)
  • рдорд▓реНрдЯреАрдореЛрдбрд▓ рдЕрдкрд▓реЛрдб рдкрд╛рдЗрдкрд▓рд╛рдЗрди (рдЗрдореЗрдЬ/рд╡реАрдбрд┐рдпреЛ рд╕реЗ рдЗрдХрд╛рдЗрдпрд╛рдВ рдирд┐рдХрд╛рд▓рдирд╛)
  • ЁЯдЦ рдореБрд╢реНрдХрд┐рд▓ рдЯрд╛рд╕реНрдХ рдХреЛ рдореИрдиреЗрдЬ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдорд▓реНрдЯреА-рдПрдЬреЗрдВрдЯ рд╕рд┐рд╕реНрдЯрдо
  • ЁЯза рд▓реЛрдЧреЛрдВ рдХреА рджрд┐рд▓рдЪрд╕реНрдкреА рдХреЗ рд╣рд┐рд╕рд╛рдм рд╕реЗ рдЗрдВрдЯрд░реИрдХреНрд╢рди рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдореЗрдореЛрд░реА рдмреИрдВрдХ рдЗрдВрдЯрд┐рдЧреНрд░реЗрд╢рди

3. Core Technologies

рдХреЙрдореНрдкреЛрдиреЗрдВрдЯ

рдЯреЗрдХреНрдиреЛрд▓реЙрдЬреА

рдордХрд╕рдж

рдбреЗрдЯрд╛рдмреЗрд╕

Cloud Spanner Graph

рдиреЛрдб (рд╕рд░реНрд╡рд╛рдЗрд╡рд░, рд╕реНрдХрд┐рд▓) рдФрд░ рдПрдЬ (рд░рд┐рд╢реНрддреЗ) рдХреЛ рд╕реНрдЯреЛрд░ рдХрд░рдирд╛

Search рдореЗрдВ рдПрдЖрдИ

Gemini + рдПрдореНрдмреЗрдбрд┐рдВрдЧ

рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ рдФрд░ рдорд┐рд▓рддреЗ-рдЬреБрд▓рддреЗ рдЬрд╡рд╛рдмреЛрдВ рдХреА рдЦреЛрдЬ

рдПрдЬреЗрдВрдЯ рдлрд╝реНрд░реЗрдорд╡рд░реНрдХ

ADK (Agent Development Kit)

рдПрдЖрдИ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ рдСрд░реНрдХреЗрд╕реНрдЯреНрд░реЗрдЯ рдХрд░реЗрдВ

рдЬрд╛рдирдХрд╛рд░реА рдпрд╛рдж рд░рдЦрдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛

Vertex AI Memory Bank

рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреА рдкрд╕рдВрдж рдХреЛ рд▓рдВрдмреЗ рд╕рдордп рддрдХ рд╕реЗрд╡ рд░рдЦрдиреЗ рдХреЗ рд▓рд┐рдП рд╕реНрдЯреЛрд░реЗрдЬ

рдлрд╝реНрд░рдВрдЯрдПрдВрдб

React + Three.js

рдЗрдВрдЯрд░реИрдХреНрдЯрд┐рд╡ 3D рдЧреНрд░рд╛рдлрд╝ рд╡рд┐рдЬрд╝реБрдЕрд▓рд╛рдЗрдЬрд╝реЗрд╢рди

2. ЁЯЫая╕П рдПрдирд╡рд╛рдпрд░рдореЗрдВрдЯ рд╕реЗрдЯ рдЕрдк рдХрд░рдирд╛ (рдЕрдЧрд░ рдЖрдк рд╡рд░реНрдХрд╢реЙрдк рдореЗрдВ рд╣реИрдВ, рддреЛ рдЗрд╕реЗ рдЫреЛрдбрд╝ рджреЗрдВ)

рдкрд╣рд▓рд╛ рд╣рд┐рд╕реНрд╕рд╛: рдмрд┐рд▓рд┐рдВрдЧ рдЦрд╛рддрд╛ рдЪрд╛рд▓реВ рдХрд░рдирд╛

рдЗрд╕ рдХреЛрдбрд▓реИрдм рдХреЛ рдЪрд▓рд╛рдиреЗ рдХреЗ рд▓рд┐рдП, рдЖрдкрдХреЗ рдкрд╛рд╕ рдХреБрдЫ рдХреНрд░реЗрдбрд┐рдЯ рд╡рд╛рд▓рд╛ рдмрд┐рд▓рд┐рдВрдЧ рдЦрд╛рддрд╛ рд╣реЛрдирд╛ рдЪрд╛рд╣рд┐рдП. рд╢реБрд░реВ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдЗрд╕ рдХреЛрдбрд▓реИрдм рдХреЗ рд╕рдмрд╕реЗ рдКрдкрд░ рдореМрдЬреВрдж рдмреИрдирд░ рдореЗрдВ рджрд┐рдП рдЧрдП рдХреНрд░реЗрдбрд┐рдЯ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░реЗрдВ. рдЕрдЧрд░ рдЖрдк рдкрд╣рд▓реЗ рд╕реЗ рд╣реА рдХрд┐рд╕реА рдмрд┐рд▓рд┐рдВрдЧ рдЦрд╛рддреЗ рд╕реЗ рдЬреБрдбрд╝реЗ рд╣реИрдВ, рддреЛ рдЗрд╕ рдЪрд░рдг рдХреЛ рдЫреЛрдбрд╝рд╛ рдЬрд╛ рд╕рдХрддрд╛ рд╣реИ.

рджреВрд╕рд░рд╛ рднрд╛рдЧ: рдУрдкрди рдПрдирд╡рд╛рдпрд░рдореЗрдВрдЯ

  1. ЁЯСЙ рд╕реАрдзреЗ Cloud Shell Editor рдкрд░ рдЬрд╛рдиреЗ рдХреЗ рд▓рд┐рдП, рдЗрд╕ рд▓рд┐рдВрдХ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ
  2. ЁЯСЙ рдЕрдЧрд░ рдЖрдЬ рдЖрдкрдХреЛ рдХрднреА рднреА рдЕрдиреБрдорддрд┐ рджреЗрдиреЗ рдХреЗ рд▓рд┐рдП рдХрд╣рд╛ рдЬрд╛рдП, рддреЛ рдЬрд╛рд░реА рд░рдЦрдиреЗ рдХреЗ рд▓рд┐рдП рдЕрдиреБрдорддрд┐ рджреЗрдВ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ. Cloud Shell рдХреЛ рдЕрдиреБрдорддрд┐ рджреЗрдиреЗ рдХреЗ рд▓рд┐рдП рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ
  3. ЁЯСЙ рдЕрдЧрд░ рдЯрд░реНрдорд┐рдирд▓ рд╕реНрдХреНрд░реАрди рдкрд░ рд╕рдмрд╕реЗ рдиреАрдЪреЗ рдирд╣реАрдВ рджрд┐рдЦрддрд╛ рд╣реИ, рддреЛ рдЙрд╕реЗ рдЦреЛрд▓реЗрдВ:
    • рджреЗрдЦреЗрдВ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ
    • TerminalCloud Shell Editor рдореЗрдВ рдирдпрд╛ рдЯрд░реНрдорд┐рдирд▓ рдЦреЛрд▓рдирд╛ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ
  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

3. ЁЯЫая╕П рдПрдирд╡рд╛рдпрд░рдореЗрдВрдЯ рд╕реЗрдЯрдЕрдк

1. Cloud Shell рдЦреЛрд▓реЗрдВ

Cloud Shell Editor рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, рдЕрдЧрд░ рдЯрд░реНрдорд┐рдирд▓ рд╕реНрдХреНрд░реАрди рдкрд░ рд╕рдмрд╕реЗ рдиреАрдЪреЗ рдирд╣реАрдВ рджрд┐рдЦрддрд╛ рд╣реИ, рддреЛ рдЙрд╕реЗ рдЦреЛрд▓реЗрдВ:

  • рджреЗрдЦреЗрдВ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ
  • Terminal рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ

Cloud Shell Editor рдореЗрдВ рдирдпрд╛ рдЯрд░реНрдорд┐рдирд▓ рдЦреЛрд▓рдирд╛

2. рдкреНрд░реЛрдЬреЗрдХреНрдЯ рдХреЙрдиреНрдлрд╝рд┐рдЧрд░ рдХрд░реЗрдВ

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, рдЕрдкрдирд╛ рдкреНрд░реЛрдЬреЗрдХреНрдЯ рдЖрдИрдбреА рд╕реЗрдЯ рдХрд░реЗрдВ:

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

ЁЯСЙЁЯТ╗ рдЬрд╝рд░реВрд░реА рдПрдкреАрдЖрдИ рдЪрд╛рд▓реВ рдХрд░реЗрдВ (рдЗрд╕рдореЗрдВ рдХрд░реАрдм рджреЛ рд╕реЗ рддреАрди рдорд┐рдирдЯ рд▓рдЧрддреЗ рд╣реИрдВ):

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

3. рдирд┐рд░реНрджреЗрд╢реЛрдВ рдХреА рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдЪрд▓рд╛рдПрдВ

ЁЯСЙЁЯТ╗ рд╕реЗрдЯрдЕрдк рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдХреЛ рдПрдХреНрдЬрд╝реАрдХреНрдпреВрдЯ рдХрд░реЗрдВ:

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

рдЗрд╕рд╕реЗ рдЖрдкрдХреЗ рд▓рд┐рдП .env рдмрди рдЬрд╛рдПрдЧрд╛. рдЕрдкрдиреЗ Cloud Shell рдореЗрдВ, way_back_homeрдкреНрд░реЛрдЬреЗрдХреНрдЯ рдЦреЛрд▓реЗрдВ. level_2 рдлрд╝реЛрд▓реНрдбрд░ рдореЗрдВ, рдЖрдкрдХреЛ рджрд┐рдЦреЗрдЧрд╛ рдХрд┐ рдЖрдкрдХреЗ рд▓рд┐рдП .env рдлрд╝рд╛рдЗрд▓ рдмрдирд╛рдИ рдЧрдИ рд╣реИ. рдЕрдЧрд░ рдЖрдкрдХреЛ рдпрд╣ рд╡рд┐рдХрд▓реНрдк рдирд╣реАрдВ рдорд┐рд▓ рд░рд╣рд╛ рд╣реИ, рддреЛ рдЗрд╕реЗ рджреЗрдЦрдиреЗ рдХреЗ рд▓рд┐рдП View -> Toggle Hidden File рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ. open_project

4. рд╕реИрдВрдкрд▓ рдбреЗрдЯрд╛ рд▓реЛрдб рдХрд░рдирд╛

ЁЯСЙЁЯТ╗ рдмреИрдХрдПрдВрдб рдкрд░ рдЬрд╛рдПрдВ рдФрд░ рдбрд┐рдкреЗрдВрдбреЗрдВрд╕реА рдЗрдВрд╕реНрдЯреЙрд▓ рдХрд░реЗрдВ:

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

4. ЁЯЪА Spanner Studio рдореЗрдВ рдЧреНрд░рд╛рдлрд╝ рдбреЗрдЯрд╛ рдХреЛ рд╡рд┐рдЬрд╝реБрдЕрд▓рд╛рдЗрдЬрд╝ рдХрд░рдирд╛

рдЗрд╕ рдЧрд╛рдЗрдб рдХреА рдорджрдж рд╕реЗ, Spanner Studio рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдХреЗ, рд╕реАрдзреЗ Google Cloud Console рдореЗрдВ Survivor Network рдХреЗ рдЧреНрд░рд╛рдлрд╝ рдбреЗрдЯрд╛ рдХреЛ рд╡рд┐рдЬрд╝реБрдЕрд▓рд╛рдЗрдЬрд╝ рдХрд┐рдпрд╛ рдЬрд╛ рд╕рдХрддрд╛ рд╣реИ рдФрд░ рдЙрд╕рд╕реЗ рдЗрдВрдЯрд░реИрдХреНрдЯ рдХрд┐рдпрд╛ рдЬрд╛ рд╕рдХрддрд╛ рд╣реИ. рдпрд╣ рдЕрдкрдиреЗ рдбреЗрдЯрд╛ рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░рдиреЗ рдФрд░ рдПрдЖрдИ рдПрдЬреЗрдВрдЯ рдмрдирд╛рдиреЗ рд╕реЗ рдкрд╣рд▓реЗ, рдЧреНрд░рд╛рдлрд╝ рдХреЗ рд╕реНрдЯреНрд░рдХреНрдЪрд░ рдХреЛ рд╕рдордЭрдиреЗ рдХрд╛ рдПрдХ рд╢рд╛рдирджрд╛рд░ рддрд░реАрдХрд╛ рд╣реИ.

1. Spanner Studio рдХреЛ рдРрдХреНрд╕реЗрд╕ рдХрд░рдирд╛

  1. рдЖрдЦрд┐рд░реА рдЪрд░рдг рдореЗрдВ, рд▓рд┐рдВрдХ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░рдХреЗ Spanner Studio рдЦреЛрд▓реЗрдВ.

spanner_studio

2. рдЧреНрд░рд╛рдлрд╝ рдХреЗ рд╕реНрдЯреНрд░рдХреНрдЪрд░ рдХреЛ рд╕рдордЭрдирд╛ ("рдмрдбрд╝реА рддрд╕реНрд╡реАрд░")

Survivor Network рдХреЗ рдбреЗрдЯрд╛рд╕реЗрдЯ рдХреЛ рд▓реЙрдЬрд┐рдХ рдкрдЬрд╝рд▓ рдпрд╛ рдЧреЗрдо рд╕реНрдЯреЗрдЯ рдХреА рддрд░рд╣ рд╕рдордЭреЗрдВ:

рдЗрдХрд╛рдИ

рд╕рд┐рд╕реНрдЯрдо рдореЗрдВ рднреВрдорд┐рдХрд╛

Analogy

Survivors

рдПрдЬреЗрдВрдЯ/рдЦрд┐рд▓рд╛рдбрд╝реА

рдЦрд┐рд▓рд╛рдбрд╝реА

рдмрд╛рдпреЛрдо

рд╡реЗ рдХрд╣рд╛рдВ рдореМрдЬреВрдж рд╣реИрдВ

рдореИрдк рдЬрд╝реЛрди

рд╕реНрдХрд┐рд▓

рдЗрдирдХреЗ рдкрд╛рд╕ рдХреНрдпрд╛ рдХрд░рдиреЗ рдХреА рдЕрдиреБрдорддрд┐ рд╣реИ

рддрд╛рдХрдд

рдЬрд╝рд░реВрд░рддреЗрдВ

рдЙрдирдХреЗ рдкрд╛рд╕ рдХрд┐рд╕ рдЪреАрдЬрд╝ рдХреА рдХрдореА рд╣реИ (рд╕рдорд╕реНрдпрд╛рдПрдВ)

рдорд┐рд╢рди

рд╕рдВрд╕рд╛рдзрди

рджреБрдирд┐рдпрд╛ рднрд░ рдореЗрдВ рдЦреЛрдЬреЗ рдЧрдП рдЖрдЗрдЯрдо

рд▓реВрдЯ

рд▓рдХреНрд╖реНрдп: рдПрдЖрдИ рдПрдЬреЗрдВрдЯ рдХрд╛ рдХрд╛рдо, рдмрд╛рдпреЛрдо (рдЬрдЧрд╣ рдХреА рд╕реАрдорд╛рдУрдВ) рдХреЛ рдзреНрдпрд╛рди рдореЗрдВ рд░рдЦрддреЗ рд╣реБрдП, рдЬрд╝рд░реВрд░рддреЛрдВ (рд╕рдорд╕реНрдпрд╛рдУрдВ) рдХреЛ рд╕реНрдХрд┐рд▓ (рд╕рдорд╛рдзрд╛рдиреЛрдВ) рд╕реЗ рдЬреЛрдбрд╝рдирд╛ рд╣реИ.

ЁЯФЧ рдПрдЬ (рд░рд┐рд▓реЗрд╢рдирд╢рд┐рдк):

  • SurvivorInBiome: рдЬрдЧрд╣ рдХреА рдЬрд╛рдирдХрд╛рд░реА рдЯреНрд░реИрдХ рдХрд░рдиреЗ рд╡рд╛рд▓реЗ рдРрдкреНрд▓рд┐рдХреЗрд╢рди
  • SurvivorHasSkill: рдХреНрд╖рдорддрд╛рдУрдВ рдХреА рдЗрдиреНрд╡реЗрдВрдЯреНрд░реА
  • SurvivorHasNeed: рдореМрдЬреВрджрд╛ рд╕рдорд╕реНрдпрд╛рдУрдВ рдХреА рд╕реВрдЪреА
  • SurvivorFoundResource: рдЖрдЗрдЯрдо рдХреА рдЗрдиреНрд╡реЗрдВрдЯреНрд░реА
  • SurvivorCanHelp: рдЕрдиреБрдорд╛рдирд┐рдд рд╕рдВрдмрдВрдз (рдПрдЖрдИ рдЗрд╕рдХрд╛ рд╣рд┐рд╕рд╛рдм рд▓рдЧрд╛рддрд╛ рд╣реИ!)

3. рдЧреНрд░рд╛рдлрд╝ рд╕реЗ рдХреНрд╡реЗрд░реА рдХрд░рдирд╛

рдЪрд▓рд┐рдП, рдбреЗрдЯрд╛ рдореЗрдВ рдореМрдЬреВрдж "рд╕реНрдЯреЛрд░реА" рдХреЛ рджреЗрдЦрдиреЗ рдХреЗ рд▓рд┐рдП рдХреБрдЫ рдХреНрд╡реЗрд░реА рдЪрд▓рд╛рддреЗ рд╣реИрдВ.

Spanner Graph, GQL (Graph Query Language) рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рддрд╛ рд╣реИ. рдХреЛрдИ рдХреНрд╡реЗрд░реА рдЪрд▓рд╛рдиреЗ рдХреЗ рд▓рд┐рдП, GRAPH SurvivorNetwork рдХреЗ рдмрд╛рдж рдореИрдЪ рдкреИрдЯрд░реНрди рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░реЗрдВ.

ЁЯСЙ Query 1: The Global Roster (Who is where?) рдпрд╣ рдЖрдкрдХреА рдмреБрдирд┐рдпрд╛рджреА рдЬрд╛рдирдХрд╛рд░реА рд╣реИ - рдмрдЪрд╛рд╡ рдЕрднрд┐рдпрд╛рди рдХреЗ рд▓рд┐рдП, рдЬрдЧрд╣ рдХреА рдЬрд╛рдирдХрд╛рд░реА рд╕рдордЭрдирд╛ рдЬрд╝рд░реВрд░реА рд╣реИ.

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

ЁЯСЙ Query 3: Who is in Crisis? ("рдорд┐рд╢рди рдмреЛрд░реНрдб") рджреЗрдЦреЗрдВ рдХрд┐ рдХрд┐рди рд▓реЛрдЧреЛрдВ рдХреЛ рдорджрдж рдХреА рдЬрд╝рд░реВрд░рдд рд╣реИ рдФрд░ рдЙрдиреНрд╣реЗрдВ рдХреНрдпрд╛ рдЪрд╛рд╣рд┐рдП.

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 рдЗрд╕ рдХреНрд╡реЗрд░реА рдХрд╛ рдХреНрдпрд╛ рдХрд╛рдо рд╣реИ:

рд╕рд┐рд░реНрдлрд╝ "рдлрд╝рд░реНрд╕реНрдЯ рдПрдб рд╕реЗ рдЬрд▓рдиреЗ рдХрд╛ рдЗрд▓рд╛рдЬ рдХрд┐рдпрд╛ рдЬрд╛рддрд╛ рд╣реИ" (рдЬреЛ рд╕реНрдХреАрдорд╛ рд╕реЗ рд╕рд╛рдлрд╝ рддреМрд░ рдкрд░ рдкрддрд╛ рдЪрд▓рддрд╛ рд╣реИ) рджрд┐рдЦрд╛рдиреЗ рдХреЗ рдмрдЬрд╛рдп, рдпрд╣ рдХреНрд╡реЗрд░реА рдпрд╣ рдвреВрдВрдврддреА рд╣реИ:

  • рдбреЙре░ рдПрд▓реЗрдирд╛ рдлрд╝реНрд░реЙрд╕реНрдЯ (рдЬрд┐рдиреНрд╣реЛрдВрдиреЗ рдореЗрдбрд┐рдХрд▓ рдЯреНрд░реЗрдирд┐рдВрдЧ рд▓реА рд╣реИ) тЖТ рдЗрд▓рд╛рдЬ рдХрд░ рд╕рдХрддреА рд╣реИрдВ тЖТ рдХреИрдкреНрдЯрди рдЯрдирд╛рдХрд╛ (рдЬреЛ рдЬрд▓ рдЧрдП рд╣реИрдВ)
  • рдбреЗрд╡рд┐рдб рдЪреЗрди (рдЬрд┐рдирдХреЗ рдкрд╛рд╕ рдлрд╝рд░реНрд╕реНрдЯ рдПрдб рд╣реИ) тЖТ рдЗрд▓рд╛рдЬ рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ тЖТ рд▓реЗрдлрд╝реНрдЯрд┐рдиреЗрдВрдЯ рдкрд╛рд░реНрдХ (рдЬрд┐рдирдХреЗ рдЯрдЦрдиреЗ рдореЗрдВ рдореЛрдЪ рдЖрдИ рд╣реИ)

рдпрд╣ рдХреНрдпреЛрдВ рдЕрд╕рд░рджрд╛рд░ рд╣реИ:

рдЖрдкрдХрд╛ рдПрдЖрдИ рдПрдЬреЗрдВрдЯ рдХреНрдпрд╛ рдХрд░реЗрдЧрд╛:

рдЬрдм рдХреЛрдИ рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдкреВрдЫрддрд╛ рд╣реИ рдХрд┐ "рдЬрд▓рдиреЗ рдХрд╛ рдЗрд▓рд╛рдЬ рдХреМрди рдХрд░ рд╕рдХрддрд╛ рд╣реИ?", рддреЛ рдПрдЬреЗрдВрдЯ:

  1. рдорд┐рд▓рддреА-рдЬреБрд▓рддреА рдЧреНрд░рд╛рдлрд╝ рдХреНрд╡реЗрд░реА рдЪрд▓рд╛рдирд╛
  2. рдЬрд╡рд╛рдм: "рдбреЙре░ рдлрд╝реНрд░реЙрд╕реНрдЯ рдХреЗ рдкрд╛рд╕ рдореЗрдбрд┐рдХрд▓ рдЯреНрд░реЗрдирд┐рдВрдЧ рд╣реИ рдФрд░ рд╡реЗ рдХреИрдкреНрдЯрди рдЯрдирд╛рдХрд╛ рдХреА рдорджрдж рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ"
  3. рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЛ рдЗрдВрдЯрд░рдореАрдбрд┐рдПрдЯ рдЯреЗрдмрд▓ рдпрд╛ рд░рд┐рд▓реЗрд╢рдирд╢рд┐рдк рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдЬрд╛рдирдиреЗ рдХреА рдЬрд╝рд░реВрд░рдд рдирд╣реАрдВ рд╣реИ!

5. ЁЯЪА Spanner рдореЗрдВ рдПрдЖрдИ рдХреА рдорджрдж рд╕реЗ рдХрд╛рдо рдХрд░рдиреЗ рд╡рд╛рд▓реА рдПрдВрдмреЗрдбрд┐рдВрдЧ

1. рдПрдВрдмреЗрдбрд┐рдВрдЧ рдХреНрдпреЛрдВ? (рдХреЛрдИ рдХрд╛рд░реНрд░рд╡рд╛рдИ рдирд╣реАрдВ, рд╕рд┐рд░реНрдлрд╝ рдкрдврд╝рдиреЗ рдХреЗ рд▓рд┐рдП)

рдХрд┐рд╕реА рдЖрдкрджрд╛ рдХреЗ рд╕рдордп, рд╕рдордп рдмрд╣реБрдд рдорд╛рдпрдиреЗ рд░рдЦрддрд╛ рд╣реИ. рдЬрдм рдХреЛрдИ рд╡реНрдпрдХреНрддрд┐ рдХрд┐рд╕реА рдЖрдкрд╛рддрдХрд╛рд▓реАрди рд╕реНрдерд┐рддрд┐ рдХреА рд░рд┐рдкреЛрд░реНрдЯ рдХрд░рддрд╛ рд╣реИ, рдЬреИрд╕реЗ рдХрд┐ I need someone who can treat burns рдпрд╛ Looking for a medic, рддреЛ рд╡рд╣ рдбреЗрдЯрд╛рдмреЗрд╕ рдореЗрдВ рдореМрдЬреВрдж рд╕реНрдХрд┐рд▓ рдХреЗ рд╕рдЯреАрдХ рдирд╛рдореЛрдВ рдХрд╛ рдЕрдиреБрдорд╛рди рд▓рдЧрд╛рдиреЗ рдореЗрдВ рд╕рдордп рдмрд░реНрдмрд╛рдж рдирд╣реАрдВ рдХрд░ рд╕рдХрддрд╛.

Real Scenario: Survivor: Captain Tanaka has burnsтАФwe need medical help NOW!

"medic" рдХреЗ рд▓рд┐рдП рдкрд╛рд░рдВрдкрд░рд┐рдХ рдХреАрд╡рд░реНрдб рд╕рд░реНрдЪ тЖТ 0 рдирддреАрдЬреЗ тЭМ

рдПрдореНрдмреЗрдбрд┐рдВрдЧ рдХреЗ рд╕рд╛рде рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ тЖТ "рдореЗрдбрд┐рдХрд▓ рдЯреНрд░реЗрдирд┐рдВрдЧ", "рдлрд╝рд░реНрд╕реНрдЯ рдПрдб" рдХреЛ рдЦреЛрдЬрддрд╛ рд╣реИ тЬЕ

рдПрдЬреЗрдВрдЯ рдХреЛ рдареАрдХ рдЗрд╕реА рдХреА рдЬрд╝рд░реВрд░рдд рд╣реЛрддреА рд╣реИ: рдЗрдВрд╕рд╛рди рдХреА рддрд░рд╣ рдХрд╛рдо рдХрд░рдиреЗ рд╡рд╛рд▓реА рдЗрдВрдЯреЗрд▓рд┐рдЬреЗрдВрдЯ рд╕рд░реНрдЪ, рдЬреЛ рд╕рд┐рд░реНрдлрд╝ рдХреАрд╡рд░реНрдб рд╣реА рдирд╣реАрдВ, рдмрд▓реНрдХрд┐ рдордХрд╕рдж рдХреЛ рднреА рд╕рдордЭрддреА рд╣реИ.

2. рдПрдВрдмреЗрдбрд┐рдВрдЧ рдореЙрдбрд▓ рдмрдирд╛рдПрдВ

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 рдкрд░ рд▓реЗ рдЬрд╛рддрд╛ рд╣реИ
  • рдХреЙрдиреНрдЯреНрд░реИрдХреНрдЯ рддрдп рдХрд░рддрд╛ рд╣реИ: рдЗрдирдкреБрдЯ рдЯреЗрдХреНрд╕реНрдЯ рд╣реИ, рдЖрдЙрдЯрдкреБрдЯ 768-рдбрд╛рдЗрдореЗрдВрд╢рди рд╡рд╛рд▓рд╛ рдлрд╝реНрд▓реЛрдЯ рдХрд▓реЗрдХреНрд╢рди рд╣реИ

"рд░рд┐рдореЛрдЯ рд╡рд┐рдХрд▓реНрдк" рдХреНрдпреЛрдВ?

  • Spanner, рдореЙрдбрд▓ рдХреЛ рдЦреБрдж рдирд╣реАрдВ рдЪрд▓рд╛рддрд╛
  • ML.PREDICT рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдиреЗ рдкрд░, рдпрд╣ рдПрдкреАрдЖрдИ рдХреЗ рдЬрд╝рд░рд┐рдП Vertex AI рдХреЛ рдХреЙрд▓ рдХрд░рддрд╛ рд╣реИ
  • рдЬрд╝реАрд░реЛ-рдИрдЯреАрдПрд▓: рдбреЗрдЯрд╛ рдХреЛ Python рдореЗрдВ рдПрдХреНрд╕рдкреЛрд░реНрдЯ рдХрд░рдиреЗ, рдкреНрд░реЛрд╕реЗрд╕ рдХрд░рдиреЗ, рдФрд░ рдлрд┐рд░ рд╕реЗ рдЗрдВрдкреЛрд░реНрдЯ рдХрд░рдиреЗ рдХреА рдЬрд╝рд░реВрд░рдд рдирд╣реАрдВ рд╣реИ

Run рдмрдЯрди рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ. рдЗрд╕рдХреЗ рдмрд╛рдж, рдЖрдкрдХреЛ рдЗрд╕ рддрд░рд╣ рдХрд╛ рдирддреАрдЬрд╛ рджрд┐рдЦреЗрдЧрд╛:

spanner_result

3. рдПрдВрдмреЗрдбрд┐рдВрдЧ рдХреЙрд▓рдо рдЬреЛрдбрд╝реЗрдВ

ЁЯСЙ рдПрдВрдмреЗрдбрд┐рдВрдЧ рдХреЛ рд╕реЗрд╡ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП рдПрдХ рдХреЙрд▓рдо рдЬреЛрдбрд╝реЗрдВ:

ALTER TABLE Skills ADD COLUMN skill_embedding ARRAY<FLOAT32>;

Run рдмрдЯрди рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ. рдЗрд╕рдХреЗ рдмрд╛рдж, рдЖрдкрдХреЛ рдЗрд╕ рддрд░рд╣ рдХрд╛ рдирддреАрдЬрд╛ рджрд┐рдЦреЗрдЧрд╛:

embedding_result

4. рдПрдВрдмреЗрдбрд┐рдВрдЧ рдЬрдирд░реЗрдЯ рдХрд░реЗрдВ

ЁЯСЙ рд╣рд░ рд╕реНрдХрд┐рд▓ рдХреЗ рд▓рд┐рдП рд╡реЗрдХреНрдЯрд░ рдПрдВрдмреЗрдбрд┐рдВрдЧ рдмрдирд╛рдиреЗ рдХреЗ рд▓рд┐рдП, рдПрдЖрдИ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░реЗрдВ:

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

рдХреНрдпрд╛ рд╣реЛрддрд╛ рд╣реИ: рд╣рд░ рд╕реНрдХрд┐рд▓ рдХреЗ рдирд╛рдо (рдЬреИрд╕реЗ, "рдлрд╝рд░реНрд╕реНрдЯ рдПрдб") рдХреЛ 768-рдбрд╛рдЗрдореЗрдВрд╢рди рд╡рд╛рд▓реЗ рд╡реЗрдХреНрдЯрд░ рдореЗрдВ рдмрджрд▓рд╛ рдЬрд╛рддрд╛ рд╣реИ. рдЗрд╕рд╕реЗ рдЙрд╕рдХреЗ рд╕рд┐рдореИрдВрдЯрд┐рдХ рдорддрд▓рдм рдХрд╛ рдкрддрд╛ рдЪрд▓рддрд╛ рд╣реИ.

5. рдПрдВрдмреЗрдбрд┐рдВрдЧ рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░рдирд╛

ЁЯСЙ рдЬрд╛рдВрдЪреЗрдВ рдХрд┐ рдПрдВрдмреЗрдбрд┐рдВрдЧ рдмрдирд╛рдИ рдЧрдИ рд╣реИрдВ рдпрд╛ рдирд╣реАрдВ:

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

рдЕрдиреБрдорд╛рдирд┐рдд рдЖрдЙрдЯрдкреБрдЯ:

spanner_result

рдЕрдм рд╣рдо рдЕрдкрдиреА рд╕реНрдерд┐рддрд┐ рдХреЗ рд╣рд┐рд╕рд╛рдм рд╕реЗ, рдЗрд╕реНрддреЗрдорд╛рд▓ рдХреЗ рд╕рдЯреАрдХ рдЙрджрд╛рд╣рд░рдг рдХреА рдЬрд╛рдВрдЪ рдХрд░рддреЗ рд╣реИрдВ: "рдореЗрдбрд┐рдХ" рд╢рдмреНрдж рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдХреЗ, рдореЗрдбрд┐рдХрд▓ рд╕реНрдХрд┐рд▓ рдвреВрдВрдврдирд╛.

ЁЯСЙ "рдореЗрдбрд┐рдХ" рд╕реЗ рдорд┐рд▓рддреА-рдЬреБрд▓рддреА рд╕реНрдХрд┐рд▓ рдвреВрдВрдвреЗрдВ:

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

7. рд╡рд┐рд╢реНрд▓реЗрд╖рдг рдХреЗ рд▓рд┐рдП Gemini рдореЙрдбрд▓ рдмрдирд╛рдирд╛

spanner_gemini

ЁЯСЙ рдЬрдирд░реЗрдЯрд┐рд╡ рдПрдЖрдИ рдореЙрдбрд▓ рдХрд╛ рд░реЗрдлрд╝рд░рдВрд╕ рдмрдирд╛рдПрдВ ($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

8. рд╕рд╛рде рдХрд╛рдо рдХрд░рдиреЗ рдХреА рдХреНрд╖рдорддрд╛ рдХрд╛ рд╡рд┐рд╢реНрд▓реЗрд╖рдг рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП 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."

6. ЁЯЪА рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ рдХреА рдорджрдж рд╕реЗ Graph RAG рдПрдЬреЗрдВрдЯ рдмрдирд╛рдирд╛

1. рд╕рд┐рд╕реНрдЯрдо рдЖрд░реНрдХрд┐рдЯреЗрдХреНрдЪрд░ рдХреА рдЦрд╛рд╕ рдЬрд╛рдирдХрд╛рд░реА

рдпрд╣ рд╕реЗрдХреНрд╢рди, рдХрдИ рддрд░реАрдХреЛрдВ рд╕реЗ рдЦреЛрдЬ рдХрд░рдиреЗ рд╡рд╛рд▓рд╛ рд╕рд┐рд╕реНрдЯрдо рдмрдирд╛рддрд╛ рд╣реИ. рдЗрд╕рд╕реЗ рдЖрдкрдХреЗ рдПрдЬреЗрдВрдЯ рдХреЛ рдЕрд▓рдЧ-рдЕрд▓рдЧ рддрд░рд╣ рдХреА рдХреНрд╡реЗрд░реА рдХреЛ рдореИрдиреЗрдЬ рдХрд░рдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛ рдорд┐рд▓рддреА рд╣реИ. рдЗрд╕ рд╕рд┐рд╕реНрдЯрдо рдореЗрдВ рддреАрди рд▓реЗрдпрд░ рд╣реЛрддреА рд╣реИрдВ: рдПрдЬреЗрдВрдЯ рд▓реЗрдпрд░, рдЯреВрд▓ рд▓реЗрдпрд░, рдФрд░ рд╕рд░реНрд╡рд┐рд╕ рд▓реЗрдпрд░.

architecture_hybrid_search

рддреАрди рд▓реЗрдпрд░ рдХреНрдпреЛрдВ?

  • рдЕрд▓рдЧ-рдЕрд▓рдЧ рдЬрд╝рд┐рдореНрдореЗрджрд╛рд░рд┐рдпрд╛рдВ: рдПрдЬреЗрдВрдЯ рдХрд╛ рдлрд╝реЛрдХрд╕ рдЗрдВрдЯреЗрдВрдЯ рдкрд░ рд╣реЛрддрд╛ рд╣реИ, рдЯреВрд▓ рдХрд╛ рдлрд╝реЛрдХрд╕ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдкрд░ рд╣реЛрддрд╛ рд╣реИ, рдФрд░ рд╕реЗрд╡рд╛ рдХрд╛ рдлрд╝реЛрдХрд╕ рд▓рд╛рдЧреВ рдХрд░рдиреЗ рдкрд░ рд╣реЛрддрд╛ рд╣реИ
  • рд▓рдЪреАрд▓рд╛рдкрди: рдПрдЬреЗрдВрдЯ, рдкреЗрдореЗрдВрдЯ рдХреЗ рдЦрд╛рд╕ рддрд░реАрдХреЗ рд▓рд╛рдЧреВ рдХрд░ рд╕рдХрддрд╛ рд╣реИ рдпрд╛ рдПрдЖрдИ рдХреЛ рдЕрдкрдиреЗ-рдЖрдк рд░реВрдЯ рдХрд░рдиреЗ рдХреА рдЕрдиреБрдорддрд┐ рджреЗ рд╕рдХрддрд╛ рд╣реИ
  • рдСрдкреНрдЯрд┐рдорд╛рдЗрдЬрд╝реЗрд╢рди: рдЕрдЧрд░ рддрд░реАрдХрд╛ рдкрд╣рд▓реЗ рд╕реЗ рдкрддрд╛ рд╣реИ, рддреЛ рдПрдЖрдИ рдХреА рдорджрдж рд╕реЗ рдорд╣рдВрдЧреЗ рд╡рд┐рд╢реНрд▓реЗрд╖рдг рдХреА рдЬрд╝рд░реВрд░рдд рдирд╣реАрдВ рдкрдбрд╝рддреА

рдЗрд╕ рд╕реЗрдХреНрд╢рди рдореЗрдВ, рдореБрдЦреНрдп рд░реВрдк рд╕реЗ рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ (рдЖрд░рдПрдЬреА) рдХреЛ рд▓рд╛рдЧреВ рдХрд┐рдпрд╛ рдЬрд╛рдПрдЧрд╛. рдЗрд╕рд╕реЗ рд╕рд┐рд░реНрдлрд╝ рдХреАрд╡рд░реНрдб рдХреЗ рдмрдЬрд╛рдп, рдорддрд▓рдм рдХреЗ рдЖрдзрд╛рд░ рдкрд░ рдирддреАрдЬреЗ рдвреВрдВрдвреЗ рдЬрд╛ рд╕рдХреЗрдВрдЧреЗ. рдЗрд╕рдХреЗ рдмрд╛рдж, рд╣рдо рдмрддрд╛рдПрдВрдЧреЗ рдХрд┐ рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ рдХрдИ рддрд░реАрдХреЛрдВ рдХреЛ рдХреИрд╕реЗ рдорд░реНрдЬ рдХрд░рддрд╛ рд╣реИ.

2. рдЖрд░рдПрдЬреА рд╕реЗрд╡рд╛ рд▓рд╛рдЧреВ рдХрд░рдирд╛

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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
        """

3. рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ рдЯреВрд▓ рдХреА рдкрд░рд┐рднрд╛рд╖рд╛

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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 рд╕реЗ рдорд┐рд▓рддреА-рдЬреБрд▓рддреА рдХреНрд╡реЗрд░реА рдвреВрдВрдвреЗрдВ")
  • рдХреЙрдиреНрд╕реЗрдкреНрдЯ рд╕реЗ рдЬреБрдбрд╝реА рдХреНрд╡реЗрд░реА ("рдареАрдХ рдХрд░рдиреЗ рдХреА рдХреНрд╖рдорддрд╛рдПрдВ")
  • рдЬрдм рдорддрд▓рдм рд╕рдордЭрдирд╛ рдЬрд╝рд░реВрд░реА рд╣реЛ

4. рдПрдЬреЗрдВрдЯ рдХреЗ рд▓рд┐рдП рдлрд╝реИрд╕рд▓рд╛ рд▓реЗрдиреЗ рдХреА рдЧрд╛рдЗрдб (рдирд┐рд░реНрджреЗрд╢)

рдПрдЬреЗрдВрдЯ рдХреА рдкрд░рд┐рднрд╛рд╖рд╛ рдореЗрдВ, рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ рд╕реЗ рдЬреБрдбрд╝реЗ рд╣рд┐рд╕реНрд╕реЗ рдХреЛ рдХреЙрдкреА рдХрд░рдХреЗ рдирд┐рд░реНрджреЗрд╢ рдореЗрдВ рдЪрд┐рдкрдХрд╛рдПрдВ.

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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

рдПрдЬреЗрдВрдЯ, рд╕рд╣реА рдЯреВрд▓ рдЪреБрдирдиреЗ рдХреЗ рд▓рд┐рдП рдЗрд╕ рдирд┐рд░реНрджреЗрд╢ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рддрд╛ рд╣реИ:

ЁЯСЙagent.py рдлрд╝рд╛рдЗрд▓ рдореЗрдВ, рдЯрд┐рдкреНрдкрдгреА # TODO: REPLACE_SEARCH_LOGIC рдвреВрдВрдвреЗрдВ. рдЗрд╕рдХреЗ рдмрд╛рдж, Replace this whole line рдХреЛ рдЗрд╕ рдХреЛрдб рд╕реЗ рдмрджрд▓реЗрдВ:

- `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_TOOLReplace this whole line рдЯрд┐рдкреНрдкрдгреА рдвреВрдВрдвреЗрдВ рдФрд░ рдЙрд╕рдХреА рдЬрдЧрд╣ рдпрд╣ рдХреЛрдб рдбрд╛рд▓реЗрдВ:

    semantic_search,         # Force RAG

5. рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ рдХреЗ рдХрд╛рдо рдХрд░рдиреЗ рдХрд╛ рддрд░реАрдХрд╛ рд╕рдордЭрдирд╛ (рд╕рд┐рд░реНрдлрд╝ рдкрдврд╝рдиреЗ рдХреЗ рд▓рд┐рдП, рдХреЛрдИ рдХрд╛рд░реНрд░рд╡рд╛рдИ рдХрд░рдиреЗ рдХреА рдЬрд╝рд░реВрд░рдд рдирд╣реАрдВ рд╣реИ)

рджреВрд╕рд░реЗ рд╕реЗ рдЪреМрдереЗ рдЪрд░рдг рдореЗрдВ, рдЖрдкрдиреЗ рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ (рдЖрд░рдПрдЬреА) рдХреЛ рд▓рд╛рдЧреВ рдХрд┐рдпрд╛. рдпрд╣ рдЦреЛрдЬ рдХрд░рдиреЗ рдХрд╛ рдореБрдЦреНрдп рддрд░реАрдХрд╛ рд╣реИ, рдЬреЛ рдорддрд▓рдм рдХреЗ рд╣рд┐рд╕рд╛рдм рд╕реЗ рдирддреАрдЬреЗ рджрд┐рдЦрд╛рддрд╛ рд╣реИ. рд╣рд╛рд▓рд╛рдВрдХрд┐, рдЖрдкрдиреЗ рджреЗрдЦрд╛ рд╣реЛрдЧрд╛ рдХрд┐ рдЗрд╕ рд╕рд┐рд╕реНрдЯрдо рдХреЛ "рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ" рдХрд╣рд╛ рдЬрд╛рддрд╛ рд╣реИ. рдпрд╣рд╛рдВ рдмрддрд╛рдпрд╛ рдЧрдпрд╛ рд╣реИ рдХрд┐ рдпреЗ рд╕рднреА рдПрдХ рд╕рд╛рде рдХреИрд╕реЗ рдХрд╛рдо рдХрд░рддреЗ рд╣реИрдВ:

рд╣рд╛рдЗрдмреНрд░рд┐рдб рдорд░реНрдЬ рдХреА рд╕реБрд╡рд┐рдзрд╛ рдХреИрд╕реЗ рдХрд╛рдо рдХрд░рддреА рд╣реИ:

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

рдЗрд╕ рдХреЛрдбрд▓реИрдм рдХреЗ рд▓рд┐рдП, рдЖрдкрдиреЗ рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ рдХреЙрдореНрдкреЛрдиреЗрдВрдЯ (рдЖрд░рдПрдЬреА) рдХреЛ рд▓рд╛рдЧреВ рдХрд┐рдпрд╛ рд╣реИ. рдпрд╣ рдХреЙрдореНрдкреЛрдиреЗрдВрдЯ, рдЗрд╕ рдХреЛрдбрд▓реИрдм рдХрд╛ рдЖрдзрд╛рд░ рд╣реИ. рд╕реЗрд╡рд╛ рдореЗрдВ рдХреАрд╡рд░реНрдб рдФрд░ рд╣рд╛рдЗрдмреНрд░рд┐рдб рддрд░реАрдХреЗ рдкрд╣рд▓реЗ рд╕реЗ рд╣реА рд▓рд╛рдЧреВ рд╣реИрдВ. рдЖрдкрдХрд╛ рдПрдЬреЗрдВрдЯ рддреАрдиреЛрдВ рддрд░реАрдХреЛрдВ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░ рд╕рдХрддрд╛ рд╣реИ!

рдмрдзрд╛рдИ рд╣реЛ! рдЖрдкрдиреЗ рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ рдХреА рд╕реБрд╡рд┐рдзрд╛ рдХреЗ рд╕рд╛рде, Graph RAG рдПрдЬреЗрдВрдЯ рдХреЛ рд╕реЗрдЯ рдЕрдк рдХрд░ рд▓рд┐рдпрд╛ рд╣реИ!

7. ЁЯЪА ADK Web рдХреА рдорджрдж рд╕реЗ рдЕрдкрдиреЗ рдПрдЬреЗрдВрдЯ рдХреА рдЬрд╛рдВрдЪ рдХрд░рдирд╛

рдЕрдкрдиреЗ рдПрдЬреЗрдВрдЯ рдХреЛ рдЯреЗрд╕реНрдЯ рдХрд░рдиреЗ рдХрд╛ рд╕рдмрд╕реЗ рдЖрд╕рд╛рди рддрд░реАрдХрд╛, adk web рдХрдорд╛рдВрдб рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдирд╛ рд╣реИ. рдЗрд╕рд╕реЗ рдЖрдкрдХрд╛ рдПрдЬреЗрдВрдЯ, рдкрд╣рд▓реЗ рд╕реЗ рдореМрдЬреВрдж рдЪреИрдЯ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдХреЗ рд╕рд╛рде рд▓реЙрдиреНрдЪ рд╣реЛ рдЬрд╛рддрд╛ рд╣реИ.

1. рдПрдЬреЗрдВрдЯ рдХреЛ рдЪрд▓рд╛рдирд╛

ЁЯСЙЁЯТ╗ рдмреИрдХрдПрдВрдб рдбрд╛рдпрд░реЗрдХреНрдЯреНрд░реА (рдЬрд╣рд╛рдВ рдЖрдкрдХрд╛ рдПрдЬреЗрдВрдЯ рддрдп рдХрд┐рдпрд╛ рдЧрдпрд╛ рд╣реИ) рдкрд░ рдЬрд╛рдПрдВ рдФрд░ рд╡реЗрдм рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рд▓реЙрдиреНрдЪ рдХрд░реЗрдВ::

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

рдЗрд╕ рдХрдорд╛рдВрдб рд╕реЗ, рдореЗрдВ рддрдп рдХрд┐рдпрд╛ рдЧрдпрд╛ рдПрдЬреЗрдВрдЯ рд╢реБрд░реВ рд╣реЛрддрд╛ рд╣реИ

agent/agent.py

рдФрд░ рдЯреЗрд╕реНрдЯрд┐рдВрдЧ рдХреЗ рд▓рд┐рдП рдПрдХ рд╡реЗрдм рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдЦреБрд▓рддрд╛ рд╣реИ.

ЁЯСЙ рдпрд╣ рдпреВрдЖрд░рдПрд▓ рдЦреЛрд▓реЗрдВ:

рдХрдорд╛рдВрдб рд╕реЗ рдПрдХ рд▓реЛрдХрд▓ рдпреВрдЖрд░рдПрд▓ (рдЖрдо рддреМрд░ рдкрд░ http://127.0.0.1:8000 рдпрд╛ рдЗрд╕рд╕реЗ рдорд┐рд▓рддрд╛-рдЬреБрд▓рддрд╛) рдЖрдЙрдЯрдкреБрдЯ рд╣реЛрдЧрд╛. рдЗрд╕реЗ рдЕрдкрдиреЗ рдмреНрд░рд╛рдЙрдЬрд╝рд░ рдореЗрдВ рдЦреЛрд▓реЗрдВ.

adk web

рдпреВрдЖрд░рдПрд▓ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░рдиреЗ рдХреЗ рдмрд╛рдж, рдЖрдкрдХреЛ ADK рд╡реЗрдм рдпреВрдЬрд╝рд░ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ (рдпреВрдЖрдИ) рджрд┐рдЦреЗрдЧрд╛. рдкрдХреНрдХрд╛ рдХрд░реЗрдВ рдХрд┐ рдЖрдкрдиреЗ рд╕рдмрд╕реЗ рдКрдкрд░ рдмрд╛рдПрдВ рдХреЛрдиреЗ рдореЗрдВ рдореМрдЬреВрдж "рдПрдЬреЗрдВрдЯ" рдХреЛ рдЪреБрдирд╛ рд╣реЛ.

adk_ui

2. рдЦреЛрдЬ рдХреА рд╕реБрд╡рд┐рдзрд╛рдУрдВ рдХреА рдЬрд╛рдВрдЪ рдХрд░рдирд╛

рдЗрд╕ рдПрдЬреЗрдВрдЯ рдХреЛ рдЖрдкрдХреА рдХреНрд╡реЗрд░реА рдХреЛ рд╕рдордЭрджрд╛рд░реА рд╕реЗ рд░реВрдЯ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП рдбрд┐рдЬрд╝рд╛рдЗрди рдХрд┐рдпрд╛ рдЧрдпрд╛ рд╣реИ. рдЦреЛрдЬ рдХреЗ рдЕрд▓рдЧ-рдЕрд▓рдЧ рддрд░реАрдХреЗ рджреЗрдЦрдиреЗ рдХреЗ рд▓рд┐рдП, рдЪреИрдЯ рд╡рд┐рдВрдбреЛ рдореЗрдВ рдпреЗ рдЗрдирдкреБрдЯ рдЖрдЬрд╝рдорд╛рдПрдВ.

рдпрд╣ рдорддрд▓рдм рдФрд░ рдХреЙрдиреНрд╕реЗрдкреНрдЯ рдХреЗ рдЖрдзрд╛рд░ рдкрд░ рдЖрдЗрдЯрдо рдвреВрдВрдврддрд╛ рд╣реИ, рднрд▓реЗ рд╣реА рдХреАрд╡рд░реНрдб рдореИрдЪ рди рд╣реЛрдВ.

рдЯреЗрд╕реНрдЯ рдХреНрд╡реЗрд░реА: (рдЗрдирдореЗрдВ рд╕реЗ рдХреЛрдИ рднреА рд╡рд┐рдХрд▓реНрдк рдЪреБрдиреЗрдВ)

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

рдЖрдкрдХреЛ рдХреНрдпрд╛ рджреЗрдЦрдирд╛ рдЪрд╛рд╣рд┐рдП:

  • рд╡рдЬрд╣ рдореЗрдВ рд╕рд┐рдореИрдВрдЯрд┐рдХ рдпрд╛ рдЖрд░рдПрдЬреА рд╕рд░реНрдЪ рдХрд╛ рдЬрд╝рд┐рдХреНрд░ рд╣реЛрдирд╛ рдЪрд╛рд╣рд┐рдП.
  • рдЖрдкрдХреЛ рдРрд╕реЗ рдирддреАрдЬреЗ рджрд┐рдЦреЗрдВрдЧреЗ рдЬреЛ рдХреЙрдиреНрд╕реЗрдкреНрдЯ рдХреЗ рд╣рд┐рд╕рд╛рдм рд╕реЗ рдорд┐рд▓рддреЗ-рдЬреБрд▓рддреЗ рд╣реЛрдВ. рдЙрджрд╛рд╣рд░рдг рдХреЗ рд▓рд┐рдП, "рдлрд╝рд░реНрд╕реНрдЯ рдПрдб" рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдкреВрдЫрдиреЗ рдкрд░ "рд╕рд░реНрдЬрд░реА" рд╕реЗ рдЬреБрдбрд╝реЗ рдирддреАрдЬреЗ рджрд┐рдЦрдирд╛.
  • рдирддреАрдЬреЛрдВ рдореЗрдВ ЁЯзм рдЖрдЗрдХреЙрди рджрд┐рдЦреЗрдЧрд╛.

рдЬрдЯрд┐рд▓ рдХреНрд╡реЗрд░реА рдХреЗ рд▓рд┐рдП, рдХреАрд╡рд░реНрдб рдлрд╝рд┐рд▓реНрдЯрд░ рдХреЛ рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рдордЭ рдХреЗ рд╕рд╛рде рдЬреЛрдбрд╝рддрд╛ рд╣реИ.

рдЯреЗрд╕реНрдЯ рдХреНрд╡реЗрд░реА:(рдЗрдирдореЗрдВ рд╕реЗ рдХреЛрдИ рднреА рд╡рд┐рдХрд▓реНрдк рдЪреБрдиреЗрдВ)

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 рджрдмрд╛рдХрд░ рдкреНрд░реЛрд╕реЗрд╕ рдХреЛ рдЦрддреНрдо рдХрд░реЗрдВ.

8. ЁЯЪА рдкреВрд░рд╛ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЪрд▓рд╛рдирд╛

рдлрд╝реБрд▓ рд╕реНрдЯреИрдХ рдЖрд░реНрдХрд┐рдЯреЗрдХреНрдЪрд░ рдХреА рдЦрд╛рд╕ рдЬрд╛рдирдХрд╛рд░реА

architecture_fullstack

SessionService рдФрд░ Runner рдЬреЛрдбрд╝рдирд╛

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ 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"
)

1. рдЖрд╡реЗрджрди рдХрд░реЗрдВ

рдЕрдЧрд░ рдкрд┐рдЫрд▓рд╛ рдЯрд░реНрдорд┐рдирд▓ рдЕрдм рднреА рдЪрд▓ рд░рд╣рд╛ рд╣реИ, рддреЛ рдЙрд╕реЗ рдмрдВрдж рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП Ctrl+C рджрдмрд╛рдПрдВ.

ЁЯСЙЁЯТ╗ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЦреЛрд▓реЗрдВ:

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

рдмреИрдХрдПрдВрдб рдХреЗ рд╢реБрд░реВ рд╣реЛрдиреЗ рдкрд░, рдЖрдкрдХреЛ рдпрд╣рд╛рдВ рджрд┐рдП рдЧрдП рддрд░реАрдХреЗ рд╕реЗ Local: http://localhost:5173/" рджрд┐рдЦреЗрдЧрд╛: рдлрд╝реНрд░рдВрдЯрдПрдВрдб

ЁЯСЙ рдЯрд░реНрдорд┐рдирд▓ рд╕реЗ Local: http://localhost:5173/ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ.

рдмрд╛рддрдЪреАрдд

рдХреНрд╡реЗрд░реА:

Find skills similar to healing

рдЪреИрдЯ

рдЗрд╕рдореЗрдВ рдХреНрдпрд╛ рд╣реЛрддрд╛ рд╣реИ:

  • рдПрдЬреЗрдВрдЯ, рдорд┐рд▓рддреА-рдЬреБрд▓рддреА рдЖрд╡рд╛рдЬрд╝реЛрдВ рдХреА рдкрд╣рдЪрд╛рди рдХрд░рдиреЗ рдХреЗ рдЕрдиреБрд░реЛрдз рдХреЛ рд╕рдордЭрддрд╛ рд╣реИ
  • "healing" рдХреЗ рд▓рд┐рдП рдПрдВрдмреЗрдбрд┐рдВрдЧ рдЬрдирд░реЗрдЯ рдХрд░рддрд╛ рд╣реИ
  • рдпрд╣ рдХреЛрд╕рд╛рдЗрди рдбрд┐рд╕реНрдЯреЗрдВрд╕ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдХреЗ, рд╕рд┐рдореИрдВрдЯрд┐рдХ рддреМрд░ рдкрд░ рдорд┐рд▓рддреЗ-рдЬреБрд▓рддреЗ рдХреМрд╢рд▓ рдвреВрдВрдврддрд╛ рд╣реИ
  • рдирддреАрдЬреЗ: рдкреНрд░рд╛рдердорд┐рдХ рдЪрд┐рдХрд┐рддреНрд╕рд╛ (рднрд▓реЗ рд╣реА, рдирд╛рдо "healing" рд╕реЗ рдореЗрд▓ рди рдЦрд╛рддреЗ рд╣реЛрдВ)

рдХреНрд╡реЗрд░реА:

Find medical skills in the mountains

рдЗрд╕рдореЗрдВ рдХреНрдпрд╛ рд╣реЛрддрд╛ рд╣реИ:

  1. рдХреАрд╡рд░реНрдб рдХреЙрдореНрдкреЛрдиреЗрдВрдЯ: category='medical' рдХреЗ рд▓рд┐рдП рдлрд╝рд┐рд▓реНрдЯрд░
  2. рд╕рд┐рдореИрдВрдЯрд┐рдХ рдХреЙрдореНрдкреЛрдиреЗрдВрдЯ: "рдореЗрдбрд┐рдХрд▓" рдХреЛ рдПрдореНрдмреЗрдб рдХрд░реЗрдВ рдФрд░ рд╕рдорд╛рдирддрд╛ рдХреЗ рд╣рд┐рд╕рд╛рдм рд╕реЗ рд░реИрдВрдХ рдХрд░реЗрдВ
  3. рдорд░реНрдЬ рдХрд░рдирд╛: рдирддреАрдЬреЛрдВ рдХреЛ рдорд░реНрдЬ рдХрд░рдирд╛. рдЗрд╕рдореЗрдВ рджреЛрдиреЛрдВ рддрд░реАрдХреЛрдВ рд╕реЗ рдорд┐рд▓реЗ рдирддреАрдЬреЛрдВ рдХреЛ рдкреНрд░рд╛рдердорд┐рдХрддрд╛ рджреА рдЬрд╛рддреА рд╣реИ ЁЯФА

Query(optional):

Who is good at survival and in the forest?

рдЗрд╕рдореЗрдВ рдХреНрдпрд╛ рд╣реЛрддрд╛ рд╣реИ:

  • рдХреАрд╡рд░реНрдб рд╕реЗ рдорд┐рд▓реЗ рдирддреАрдЬреЗ: biome='forest'
  • рд╕рд┐рдореИрдВрдЯрд┐рдХ рдЦреЛрдЬ: "рд╕рд░реНрд╡рд╛рдЗрд╡рд▓" рд╕реЗ рдорд┐рд▓рддреА-рдЬреБрд▓рддреА рд╕реНрдХрд┐рд▓
  • рд╣рд╛рдЗрдмреНрд░рд┐рдб рдореЗрдВ рджреЛрдиреЛрдВ рдХреЛ рдорд┐рд▓рд╛рдХрд░, рдмреЗрд╣рддрд░ рдирддреАрдЬреЗ рдкрд╛рдП рдЬрд╛ рд╕рдХрддреЗ рд╣реИрдВ

ЁЯСЙЁЯТ╗ рдЯреЗрд╕реНрдЯрд┐рдВрдЧ рдкреВрд░реА рд╣реЛрдиреЗ рдХреЗ рдмрд╛рдж, рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ Ctrl+C рджрдмрд╛рдХрд░ рдЗрд╕реЗ рдмрдВрдж рдХрд░реЗрдВ.

4. (!ONLY FOR WORKSHOP ATTENDEE) Update your location

ЁЯСЙЁЯТ╗ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдкреВрд░реА рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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

рдЕрдм waybackhome.dev рдЦреЛрд▓реЗрдВ. рдЖрдкрдХреЛ рджрд┐рдЦреЗрдЧрд╛ рдХрд┐ рдЖрдкрдХреА рдЬрдЧрд╣ рдХреА рдЬрд╛рдирдХрд╛рд░реА рдЕрдкрдбреЗрдЯ рд╣реЛ рдЧрдИ рд╣реИ. рд▓реЗрд╡рд▓ 2 рдкреВрд░рд╛ рдХрд░рдиреЗ рдкрд░ рдмрдзрд╛рдИ!

рдЖрдЦрд┐рд░реА рдирддреАрдЬрд╛

9. тШХя╕П [рдЬрд╝рд░реВрд░реА рдирд╣реАрдВ] рдорд▓реНрдЯреАрдореЛрдбрд▓ рдкрд╛рдЗрдкрд▓рд╛рдЗрди (рд░реАрдб рдУрдирд▓реА) тАФ рдЯреВрд▓рд┐рдВрдЧ рд▓реЗрдпрд░

рд╣рдореЗрдВ рдорд▓реНрдЯреАрдореЙрдбрд▓ рдкрд╛рдЗрдкрд▓рд╛рдЗрди рдХреА рдЬрд╝рд░реВрд░рдд рдХреНрдпреЛрдВ рд╣реИ?

рд╕рд░реНрд╡рд╛рдЗрд╡рд▓ рдиреЗрдЯрд╡рд░реНрдХ рдореЗрдВ рд╕рд┐рд░реНрдлрд╝ рдЯреЗрдХреНрд╕реНрдЯ рдирд╣реАрдВ рд╣реЛрддрд╛. рдЖрдкрджрд╛ рд╕реЗ рдкреНрд░рднрд╛рд╡рд┐рдд рд▓реЛрдЧ, рдЪреИрдЯ рдХреЗ рдЬрд╝рд░рд┐рдП рд╕реАрдзреЗ рдЕрдирд╕реНрдЯреНрд░рдХреНрдЪрд░реНрдб рдбреЗрдЯрд╛ рднреЗрдЬрддреЗ рд╣реИрдВ:

  • ЁЯУ╕ рдЗрдореЗрдЬ: рд╕рдВрд╕рд╛рдзрдиреЛрдВ, рдЦрддрд░реЛрдВ рдпрд╛ рдЙрдкрдХрд░рдгреЛрдВ рдХреА рдлрд╝реЛрдЯреЛ
  • рд╡реАрдбрд┐рдпреЛ: рд╕реНрдЯреЗрдЯрд╕ рд░рд┐рдкреЛрд░реНрдЯ рдпрд╛ рдПрд╕рдУрдПрд╕ рдмреНрд░реЙрдбрдХрд╛рд╕реНрдЯ
  • ЁЯУД рдЯреЗрдХреНрд╕реНрдЯ: рдлрд╝реАрд▓реНрдб рдиреЛрдЯ рдпрд╛ рд▓реЙрдЧ

рд╣рдо рдХреМрдирд╕реА рдлрд╝рд╛рдЗрд▓реЗрдВ рдкреНрд░реЛрд╕реЗрд╕ рдХрд░ рд░рд╣реЗ рд╣реИрдВ?

рдкрд┐рдЫрд▓реЗ рдЪрд░рдг рдореЗрдВ, рд╣рдордиреЗ рдореМрдЬреВрджрд╛ рдбреЗрдЯрд╛ рдХреЛ рдЦреЛрдЬрд╛ рдерд╛. рд╣рд╛рд▓рд╛рдВрдХрд┐, рдЗрд╕ рдЪрд░рдг рдореЗрдВ рд╣рдо рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреА рдЕрдкрд▓реЛрдб рдХреА рдЧрдИ рдлрд╝рд╛рдЗрд▓реЛрдВ рдХреЛ рдкреНрд░реЛрд╕реЗрд╕ рдХрд░рддреЗ рд╣реИрдВ. chat.py рдХрд╛ рдЗрдВрдЯрд░рдлрд╝реЗрд╕, рдЕрдЯреИрдЪ рдХреА рдЧрдИ рдлрд╝рд╛рдЗрд▓реЛрдВ рдХреЛ рдбрд╛рдЗрдиреИрдорд┐рдХ рддрд░реАрдХреЗ рд╕реЗ рдореИрдиреЗрдЬ рдХрд░рддрд╛ рд╣реИ:

рд╕реНрд░реЛрдд

рд╕рд╛рдордЧреНрд░реА

рд▓рдХреНрд╖реНрдп

рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХрд╛ рдЕрдЯреИрдЪрдореЗрдВрдЯ

рдЗрдореЗрдЬ/рд╡реАрдбрд┐рдпреЛ/рдЯреЗрдХреНрд╕реНрдЯ

рдЧреНрд░рд╛рдлрд╝ рдореЗрдВ рдЬреЛрдбрд╝рдиреЗ рдХреЗ рд▓рд┐рдП рдЬрд╛рдирдХрд╛рд░реА

рдЪреИрдЯ рдХрд╛ рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ

"рдпрд╣ рд░рд╣реА рдЬрд╝рд░реВрд░реА рд╕рд╛рдорд╛рди рдХреА рдлрд╝реЛрдЯреЛ"

рдордХрд╕рдж рдФрд░ рдЕрдиреНрдп рдЬрд╛рдирдХрд╛рд░реА

рдкреНрд▓рд╛рди рдХрд┐рдпрд╛ рдЧрдпрд╛ рддрд░реАрдХрд╛: рдХреНрд░рдо рдореЗрдВ рдЪрд▓рдиреЗ рд╡рд╛рд▓реА рдПрдЬреЗрдВрдЯ рдкрд╛рдЗрдкрд▓рд╛рдЗрди

рд╣рдо рд╕реАрдХреНрд╡реЗрдВрд╢рд┐рдпрд▓ рдПрдЬреЗрдВрдЯ (multimedia_agent.py) рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рддреЗ рд╣реИрдВ. рдпрд╣ рдЦрд╛рд╕ рдПрдЬреЗрдВрдЯ рдХреЛ рдПрдХ рд╕рд╛рде рдЬреЛрдбрд╝рддрд╛ рд╣реИ:

architecture_uploading

рдЗрд╕реЗ backend/agent/multimedia_agent.py рдореЗрдВ SequentialAgent рдХреЗ рддреМрд░ рдкрд░ рддрдп рдХрд┐рдпрд╛ рдЧрдпрд╛ рд╣реИ.

рдЯреВрд▓рд┐рдВрдЧ рд▓реЗрдпрд░, рдРрд╕реА рд╕реБрд╡рд┐рдзрд╛рдПрдВ рдЙрдкрд▓рдмреНрдз рдХрд░рд╛рддреА рд╣реИ рдЬрд┐рдиреНрд╣реЗрдВ рдПрдЬреЗрдВрдЯ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ. рдЯреВрд▓, "рдХреИрд╕реЗ" рд╡рд╛рд▓реЗ рд╣рд┐рд╕реНрд╕реЗ рдХреЛ рд╣реИрдВрдбрд▓ рдХрд░рддреЗ рд╣реИрдВ. рдЬреИрд╕реЗ, рдлрд╝рд╛рдЗрд▓реЗрдВ рдЕрдкрд▓реЛрдб рдХрд░рдирд╛, рдЗрдХрд╛рдЗрдпрд╛рдВ рдирд┐рдХрд╛рд▓рдирд╛, рдФрд░ рдбреЗрдЯрд╛рдмреЗрд╕ рдореЗрдВ рд╕реЗрд╡ рдХрд░рдирд╛.

1. рдЯреВрд▓ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓реЗрдВ

ЁЯСЙЁЯТ╗ level_2/backend/agent/tools/extraction_tools.py рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓реЗрдВ рдпрд╛ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ рдпрд╣ рдХрдорд╛рдВрдб рдЯрд╛рдЗрдк рдХрд░реЗрдВ. рдирдпрд╛ рдЯрд░реНрдорд┐рдирд▓ рдЦреЛрд▓реЗрдВ. рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓реЗрдВ:

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

2. 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)}

3. 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)}

рд▓рд╛рдЧреВ рдХрд░рдиреЗ рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдЕрд╣рдо рдЬрд╛рдирдХрд╛рд░реА:

  • рдорд▓реНрдЯреАрдореЛрдбрд▓ рдЗрдирдкреБрдЯ: рд╣рдо рдЯреЗрдХреНрд╕реНрдЯ рдкреНрд░реЙрдореНрдкреНрдЯ (_get_extraction_prompt()) рдФрд░ рдЗрдореЗрдЬ рдСрдмреНрдЬреЗрдХреНрдЯ, рджреЛрдиреЛрдВ рдХреЛ generate_content рдореЗрдВ рдкрд╛рд╕ рдХрд░рддреЗ рд╣реИрдВ.
  • рд╕реНрдЯреНрд░рдХреНрдЪрд░реНрдб рдЖрдЙрдЯрдкреБрдЯ: response_mime_type="application/json" рдпрд╣ рдкрдХреНрдХрд╛ рдХрд░рддрд╛ рд╣реИ рдХрд┐ рдПрд▓рдПрд▓рдПрдо, рдорд╛рдиреНрдп JSON рдлрд╝реЙрд░реНрдореИрдЯ рдореЗрдВ рдЖрдЙрдЯрдкреБрдЯ рджреЗ. рдпрд╣ рдкрд╛рдЗрдкрд▓рд╛рдЗрди рдХреЗ рд▓рд┐рдП рдЬрд╝рд░реВрд░реА рд╣реИ.
  • рд╡рд┐рдЬрд╝реБрдЕрд▓ рдЗрдХрд╛рдИ рдХреЛ рд▓рд┐рдВрдХ рдХрд░рдирд╛: рдкреНрд░реЙрдореНрдкреНрдЯ рдореЗрдВ рдЬрд╛рдиреА-рдкрд╣рдЪрд╛рдиреА рдЗрдХрд╛рдЗрдпрд╛рдБ рд╢рд╛рдорд┐рд▓ рд╣реЛрдВ, рддрд╛рдХрд┐ Gemini рдЦрд╝рд╛рд╕ рдХрд┐рд░рджрд╛рд░реЛрдВ рдХреЛ рдкрд╣рдЪрд╛рди рд╕рдХреЗ.

4. 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)}

рдПрдЬреЗрдВрдЯ рдХреЛ рдмреЗрд╣рддрд░ рдЯреВрд▓ рджреЗрдХрд░, рд╣рдо рдбреЗрдЯрд╛ рдХреА рд╕реБрд░рдХреНрд╖рд╛ рдкрдХреНрдХрд╛ рдХрд░рддреЗ рд╣реИрдВ. рд╕рд╛рде рд╣реА, рдПрдЬреЗрдВрдЯ рдХреА рддрд░реНрдХ рдХрд░рдиреЗ рдХреА рдХреНрд╖рдорддрд╛рдУрдВ рдХрд╛ рдлрд╝рд╛рдпрджрд╛ рд▓реЗрддреЗ рд╣реИрдВ.

5. 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 рдмрдХреЗрдЯ, рдмреНрд▓реЙрдм рдХреЗ рдирд╛рдо рдпрд╛ рд╕рд╛рдЗрди рдХрд┐рдП рдЧрдП рдпреВрдЖрд░рдПрд▓ рдЬрдирд░реЗрд╢рди рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдЬрд╛рдирдиреЗ рдХреА рдЬрд╝рд░реВрд░рдд рдирд╣реАрдВ рдкрдбрд╝рддреА. рдпрд╣ рд╕рд┐рд░реНрдлрд╝ "рдЕрдкрд▓реЛрдб рдХрд░реЗрдВ" рдХреЗ рд▓рд┐рдП рдХрд╣рддрд╛ рд╣реИ.

6. рдПрдЬреЗрдВрдЯрд┐рдХ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ, рдкрд╛рд░рдВрдкрд░рд┐рдХ рддрд░реАрдХреЛрдВ рд╕реЗ рдмреЗрд╣рддрд░ рдХреНрдпреЛрдВ рд╣реИ?

рдПрдЬреЗрдВрдЯрд┐рдХ рдПрдЖрдИ рдХреЗ рдлрд╝рд╛рдпрджреЗ:

рд╕реБрд╡рд┐рдзрд╛

рдмреИрдЪ рдкрд╛рдЗрдкрд▓рд╛рдЗрди

рдЗрд╡реЗрдВрдЯ-рдбреНрд░рд┐рд╡рди

рдПрдЬреЗрдВрдЯрд┐рдХ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ

рдЬрдЯрд┐рд▓рддрд╛

рдХрдо (1 рд╕реНрдХреНрд░рд┐рдкреНрдЯ)

рдЬрд╝реНрдпрд╛рджрд╛ (рдкрд╛рдВрдЪ рд╕реЗ рдЬрд╝реНрдпрд╛рджрд╛ рд╕реЗрд╡рд╛рдПрдВ)

рдХрдо (рдПрдХ Python рдлрд╝рд╛рдЗрд▓: multimedia_agent.py)

рд╕реНрдЯреЗрдЯ рдореИрдиреЗрдЬрдореЗрдВрдЯ

рдЧреНрд▓реЛрдмрд▓ рд╡реИрд░рд┐рдПрдмрд▓

рд╣рд╛рд░реНрдб (рдбрд┐рдХрдкрд▓реНрдб)

рдпреВрдирд┐рдлрд╝рд╛рдЗрдб (рдПрдЬреЗрдВрдЯ рдХреА рд╕реНрдерд┐рддрд┐)

рдЧрдбрд╝рдмрдбрд╝реА рдареАрдХ рдХрд░рдирд╛

рдХреНрд░реИрд╢

рд╕рд╛рдЗрд▓реЗрдВрдЯ рд▓реЙрдЧ

рдЗрдВрдЯрд░реИрдХреНрдЯрд┐рд╡ ("рдореИрдВ рдЙрд╕ рдлрд╝рд╛рдЗрд▓ рдХреЛ рдирд╣реАрдВ рдкрдврд╝ рд╕рдХрд╛")

рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЗ рд╕реБрдЭрд╛рд╡, рд░рд╛рдп рдпрд╛ рд╢рд┐рдХрд╛рдпрдд

рдХрдВрд╕реЛрд▓ рдкреНрд░рд┐рдВрдЯ

рдкреЛрд▓рд┐рдВрдЧ рдХреА рдЬрд╝рд░реВрд░рдд рд╣реИ

Immediate (рдЪреИрдЯ рдХрд╛ рд╣рд┐рд╕реНрд╕рд╛)

рдЕрдбреИрдкреНрдЯреЗрдмрд┐рд▓рд┐рдЯреА

рддрдп рдХрд┐рдпрд╛ рдЧрдпрд╛ рд▓реЙрдЬрд┐рдХ

рд░рд┐рдЬрд┐рдб рдлрд╝рдВрдХреНрд╢рди

рдЗрдВрдЯреЗрд▓рд┐рдЬреЗрдВрдЯ (рдПрд▓рдПрд▓рдПрдо рдЕрдЧрд▓рд╛ рдЪрд░рдг рддрдп рдХрд░рддрд╛ рд╣реИ)

рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ рдЕрд╡реЗрдпрд░рдиреЗрд╕

рдХреЛрдИ рдирд╣реАрдВ

рдХреЛрдИ рдирд╣реАрдВ

рдкреВрд░реА рдЬрд╛рдирдХрд╛рд░реА (рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЗ рдордХрд╕рдж рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдЬрд╛рдирдХрд╛рд░реА рд╣реИ)

рдпрд╣ рдХреНрдпреЛрдВ рдЬрд╝рд░реВрд░реА рд╣реИ: multimedia_agent.py (рдЪрд╛рд░ рд╕рдм-рдПрдЬреЗрдВрдЯ рд╡рд╛рд▓рд╛ рдПрдХ SequentialAgent: рдЕрдкрд▓реЛрдб тЖТ рдПрдХреНрд╕рдЯреНрд░реИрдХреНрдЯ тЖТ рд╕реЗрд╡ тЖТ рдЦрд╛рд╕ рдЬрд╛рдирдХрд╛рд░реА) рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдХреЗ, рд╣рдо рдЬрдЯрд┐рд▓ рдЗрдиреНрдлрд╝реНрд░рд╛рд╕реНрдЯреНрд░рдХреНрдЪрд░ рдФрд░ рдХрдордЬрд╝реЛрд░ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдХреЛ рдЗрдВрдЯреЗрд▓рд┐рдЬреЗрдВрдЯ, рдмрд╛рддрдЪреАрдд рд╡рд╛рд▓реЗ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рд▓реЙрдЬрд┐рдХ рд╕реЗ рдмрджрд▓ рджреЗрддреЗ рд╣реИрдВ.

10. тШХя╕П [Optional] Multimodal Pipeline (Read Only) тАФ Agent Layer

рдПрдЬреЗрдВрдЯ рд▓реЗрдпрд░, рдЗрдВрдЯреЗрд▓рд┐рдЬреЗрдВрд╕ рдХреЛ рддрдп рдХрд░рддреА рд╣реИ. рдЗрд╕рдореЗрдВ рдРрд╕реЗ рдПрдЬреЗрдВрдЯ рд╢рд╛рдорд┐рд▓ рд╣реЛрддреЗ рд╣реИрдВ рдЬреЛ рдЯрд╛рд╕реНрдХ рдкреВрд░реЗ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП рдЯреВрд▓ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рддреЗ рд╣реИрдВ. рд╣рд░ рдПрдЬреЗрдВрдЯ рдХреА рдПрдХ рдЦрд╛рд╕ рднреВрдорд┐рдХрд╛ рд╣реЛрддреА рд╣реИ рдФрд░ рд╡рд╣ рдЕрдЧрд▓реЗ рдПрдЬреЗрдВрдЯ рдХреЛ рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ рдкрд╛рд╕ рдХрд░рддрд╛ рд╣реИ. рдпрд╣рд╛рдВ рдорд▓реНрдЯреАрдПрдЬреЗрдВрдЯ рд╕рд┐рд╕реНрдЯрдо рдХрд╛ рдЖрд░реНрдХрд┐рдЯреЗрдХреНрдЪрд░ рдбрд╛рдпрдЧреНрд░рд╛рдо рджрд┐рдпрд╛ рдЧрдпрд╛ рд╣реИ.

agent_diagram

1. рдПрдЬреЗрдВрдЯ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓реЗрдВ

ЁЯСЙЁЯТ╗ level_2/backend/agent/multimedia_agent.py рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓реЗрдВ рдпрд╛ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ рдпрд╣ рдХрдорд╛рдВрдб рдЯрд╛рдЗрдк рдХрд░реЗрдВ. рдирдпрд╛ рдЯрд░реНрдорд┐рдирд▓ рдЦреЛрд▓реЗрдВ. рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓реЗрдВ:

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

2. рдЕрдкрд▓реЛрдб рдПрдЬреЗрдВрдЯ рддрдп рдХрд░рдирд╛

рдпрд╣ рдПрдЬреЗрдВрдЯ, рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЗ рдореИрд╕реЗрдЬ рд╕реЗ рдлрд╝рд╛рдЗрд▓ рдкрд╛рде рдХреЛ рдПрдХреНрд╕рдЯреНрд░реИрдХреНрдЯ рдХрд░рддрд╛ рд╣реИ рдФрд░ рдЙрд╕реЗ 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"
)

3. рдПрдХреНрд╕рдЯреНрд░реИрдХреНрд╢рди рдПрдЬреЗрдВрдЯ рддрдп рдХрд░рдирд╛

рдпрд╣ рдПрдЬреЗрдВрдЯ, рдЕрдкрд▓реЛрдб рдХрд┐рдП рдЧрдП рдореАрдбрд┐рдпрд╛ рдХреЛ "рджреЗрдЦрддрд╛" рд╣реИ рдФрд░ 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 рдореЗрдВ рдПрдЬреЗрдВрдЯ рдХреЗ рдмреАрдЪ рд╕реНрдЯреЗрдЯ рдХреЛ рдЗрд╕реА рддрд░рд╣ рдкрд╛рд╕ рдХрд┐рдпрд╛ рдЬрд╛рддрд╛ рд╣реИ.

4. 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) рд╕реЗ рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ рдорд┐рд▓рддрд╛ рд╣реИ.

5. Summary Agent рдХреЛ рддрдп рдХрд░рдирд╛

рдпрд╣ рдПрдЬреЗрдВрдЯ, рдкрд┐рдЫрд▓реЗ рд╕рднреА рдЪрд░рдгреЛрдВ рд╕реЗ рдорд┐рд▓реЗ рдирддреАрдЬреЛрдВ рдХреЛ рдЗрдХрдЯреНрдард╛ рдХрд░рдХреЗ, рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЗ рд▓рд┐рдП рдЖрд╕рд╛рди рдЬрд╡рд╛рдм рддреИрдпрд╛рд░ рдХрд░рддрд╛ рд╣реИ.

ЁЯСЙ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

рдХреНрдпрд╛ тАФ рдкрд╛рдЗрдкрд▓рд╛рдЗрди рдХреЛ рд╡реНрдпрд╡рд╕реНрдерд┐рдд рдХрд░рдирд╛

11. ЁЯЪА рдорд▓реНрдЯреАрдореЛрдбрд▓ рдбреЗрдЯрд╛ рдкрд╛рдЗрдкрд▓рд╛рдЗрди тАФ рдСрд░реНрдХреЗрд╕реНрдЯреНрд░реЗрд╢рди

рд╣рдорд╛рд░реЗ рдирдП рд╕рд┐рд╕реНрдЯрдо рдХрд╛ рдореБрдЦреНрдп рд╣рд┐рд╕реНрд╕рд╛ MultimediaExtractionPipeline рд╣реИ, рдЬрд┐рд╕рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ backend/agent/multimedia_agent.py рдореЗрдВ рдмрддрд╛рдпрд╛ рдЧрдпрд╛ рд╣реИ. рдпрд╣ ADK (рдПрдЬреЗрдВрдЯ рдбреЗрд╡рд▓рдкрдореЗрдВрдЯ рдХрд┐рдЯ) рдХреЗ рд╕реАрдХреНрд╡реЗрдВрд╢рд┐рдпрд▓ рдПрдЬреЗрдВрдЯ рдкреИрдЯрд░реНрди рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рддрд╛ рд╣реИ.

1. рдХреНрд░рдо рдореЗрдВ рдЪрд▓рдиреЗ рд╡рд╛рд▓реЗ рд╡рд┐рдЬреНрдЮрд╛рдкрди рдХреНрдпреЛрдВ?

рдЕрдкрд▓реЛрдб рдХреЛ рдкреНрд░реЛрд╕реЗрд╕ рдХрд░рдиреЗ рдХреА рдкреНрд░реЛрд╕реЗрд╕, рдПрдХ рд▓реАрдирд┐рдпрд░ рдбрд┐рдкреЗрдВрдбреЗрдВрд╕реА рдЪреЗрди рд╣реИ:

  1. рдЬрдм рддрдХ рдЖрдкрдХреЗ рдкрд╛рд╕ рдлрд╝рд╛рдЗрд▓ (рдЕрдкрд▓реЛрдб) рдирд╣реАрдВ рд╣реЛрдЧреА, рддрдм рддрдХ рдбреЗрдЯрд╛ рдХреЛ рдПрдХреНрд╕рдЯреНрд░реИрдХреНрдЯ рдирд╣реАрдВ рдХрд┐рдпрд╛ рдЬрд╛ рд╕рдХрддрд╛.
  2. рдбреЗрдЯрд╛ рдХреЛ рдПрдХреНрд╕рдЯреНрд░реИрдХреНрдЯ рдХрд┐рдП рдмрд┐рдирд╛ рд╕реЗрд╡ рдирд╣реАрдВ рдХрд┐рдпрд╛ рдЬрд╛ рд╕рдХрддрд╛.
  3. рдирддреАрдЬреЗ рдорд┐рд▓рдиреЗ рддрдХ, рдЦрд╛рд╕ рдЬрд╛рдирдХрд╛рд░реА рдирд╣реАрдВ рджреА рдЬрд╛ рд╕рдХрддреА (рд╕реЗрд╡ рдХрд░реЗрдВ).

рдЗрд╕рдХреЗ рд▓рд┐рдП, SequentialAgent рд╕рдмрд╕реЗ рд╕рд╣реА рд╣реИ. рдпрд╣ рдПрдХ рдПрдЬреЗрдВрдЯ рдХреЗ рдЖрдЙрдЯрдкреБрдЯ рдХреЛ рдЕрдЧрд▓реЗ рдПрдЬреЗрдВрдЯ рдХреЗ рд▓рд┐рдП рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ/рдЗрдирдкреБрдЯ рдХреЗ рддреМрд░ рдкрд░ рдкрд╛рд╕ рдХрд░рддрд╛ рд╣реИ.

2. рдПрдЬреЗрдВрдЯ рдХреА рдкрд░рд┐рднрд╛рд╖рд╛

рдЖрдЗрдП, 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]

3. рд░реВрдЯ рдПрдЬреЗрдВрдЯ рд╕реЗ рдХрдиреЗрдХреНрдЯ рдХрд░реЗрдВ

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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

рдЯрд┐рдкреНрдкрдгреА # TODO: REPLACE_ADD_SUBAGENT рдвреВрдВрдвреЗрдВ. рдЗрд╕ рдкреВрд░реА рд▓рд╛рдЗрди рдХреЛ рдЗрд╕ рдХреЛрдб рд╕реЗ рдмрджрд▓реЗрдВ:

    sub_agents=[multimedia_agent],

рдпрд╣ рд╕рд┐рдВрдЧрд▓ рдСрдмреНрдЬреЗрдХреНрдЯ, рдЪрд╛рд░ "рд╡рд┐рд╢реЗрд╖рдЬреНрдЮреЛрдВ" рдХреЛ рдПрдХ рдХреЙрд▓ рдХрд┐рдП рдЬрд╛ рд╕рдХрдиреЗ рд╡рд╛рд▓реЗ рдСрдмреНрдЬреЗрдХреНрдЯ рдореЗрдВ рдмрдВрдбрд▓ рдХрд░рддрд╛ рд╣реИ.

4. рдПрдЬреЗрдВрдЯ рдХреЗ рдмреАрдЪ рдбреЗрдЯрд╛ рдлрд╝реНрд▓реЛ

рд╣рд░ рдПрдЬреЗрдВрдЯ рдЕрдкрдирд╛ рдЖрдЙрдЯрдкреБрдЯ, рд╢реЗрдпрд░ рдХрд┐рдП рдЧрдП рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ рдореЗрдВ рд╕реЗрд╡ рдХрд░рддрд╛ рд╣реИ. рдЗрд╕реЗ рдмрд╛рдж рдХреЗ рдПрдЬреЗрдВрдЯ рдРрдХреНрд╕реЗрд╕ рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ:

architecture_uploading

5. рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЦреЛрд▓реЗрдВ (рдЕрдЧрд░ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЕрдм рднреА рдЪрд▓ рд░рд╣рд╛ рд╣реИ, рддреЛ рдЗрд╕реЗ рдЫреЛрдбрд╝реЗрдВ)

ЁЯСЙЁЯТ╗ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЦреЛрд▓реЗрдВ:

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

ЁЯСЙ рдЯрд░реНрдорд┐рдирд▓ рд╕реЗ Local: http://localhost:5173/ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ.

6. рдЯреЗрд╕реНрдЯ рдЗрдореЗрдЬ рдЕрдкрд▓реЛрдб рдХрд░рдирд╛

ЁЯСЙ рдЪреИрдЯ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдореЗрдВ, рдЗрдирдореЗрдВ рд╕реЗ рдХреЛрдИ рднреА рдлрд╝реЛрдЯреЛ рдЪреБрдиреЗрдВ рдФрд░ рдЙрд╕реЗ рдпреВрдЬрд╝рд░ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ (рдпреВрдЖрдИ) рдкрд░ рдЕрдкрд▓реЛрдб рдХрд░реЗрдВ:

рдЪреИрдЯ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдореЗрдВ, рдПрдЬреЗрдВрдЯ рдХреЛ рдЕрдкрдиреА рдЬрд╝рд░реВрд░рдд рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдмрддрд╛рдПрдВ:

Here is the survivor note

рдЗрд╕рдХреЗ рдмрд╛рдж, рдЗрдореЗрдЬ рдХреЛ рдпрд╣рд╛рдВ рдЕрдЯреИрдЪ рдХрд░реЗрдВ.

upload_input

upload_result

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, рдЬрд╛рдВрдЪ рдкреВрд░реА рд╣реЛрдиреЗ рдХреЗ рдмрд╛рдж, рдкреНрд░реЛрд╕реЗрд╕ рдХреЛ рдЦрддреНрдо рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП "Ctrl+C" рджрдмрд╛рдПрдВ.

6. GCS рдмрдХреЗрдЯ рдореЗрдВ рдорд▓реНрдЯреАрдореЛрдбрд▓ рдЕрдкрд▓реЛрдб рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░рдирд╛

  • Google Cloud Console Storage рдЦреЛрд▓реЗрдВ.
  • рдХреНрд▓рд╛рдЙрдб рд╕реНрдЯреЛрд░реЗрдЬ рдореЗрдВ "рдмрдХреЗрдЯ" рдХреЛ рдЪреБрдиреЗрдВ

gcs

  • рдЕрдкрдиреА рдмрдХреЗрдЯ рдЪреБрдиреЗрдВ рдФрд░ media рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ.

media

  • рдЕрдкрд▓реЛрдб рдХреА рдЧрдИ рдЕрдкрдиреА рдЗрдореЗрдЬ рдпрд╣рд╛рдВ рджреЗрдЦреЗрдВ. uploaded_img

7. Spanner рдореЗрдВ рдорд▓реНрдЯреАрдореЛрдбрд▓ рдЕрдкрд▓реЛрдб рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░рдирд╛ (рдЬрд╝рд░реВрд░реА рдирд╣реАрдВ)

рдпрд╣рд╛рдВ рдпреВрдЬрд╝рд░ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ (рдпреВрдЖрдИ) рдореЗрдВ test_photo1 рдХреЗ рд▓рд┐рдП рдЖрдЙрдЯрдкреБрдЯ рдХрд╛ рдЙрджрд╛рд╣рд░рдг рджрд┐рдпрд╛ рдЧрдпрд╛ рд╣реИ.

  • 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

12. тШХя╕П [рдЬрд╝рд░реВрд░реА рдирд╣реАрдВ] рдПрдЬреЗрдВрдЯ рдЗрдВрдЬрди рдХреЗ рд╕рд╛рде рдореЗрдореЛрд░реА рдмреИрдВрдХ

1. рдЬрд╛рдирдХрд╛рд░реА рдпрд╛рдж рд░рдЦрдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛ рдХреИрд╕реЗ рдХрд╛рдо рдХрд░рддреА рд╣реИ

рдпрд╣ рд╕рд┐рд╕реНрдЯрдо, рдбреНрдпреВрдЕрд▓-рдореЗрдореЛрд░реА рд╡рд╛рд▓реЗ рддрд░реАрдХреЗ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рддрд╛ рд╣реИ. рдЗрд╕рд╕реЗ рдпрд╣ рдореМрдЬреВрджрд╛ рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ рдФрд░ рд▓рдВрдмреЗ рд╕рдордп рддрдХ рд╕реЗрд╡ рд░рд╣рдиреЗ рд╡рд╛рд▓реА рдЬрд╛рдирдХрд╛рд░реА, рджреЛрдиреЛрдВ рдХреЛ рдореИрдиреЗрдЬ рдХрд░ рдкрд╛рддрд╛ рд╣реИ.

memory_bank

2. рдпрд╛рджреЛрдВ рдХреЗ рд╡рд┐рд╖рдп рдХреНрдпрд╛ рд╣реЛрддреЗ рд╣реИрдВ?

рдпрд╛рдж рд░рдЦрдиреЗ рдХреЗ рд╡рд┐рд╖рдп, рдЬрд╛рдирдХрд╛рд░реА рдХреА рдЙрди рдХреИрдЯрдЧрд░реА рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдмрддрд╛рддреЗ рд╣реИрдВ рдЬрд┐рдиреНрд╣реЗрдВ рдПрдЬреЗрдВрдЯ рдХреЛ рд╕рднреА рдмрд╛рддрдЪреАрдд рдХреЗ рджреМрд░рд╛рди рдпрд╛рдж рд░рдЦрдирд╛ рдЪрд╛рд╣рд┐рдП. рдЗрдиреНрд╣реЗрдВ рдЕрд▓рдЧ-рдЕрд▓рдЧ рддрд░рд╣ рдХреА рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдкреНрд░рд╛рдердорд┐рдХрддрд╛рдУрдВ рдХреЗ рд▓рд┐рдП рдлрд╝рд╛рдЗрд▓рд┐рдВрдЧ рдХреИрдмрд┐рдиреЗрдЯ рдХреЗ рддреМрд░ рдкрд░ рд╕рдордЭреЗрдВ.

рд╣рдорд╛рд░реЗ рджреЛ рд╡рд┐рд╖рдп:

  1. search_preferences: рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЛ рдХрд┐рд╕ рддрд░рд╣ рд╕реЗ рдЦреЛрдЬрдирд╛ рдкрд╕рдВрдж рд╣реИ
    • рдХреНрдпрд╛ рдЙрдиреНрд╣реЗрдВ рдХреАрд╡рд░реНрдб рдпрд╛ рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ рдкрд╕рдВрдж рд╣реИ?
    • рд╡реЗ рдЕрдХреНрд╕рд░ рдХреМрдирд╕реЗ рдХреМрд╢рд▓/рдмрд╛рдпреЛрдо рдЦреЛрдЬрддреЗ рд╣реИрдВ?
    • рдпрд╛рдж рд░рдЦреА рдЧрдИ рдЬрд╛рдирдХрд╛рд░реА рдХрд╛ рдЙрджрд╛рд╣рд░рдг: "рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреЛ рдореЗрдбрд┐рдХрд▓ рд╕реНрдХрд┐рд▓ рдХреЗ рд▓рд┐рдП рд╕рд┐рдореИрдВрдЯрд┐рдХ рд╕рд░реНрдЪ рдХрд╛ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдирд╛ рдкрд╕рдВрдж рд╣реИ"
  2. urgent_needs_context: рд╡реЗ рдХрд┐рди рд╕рдВрдХрдЯреЛрдВ рдХреЛ рдЯреНрд░реИрдХ рдХрд░ рд░рд╣реЗ рд╣реИрдВ
    • рд╡реЗ рдХрд┐рди рд╕рдВрд╕рд╛рдзрдиреЛрдВ рдХреА рдирд┐рдЧрд░рд╛рдиреА рдХрд░ рд░рд╣реЗ рд╣реИрдВ?
    • рдЙрдиреНрд╣реЗрдВ рдХрд┐рди рд▓реЛрдЧреЛрдВ рдХреА рдЪрд┐рдВрддрд╛ рд╣реИ?
    • рдпрд╛рдж рд░рдЦреА рдЧрдИ рдЬрд╛рдирдХрд╛рд░реА рдХрд╛ рдЙрджрд╛рд╣рд░рдг: "рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛, рдЙрддреНрддрд░реА рдХреИрдВрдк рдореЗрдВ рджрд╡рд╛ рдХреА рдХрдореА рдХреЛ рдЯреНрд░реИрдХ рдХрд░ рд░рд╣рд╛ рд╣реИ"

3. рдпрд╛рджреЛрдВ рдХреЗ рд╡рд┐рд╖рдп рд╕реЗрдЯ рдЕрдк рдХрд░рдирд╛

рдХрд╕реНрдЯрдо рдореЗрдореЛрд░реА рдХреЗ рд╡рд┐рд╖рдпреЛрдВ рд╕реЗ рдпрд╣ рддрдп рд╣реЛрддрд╛ рд╣реИ рдХрд┐ рдПрдЬреЗрдВрдЯ рдХреЛ рдХреНрдпрд╛ рдпрд╛рдж рд░рдЦрдирд╛ рдЪрд╛рд╣рд┐рдП. рдЗрдиреНрд╣реЗрдВ Agent Engine рдХреЛ рдбрд┐рдкреНрд▓реЙрдп рдХрд░рддреЗ рд╕рдордп рдХреЙрдиреНрдлрд╝рд┐рдЧрд░ рдХрд┐рдпрд╛ рдЬрд╛рддрд╛ рд╣реИ.

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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

рдЗрд╕рд╕реЗ рдЖрдкрдХреЗ рдПрдбрд┐рдЯрд░ рдореЗрдВ ~/way-back-home/level_2/backend/deploy_agent.py рдЦреБрд▓ рдЬрд╛рдПрдЧрд╛.

рд╣рдо рд╕реНрдЯреНрд░рдХреНрдЪрд░ 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."
                """,
            )
        )
    ]

4. рдПрдЬреЗрдВрдЯ рдХреЗ рд╕рд╛рде рдЗрдВрдЯрд┐рдЧреНрд░реЗрд╢рди

рдПрдЬреЗрдВрдЯ рдХреЛрдб рдХреЛ рдореЗрдореЛрд░реА рдмреИрдВрдХ рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдкрддрд╛ рд╣реЛрдирд╛ рдЪрд╛рд╣рд┐рдП, рддрд╛рдХрд┐ рд╡рд╣ рдЬрд╛рдирдХрд╛рд░реА рд╕реЗрд╡ рдХрд░ рд╕рдХреЗ рдФрд░ рдЙрд╕реЗ рд╡рд╛рдкрд╕ рдкрд╛ рд╕рдХреЗ.

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпрд╣ рдХрдорд╛рдВрдб рдЪрд▓рд╛рдПрдВ:

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 Session Service рд╕реЗрдЯ рдЕрдк рдХрд░рдирд╛

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, Cloud Shell Editor рдореЗрдВ 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
    )

13. тШХя╕П [рдЬрд╝рд░реВрд░реА рдирд╣реАрдВ] рдПрдЬреЗрдВрдЯ рдХреЛ Agent Engine рд╕реЗ рдЕрдЯреИрдЪ рдХрд░рдирд╛

1. рд╕реЗрдЯрдЕрдк рдФрд░ рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ

рдЬрд╛рдирдХрд╛рд░реА рдпрд╛рдж рд░рдЦрдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛рдУрдВ рдХреЛ рдЯреЗрд╕реНрдЯ рдХрд░рдиреЗ рд╕реЗ рдкрд╣рд▓реЗ, рдЖрдкрдХреЛ рдПрдЬреЗрдВрдЯ рдХреЛ рдЬрд╛рдирдХрд╛рд░реА рдпрд╛рдж рд░рдЦрдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛ рд╕реЗ рдЬреБрдбрд╝реЗ рдирдП рд╡рд┐рд╖рдпреЛрдВ рдХреЗ рд╕рд╛рде рдбрд┐рдкреНрд▓реЙрдп рдХрд░рдирд╛ рд╣реЛрдЧрд╛. рд╕рд╛рде рд╣реА, рдпрд╣ рдкрдХреНрдХрд╛ рдХрд░рдирд╛ рд╣реЛрдЧрд╛ рдХрд┐ рдЖрдкрдХрд╛ рдПрдирд╡рд╛рдпрд░рдореЗрдВрдЯ рд╕рд╣реА рддрд░реАрдХреЗ рд╕реЗ рдХреЙрдиреНрдлрд╝рд┐рдЧрд░ рдХрд┐рдпрд╛ рдЧрдпрд╛ рд╣реЛ.

рд╣рдордиреЗ рдЗрд╕ рдкреНрд░реЛрд╕реЗрд╕ рдХреЛ рдореИрдиреЗрдЬ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдПрдХ рдЖрд╕рд╛рди рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдЙрдкрд▓рдмреНрдз рдХрд░рд╛рдИ рд╣реИ.

рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдЪрд▓рд╛рдирд╛

ЁЯСЙЁЯТ╗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ, рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдЪрд▓рд╛рдПрдВ:

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 рдореЗрдВ рдмрджрд▓рд╛рд╡ рдХрд┐рдП рдЬрд╛рддреЗ рд╣реИрдВ, рддреЛ рдЖрдкрдХреЛ рдПрдЬреЗрдВрдЯ рдЗрдВрдЬрди рдХреЛ рдЕрдкрдбреЗрдЯ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП, рдЗрд╕ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдХреЛ рдлрд┐рд░ рд╕реЗ рдЪрд▓рд╛рдирд╛ рд╣реЛрдЧрд╛.

рдореЗрдореЛрд░реА рдмреИрдВрдХ рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░рдирд╛

рдЕрдм рдпрд╣ рдкреБрд╖реНрдЯрд┐ рдХреА рдЬрд╛ рд╕рдХрддреА рд╣реИ рдХрд┐ рдореЗрдореЛрд░реА рдмреИрдВрдХ рдХрд╛рдо рдХрд░ рд░рд╣рд╛ рд╣реИ рдпрд╛ рдирд╣реАрдВ. рдЗрд╕рдХреЗ рд▓рд┐рдП, рдПрдЬреЗрдВрдЯ рдХреЛ рдХреЛрдИ рдкреНрд░рд╛рдердорд┐рдХрддрд╛ рд╕рд┐рдЦрд╛рдПрдВ рдФрд░ рджреЗрдЦреЗрдВ рдХрд┐ рд╡рд╣ рд╕рднреА рд╕реЗрд╢рди рдореЗрдВ рдмрдиреА рд░рд╣рддреА рд╣реИ рдпрд╛ рдирд╣реАрдВ.

рдкрд╣рд▓рд╛ рдЪрд░рдг. рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЦреЛрд▓реЗрдВ

рдпрд╣рд╛рдВ рджрд┐рдП рдЧрдП рдирд┐рд░реНрджреЗрд╢реЛрдВ рдХрд╛ рдкрд╛рд▓рди рдХрд░рдХреЗ, рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдХреЛ рдлрд┐рд░ рд╕реЗ рдЦреЛрд▓реЗрдВ: рдЕрдЧрд░ рдкрд┐рдЫрд▓рд╛ рдЯрд░реНрдорд┐рдирд▓ рдЕрдм рднреА рдЪрд▓ рд░рд╣рд╛ рд╣реИ, рддреЛ рдЙрд╕реЗ рдмрдВрдж рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП Ctrls+C рджрдмрд╛рдПрдВ.

ЁЯСЙЁЯТ╗ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЦреЛрд▓реЗрдВ:

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

ЁЯСЙ рдЯрд░реНрдорд┐рдирд▓ рд╕реЗ Local: http://localhost:5173/ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ.

рджреВрд╕рд░рд╛ рдЪрд░рдг. рдЯреЗрдХреНрд╕реНрдЯ рдХреЗ рд╕рд╛рде рдореЗрдореЛрд░реА рдмреИрдВрдХ рдХреА рдЬрд╛рдВрдЪ рдХрд░рдирд╛

рдЪреИрдЯ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдореЗрдВ, рдПрдЬреЗрдВрдЯ рдХреЛ рдЕрдкрдиреА рдЬрд╝рд░реВрд░рдд рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдмрддрд╛рдПрдВ:

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

ЁЯСЙ рдмреИрдХрдЧреНрд░рд╛рдЙрдВрдб рдореЗрдВ рдЬрд╛рдирдХрд╛рд░реА рдкреНрд░реЛрд╕реЗрд╕ рд╣реЛрдиреЗ рдХреЗ рд▓рд┐рдП, ~30 рд╕реЗрдХрдВрдб рддрдХ рдЗрдВрддрдЬрд╝рд╛рд░ рдХрд░реЗрдВ.

рддреАрд╕рд░рд╛ рдЪрд░рдг. рдирдпрд╛ рд╕реЗрд╢рди рд╢реБрд░реВ рдХрд░рдирд╛

рдореМрдЬреВрджрд╛ рдмрд╛рддрдЪреАрдд рдХрд╛ рдЗрддрд┐рд╣рд╛рд╕ (рд╢реЙрд░реНрдЯ-рдЯрд░реНрдо рдореЗрдореЛрд░реА) рдорд┐рдЯрд╛рдиреЗ рдХреЗ рд▓рд┐рдП, рдкреЗрдЬ рдХреЛ рд░реАрдлрд╝реНрд░реЗрд╢ рдХрд░реЗрдВ.

рдРрд╕рд╛ рд╕рд╡рд╛рд▓ рдкреВрдЫреЗрдВ рдЬреЛ рдЖрдкрдХреЗ рджрд┐рдП рдЧрдП рдХреЙрдиреНрдЯреЗрдХреНрд╕реНрдЯ рдкрд░ рдЖрдзрд╛рд░рд┐рдд рд╣реЛ:

"What kind of missions am I interested in?"

рдЙрдореНрдореАрдж рдХреЗ рдореБрддрд╛рдмрд┐рдХ рдЬрд╡рд╛рдм:

"рдЖрдкрдХреА рдкрд┐рдЫрд▓реА рдмрд╛рддрдЪреАрдд рдХреЗ рдЖрдзрд╛рд░ рдкрд░, рдЖрдкрдХреА рджрд┐рд▓рдЪрд╕реНрдкреА рдЗрдирдореЗрдВ рд╣реИ:

  • рдореЗрдбрд┐рдХрд▓ рд░реЗрд╕реНрдХреНрдпреВ рдорд┐рд╢рди
  • рдкрд╣рд╛рдбрд╝/рдЬрд╝реНрдпрд╛рджрд╛ рдКрдВрдЪрд╛рдИ рд╡рд╛рд▓реА рдЬрдЧрд╣реЛрдВ рдкрд░ рдХреА рдЬрд╛рдиреЗ рд╡рд╛рд▓реА рдХрд╛рд░реНрд░рд╡рд╛рдЗрдпрд╛рдВ
  • рдЬрд╝рд░реВрд░реА рд╕реНрдХрд┐рд▓: рдкреНрд░рд╛рдердорд┐рдХ рдЗрд▓рд╛рдЬ, рдЪрдврд╝рд╛рдИ рдХрд░рдирд╛

рдХреНрдпрд╛ рдЖрдкрдХреЛ рдЗрди рд╢рд░реНрддреЛрдВ рдХреЗ рдореБрддрд╛рдмрд┐рдХ, рдмрдЪреЗ рд╣реБрдП рд▓реЛрдЧреЛрдВ рдХреА рдЬрд╛рдирдХрд╛рд░реА рдЪрд╛рд╣рд┐рдП?"

рдЪреМрдерд╛ рдЪрд░рдг. рдЗрдореЗрдЬ рдЕрдкрд▓реЛрдб рдХрд░рдХреЗ рдЯреЗрд╕реНрдЯ рдХрд░рдирд╛

рдХреЛрдИ рдЗрдореЗрдЬ рдЕрдкрд▓реЛрдб рдХрд░реЗрдВ рдФрд░ рдпрд╣ рд╕рд╡рд╛рд▓ рдкреВрдЫреЗрдВ:

remember this

рдпрд╣рд╛рдВ рджреА рдЧрдИ рдХреЛрдИ рднреА рдлрд╝реЛрдЯреЛ рдпрд╛ рдЕрдкрдиреА рдХреЛрдИ рдлрд╝реЛрдЯреЛ рдЪреБрдиреЗрдВ рдФрд░ рдЙрд╕реЗ рдпреВрдЬрд╝рд░ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ (рдпреВрдЖрдИ) рдкрд░ рдЕрдкрд▓реЛрдб рдХрд░реЗрдВ:

рдкрд╛рдВрдЪрд╡рд╛рдВ рдЪрд░рдг. Vertex AI Agent Engine рдореЗрдВ рдкреБрд╖реНрдЯрд┐ рдХрд░рдирд╛

Google Cloud Console Agent Engine рдкрд░ рдЬрд╛рдПрдВ

  1. рдкрдХреНрдХрд╛ рдХрд░реЗрдВ рдХрд┐ рдЖрдкрдиреЗ рд╕рдмрд╕реЗ рдКрдкрд░ рдмрд╛рдИрдВ рдУрд░ рдореМрдЬреВрдж рдкреНрд░реЛрдЬреЗрдХреНрдЯ рд╕рд┐рд▓реЗрдХреНрдЯрд░ рд╕реЗ рдкреНрд░реЛрдЬреЗрдХреНрдЯ рдЪреБрдирд╛ рд╣реЛ:рдкреНрд░реЛрдЬреЗрдХреНрдЯ рдЪреБрдирдиреЗ рдХрд╛ рд╡рд┐рдХрд▓реНрдк
  2. рдкрд┐рдЫрд▓реЗ рдирд┐рд░реНрджреЗрд╢ рд╕реЗ рдбрд┐рдкреНрд▓реЙрдп рдХрд┐рдП рдЧрдП рдПрдЬреЗрдВрдЯ рдЗрдВрдЬрди рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░реЗрдВ use_memory_bank.sh:рдПрдЬреЗрдВрдЯ рдЗрдВрдЬрдирдЕрднреА-рдЕрднреА рдмрдирд╛рдП рдЧрдП рдПрдЬреЗрдВрдЯ рдЗрдВрдЬрди рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ.
  3. рдбрд┐рдкреНрд▓реЙрдп рдХрд┐рдП рдЧрдП рдЗрд╕ рдПрдЬреЗрдВрдЯ рдореЗрдВ, Memories рдЯреИрдм рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ. рдпрд╣рд╛рдВ рдЖрдкрдХреЛ рд╕реЗрд╡ рдХреА рдЧрдИ рд╕рднреА рдЬрд╛рдирдХрд╛рд░реА рджрд┐рдЦреЗрдЧреА.рдпрд╛рджреЗрдВ рджреЗрдЦреЗрдВ

ЁЯСЙЁЯТ╗ рдЯреЗрд╕реНрдЯрд┐рдВрдЧ рдкреВрд░реА рд╣реЛрдиреЗ рдХреЗ рдмрд╛рдж, рдЕрдкрдиреЗ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ "Ctrl + C" рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░рдХреЗ рдкреНрд░реЛрд╕реЗрд╕ рдХреЛ рдЦрддреНрдо рдХрд░реЗрдВ.

ЁЯОЙ рдмрдзрд╛рдИ рд╣реЛ! рдЖрдкрдиреЗ рдЕрдкрдиреЗ рдПрдЬреЗрдВрдЯ рд╕реЗ рдореЗрдореЛрд░реА рдмреИрдВрдХ рдХреЛ рдЕрдЯреИрдЪ рдХрд░ рджрд┐рдпрд╛ рд╣реИ!

14. тШХя╕П [рдЬрд╝рд░реВрд░реА рдирд╣реАрдВ] Cloud Run рдкрд░ рдбрд┐рдкреНрд▓реЙрдп рдХрд░рдирд╛

1. рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдЪрд▓рд╛рдирд╛

ЁЯСЙЁЯТ╗ рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ рд╕реНрдХреНрд░рд┐рдкреНрдЯ рдЪрд▓рд╛рдПрдВ:

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

рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ рдкреВрд░рд╛ рд╣реЛрдиреЗ рдХреЗ рдмрд╛рдж, рдЖрдкрдХреЛ рдПрдХ рдпреВрдЖрд░рдПрд▓ рдорд┐рд▓реЗрдЧрд╛. рдпрд╣ рдЖрдкрдХрд╛ рдбрд┐рдкреНрд▓реЙрдп рдХрд┐рдпрд╛ рдЧрдпрд╛ рдпреВрдЖрд░рдПрд▓ рд╣реИ! рдбрд┐рдкреНрд▓реЙрдп рдХрд┐рдпрд╛ рдЧрдпрд╛

ЁЯСЙЁЯТ╗ рдпреВрдЖрд░рдПрд▓ рдХреЙрдкреА рдХрд░рдиреЗ рд╕реЗ рдкрд╣рд▓реЗ, рдпрд╣ рдХреЛрдб рдЪрд▓рд╛рдХрд░ рдЕрдиреБрдорддрд┐ рджреЗрдВ:

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

рдбрд┐рдкреНрд▓реЙрдп рдХрд┐рдП рдЧрдП рдпреВрдЖрд░рдПрд▓ рдкрд░ рдЬрд╛рдПрдВ. рдЖрдкрдХреЛ рд╡рд╣рд╛рдВ рдЕрдкрдирд╛ рдРрдкреНрд▓рд┐рдХреЗрд╢рди рд▓рд╛рдЗрд╡ рджрд┐рдЦреЗрдЧрд╛!

2. рдмрд┐рд▓реНрдб рдкрд╛рдЗрдкрд▓рд╛рдЗрди рдХреЛ рд╕рдордЭрдирд╛

cloudbuild.yaml рдлрд╝рд╛рдЗрд▓ рдореЗрдВ, рдХреНрд░рдо рд╕реЗ рдЪрд▓рдиреЗ рд╡рд╛рд▓реЗ рдЗрди рдЪрд░рдгреЛрдВ рдХреЗ рдмрд╛рд░реЗ рдореЗрдВ рдмрддрд╛рдпрд╛ рдЧрдпрд╛ рд╣реИ:

  1. рдмреИрдХрдПрдВрдб рдмрд┐рд▓реНрдб: backend/Dockerfile рд╕реЗ рдбреЙрдХрд░ рдЗрдореЗрдЬ рдмрдирд╛рддрд╛ рд╣реИ.
  2. рдмреИрдХрдПрдВрдб рдбрд┐рдкреНрд▓реЙрдп: рдмреИрдХрдПрдВрдб рдХрдВрдЯреЗрдирд░ рдХреЛ Cloud Run рдкрд░ рдбрд┐рдкреНрд▓реЙрдп рдХрд░рддрд╛ рд╣реИ.
  3. рдХреИрдкреНрдЪрд░ рдпреВрдЖрд░рдПрд▓: рдЗрд╕рд╕реЗ рдирдпрд╛ рдмреИрдХрдПрдВрдб рдпреВрдЖрд░рдПрд▓ рдорд┐рд▓рддрд╛ рд╣реИ.
  4. рдлрд╝реНрд░рдВрдЯрдПрдВрдб рдмрд┐рд▓реНрдб:
    • рдбрд┐рдкреЗрдВрдбреЗрдВрд╕реА рдЗрдВрд╕реНрдЯреЙрд▓ рдХрд░рддрд╛ рд╣реИ.
    • рдпрд╣ React рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдХреЛ рдмрд┐рд▓реНрдб рдХрд░рддрд╛ рд╣реИ рдФрд░ VITE_API_URL= рдХреЛ рдЗрдВрдЬреЗрдХреНрдЯ рдХрд░рддрд╛ рд╣реИ.
  5. рдлрд╝реНрд░рдВрдЯрдПрдВрдб рдЗрдореЗрдЬ: frontend/Dockerfile рд╕реЗ Docker рдЗрдореЗрдЬ рдмрдирд╛рддрд╛ рд╣реИ (рд╕реНрдЯреИрдЯрд┐рдХ рдРрд╕реЗрдЯ рдХреЛ рдкреИрдХреЗрдЬ рдХрд░рдирд╛).
  6. рдлрд╝реНрд░рдВрдЯрдПрдВрдб рдбрд┐рдкреНрд▓реЙрдп: рдлрд╝реНрд░рдВрдЯрдПрдВрдб рдХрдВрдЯреЗрдирд░ рдХреЛ рдбрд┐рдкреНрд▓реЙрдп рдХрд░рддрд╛ рд╣реИ.

3. рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ рдХреА рдкреБрд╖реНрдЯрд┐ рдХрд░рдирд╛

рдмрд┐рд▓реНрдб рдкреВрд░рд╛ рд╣реЛрдиреЗ рдХреЗ рдмрд╛рдж, рд╕реНрдХреНрд░рд┐рдкреНрдЯ рд╕реЗ рдорд┐рд▓реЗ рд▓реЙрдЧ рд▓рд┐рдВрдХ рдХреЛ рджреЗрдЦреЗрдВ. рдЗрд╕рдХреЗ рдмрд╛рдж, рдЗрдирдХреА рдкреБрд╖реНрдЯрд┐ рдХреА рдЬрд╛ рд╕рдХрддреА рд╣реИ:

  1. Cloud Run Console рдкрд░ рдЬрд╛рдПрдВ.
  2. survivor-frontend рд╕реЗрд╡рд╛ рдвреВрдВрдвреЗрдВ.
  3. рдРрдкреНрд▓рд┐рдХреЗрд╢рди рдЦреЛрд▓рдиреЗ рдХреЗ рд▓рд┐рдП, рдпреВрдЖрд░рдПрд▓ рдкрд░ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ.
  4. рд╕рд░реНрдЪ рдХреНрд╡реЗрд░реА рдЪрд▓рд╛рдПрдВ, рддрд╛рдХрд┐ рдпрд╣ рдкрдХреНрдХрд╛ рдХрд┐рдпрд╛ рдЬрд╛ рд╕рдХреЗ рдХрд┐ рдлрд╝реНрд░рдВрдЯрдПрдВрдб, рдмреИрдХрдПрдВрдб рд╕реЗ рдХрдореНрдпреВрдирд┐рдХреЗрдЯ рдХрд░ рд╕рдХрддрд╛ рд╣реИ.

(рдЬрд╝рд░реВрд░реА рдирд╣реАрдВ) 4. рдореИрдиреНрдпреБрдЕрд▓ рддрд░реАрдХреЗ рд╕реЗ рдбрд┐рдкреНрд▓реЙрдп рдХрд░рдирд╛

рдЕрдЧрд░ рдЖрдкрдХреЛ рдХрдорд╛рдВрдб рдореИрдиреНрдпреБрдЕрд▓ рддрд░реАрдХреЗ рд╕реЗ рдЪрд▓рд╛рдиреЗ рд╣реИрдВ рдпрд╛ рдкреНрд░реЛрд╕реЗрд╕ рдХреЛ рдмреЗрд╣рддрд░ рддрд░реАрдХреЗ рд╕реЗ рд╕рдордЭрдирд╛ рд╣реИ, рддреЛ cloudbuild.yaml рдХреЛ рд╕реАрдзреЗ рддреМрд░ рдкрд░ рдЗрд╕реНрддреЗрдорд╛рд▓ рдХрд░рдиреЗ рдХрд╛ рддрд░реАрдХрд╛ рдпрд╣рд╛рдВ рдмрддрд╛рдпрд╛ рдЧрдпрд╛ рд╣реИ.

cloudbuild.yaml рдореЗрдВ рд▓рд┐рдЦрд╛ рдЬрд╛ рд░рд╣рд╛ рд╣реИ

cloudbuild.yaml рдлрд╝рд╛рдЗрд▓ рд╕реЗ Google Cloud Build рдХреЛ рдкрддрд╛ рдЪрд▓рддрд╛ рд╣реИ рдХрд┐ рдХреМрдирд╕реЗ рдЪрд░рдг рдкреВрд░реЗ рдХрд░рдиреЗ рд╣реИрдВ.

  • steps: рдХреНрд░рдо рдореЗрдВ рдХреА рдЬрд╛рдиреЗ рд╡рд╛рд▓реА рдХрд╛рд░реНрд░рд╡рд╛рдЗрдпреЛрдВ рдХреА рд╕реВрдЪреА. рд╣рд░ рдЪрд░рдг рдПрдХ рдХрдВрдЯреЗрдирд░ рдореЗрдВ рдЪрд▓рддрд╛ рд╣реИ. рдЙрджрд╛рд╣рд░рдг рдХреЗ рд▓рд┐рдП, 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"

15. рдирддреАрдЬрд╛

1. рдЖрдкрдиреЗ рдХреНрдпрд╛ рдмрдирд╛рдпрд╛ рд╣реИ

тЬЕ рдЧреНрд░рд╛рдлрд╝ рдбреЗрдЯрд╛рдмреЗрд╕: Spanner, рдЬрд┐рд╕рдореЗрдВ рдиреЛрдб (рдмрдЪреЗ рд╣реБрдП рд▓реЛрдЧ, рдХреМрд╢рд▓) рдФрд░ рдПрдЬ (рд░рд┐рд╢реНрддреЗ) рд╢рд╛рдорд┐рд▓ рд╣реИрдВ
тЬЕ рдПрдЖрдИ рд╕рд░реНрдЪ: рдПрдореНрдмреЗрдбрд┐рдВрдЧ рдХреЗ рд╕рд╛рде рдХреАрд╡рд░реНрдб, рд╕рд┐рдореИрдВрдЯрд┐рдХ, рдФрд░ рд╣рд╛рдЗрдмреНрд░рд┐рдб рд╕рд░реНрдЪ
тЬЕ рдорд▓реНрдЯреАрдореЛрдбрд▓ рдкрд╛рдЗрдкрд▓рд╛рдЗрди: Gemini рдХреА рдорджрдж рд╕реЗ рдЗрдореЗрдЬ/рд╡реАрдбрд┐рдпреЛ рд╕реЗ рдЗрдХрд╛рдЗрдпрд╛рдВ рдирд┐рдХрд╛рд▓реЗрдВ
тЬЕ рдорд▓реНрдЯреА-рдПрдЬреЗрдВрдЯ рд╕рд┐рд╕реНрдЯрдо: ADK рдХреЗ рд╕рд╛рде рдХреЛрдСрд░реНрдбрд┐рдиреЗрдЯреЗрдб рд╡рд░реНрдХрдлрд╝реНрд▓реЛ
тЬЕ рдореЗрдореЛрд░реА рдмреИрдВрдХ: Vertex AI рдХреА рдорджрдж рд╕реЗ рд▓рдВрдмреЗ рд╕рдордп рддрдХ рдордирдореБрддрд╛рдмрд┐рдХ рдмрдирд╛рдиреЗ рдХреА рд╕реБрд╡рд┐рдзрд╛
тЬЕ рдкреНрд░реЛрдбрдХреНрд╢рди рдбрд┐рдкреНрд▓реЙрдпрдореЗрдВрдЯ: Cloud Run + Agent Engine

2. рдЖрд░реНрдХрд┐рдЯреЗрдХреНрдЪрд░ рдХреА рдЦрд╛рд╕ рдЬрд╛рдирдХрд╛рд░реА

architecture_fullstack

3. рд╕реАрдЦрдиреЗ рд▓рд╛рдпрдХ рдЬрд╝рд░реВрд░реА рдмрд╛рддреЗрдВ

  1. Graph RAG: рдпрд╣ рдмреЗрд╣рддрд░ рдЦреЛрдЬ рдХреЗ рд▓рд┐рдП, рдЧреНрд░рд╛рдлрд╝ рдбреЗрдЯрд╛рдмреЗрд╕ рд╕реНрдЯреНрд░рдХреНрдЪрд░ рдХреЛ рд╕рд┐рдореИрдВрдЯрд┐рдХ рдПрдВрдмреЗрдбрд┐рдВрдЧ рдХреЗ рд╕рд╛рде рдЬреЛрдбрд╝рддрд╛ рд╣реИ
  2. рдорд▓реНрдЯреА-рдПрдЬреЗрдВрдЯ рдкреИрдЯрд░реНрди: рдореБрд╢реНрдХрд┐рд▓ рдФрд░ рдХрдИ рдЪрд░рдгреЛрдВ рд╡рд╛рд▓реЗ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ рдХреЗ рд▓рд┐рдП, рдХреНрд░рдо рд╕реЗ рдЪрд▓рдиреЗ рд╡рд╛рд▓реА рдкрд╛рдЗрдкрд▓рд╛рдЗрди
  3. рдорд▓реНрдЯреАрдореЙрдбрд▓ рдПрдЖрдИ: рдЕрдирд╕реНрдЯреНрд░рдХреНрдЪрд░реНрдб рдореАрдбрд┐рдпрд╛ (рдЗрдореЗрдЬ/рд╡реАрдбрд┐рдпреЛ) рд╕реЗ рд╕реНрдЯреНрд░рдХреНрдЪрд░реНрдб рдбреЗрдЯрд╛ рдПрдХреНрд╕рдЯреНрд░реИрдХреНрдЯ рдХрд░рдирд╛
  4. рд╕реНрдЯреЗрдЯрдлрд╝реБрд▓ рдПрдЬреЗрдВрдЯ: рдореЗрдореЛрд░реА рдмреИрдВрдХ рдХреА рдорджрдж рд╕реЗ, рдЕрд▓рдЧ-рдЕрд▓рдЧ рд╕реЗрд╢рди рдореЗрдВ рдЙрдкрдпреЛрдЧрдХрд░реНрддрд╛ рдХреА рджрд┐рд▓рдЪрд╕реНрдкреА рдХреЗ рд╣рд┐рд╕рд╛рдм рд╕реЗ рдЬрд╡рд╛рдм рджрд┐рдП рдЬрд╛ рд╕рдХрддреЗ рд╣реИрдВ

4. рд╡рд░реНрдХрд╢реЙрдк рдХреЙрдиреНрдЯреЗрдВрдЯ

5. рд╕рдВрд╕рд╛рдзрди