行程规划AI代理

基于Google AI开发套件(ADK)的AI代理,根据用户偏好、位置和预算限制生成创意有趣的单日行程计划。

  • by Madhu-712
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Madhu-712/ADK-Agentic-Pattern-with-Memory-MCP

使用说明

ADK一日游规划代理

一个使用谷歌人工智能开发工具包(ADK)构建的专用AI代理,能够根据用户的偏好、位置和预算限制,生成创意且有趣的当日游计划。

请务必检查一下 goo.gle/高级广告开发工具(或根据具体上下文,可译为“goo.gle/高级广告套件”等) 来开展这个项目。

特点

  • 🎯(目标) 个性化规划根据用户的兴趣和偏好生成旅行建议
  • 📍(定位点/位置标记) 位置感知支持城市名称、地址或GPS坐标
  • 💰(钱的符号,常用于表示金钱或价格) 注重预算目标是开展适度的预算活动(既负担得起又有价值)
  • 🔍 翻译为中文是:“🔍”(这个符号本身在中文中通常表示“放大镜”或“搜索”的意思,但在这里直接保留原样,因为它是通用的符号)。不过,如果要解释这个符号在中文语境下的常见用法,可以是:“🔍 用于表示搜索、放大镜或查看细节的动作。” 但直接翻译该符号本身并无具体含义,故保留原样。 实时搜索使用谷歌搜索查找当前事件和场地
  • 📅 日期表/日历 特定日期的为特定周末日期规划活动
  • 🎨 表示“美术”或“绘画”的意思。 创意建议每个计划最多可包含3项不同的活动,并附有详细位置信息

教程

如需了解如何设置此项目的分步指南,请参阅 教程。

先决条件

  • Python 3.8或更高版本
  • Google Cloud SDK 已安装并已通过身份验证gcloud auth login)

快速设置

此项目使用一个设置脚本来自动配置环境。只需为您的操作系统运行该脚本即可。

对于Mac/Linux用户

chmod +x setup_venv.sh
./setup_venv.sh

对于Windows用户

setup_venv.bat

脚本的作用

设置脚本将:

  1. 检查Python确保您已安装 Python 3.8 或更高版本。

  2. 创建虚拟环境建立一个专用的 .adk_env 目录。

  3. 安装依赖项从(指定位置)安装所需的Python包 requirements.txt。

  4. 请输入项目ID要求您提供Google Cloud项目ID。

  5. 创造 .env 文件生成一个 .env 在根目录中放置一个具有以下配置的文件:

    GOOGLE_GENAI_USE_VERTEXAI=TRUE
    GOOGLE_CLOUD_PROJECT=your_project_id
    GOOGLE_CLOUD_LOCATION=us-central1
    

运行代理程序

设置完成后:

  1. 激活虚拟环境:

    Mac/Linux:

    source .adk_env/bin/activate
    

    Windows:

    .adk_env\Scripts\activate
    
  2. 运行ADK网页界面:

    adk web
    

停用环境

完成后,您可以停用虚拟环境:

deactivate