docs/TOOLS_SDK_SETUP.md

🔧 Tool Calling Setup - SDK Requirements

⚠️ Important: SDK Installation Required

The tool calling feature requires the new Google GenAI SDK to be installed.

📦 Installation

pip install google-genai

🔍 Verification

Check if installed correctly:

python -c "from google import genai; print('✅ SDK installed successfully')"

📋 Current Status

Without the SDK installed, the system will:

• ✅ Run normally without tool calling
• ⚠️ Display warning: "Tools will be disabled. Install google-genai SDK..."
• ❌ Function calling will not work

🚀 After Installation

Once installed, the AI will be able to:

1. Call inspect_node() to get node information
2. Call find_best_nodes() to search for optimal positions
3. Call analyze_path_potential() to plan road building
4. Use dynamic thinking budgets per iteration

🔗 More Information

• SDK Documentation: https://github.com/googleapis/python-genai
• Tool Integration Docs: docs/TOOLS_INTEGRATION.md
• Test Tools: python examples/ai_testing/test_tools_integration.py

---

📝 Notes

• The old google-generativeai package is different and won't work
• Use the new google-genai package (note the hyphen!)
• Tool calling works with Gemini 2.0+ models
• Thinking mode requires gemini-2.0-flash-thinking-exp model