ai-agent-book 精选快照（<2MB 代码与文档，来自 github.com/bojieli/ai-agent-book）

chapter4/perception-tools/env.example

@@ -0,0 +1,65 @@
+# ==============================================================================
+# PERCEPTION TOOLS MCP SERVER - ENVIRONMENT CONFIGURATION
+# ==============================================================================
+
+# ------------------------------------------------------------------------------
+# FREE APIS (No keys required - enabled by default)
+# ------------------------------------------------------------------------------
+
+# Web Search: DuckDuckGo (free, no API key required)
+# Weather: Open-Meteo (free, no API key required)
+# Stock Prices: Yahoo Finance (free, no API key required)
+# Crypto Prices: CoinGecko (free, no API key required)
+# Currency: ExchangeRate-API (free, no API key required)
+# Location Search: Nominatim/OpenStreetMap (free, no API key required)
+# POI Search: Overpass API/OpenStreetMap (free, no API key required)
+# Wikipedia: Wikipedia API (free, no API key required)
+# ArXiv: ArXiv API (free, no API key required)
+# Wayback Machine: Internet Archive (free, no API key required)
+
+# ------------------------------------------------------------------------------
+# VISION / LLM (for analyze_image_ai, analyze_video_ai, Whisper API fallback)
+# ------------------------------------------------------------------------------
+
+# Direct OpenAI (preferred when set):
+# OPENAI_API_KEY=your-openai-api-key
+# OPENAI_BASE_URL=https://your-gateway/v1   # optional custom gateway
+# PERCEPTION_VISION_MODEL=gpt-5.6-luna       # optional model override
+# PERCEPTION_VISION_PROVIDER=gemini           # select Gemini explicitly
+# GEMINI_API_KEY=xxxx                         # Gemini OpenAI-compatible vision
+
+# Universal OpenRouter fallback: if OPENAI_API_KEY is absent but this is set,
+# the vision tools route through OpenRouter (base_url=https://openrouter.ai/api/v1)
+# with the model id mapped to provider/model form (gpt-* -> openai/…).
+# Note: local Whisper transcription needs OPENAI_API_KEY (OpenRouter has no audio API).
+# OPENROUTER_API_KEY=your-openrouter-api-key
+
+# ------------------------------------------------------------------------------
+# OPTIONAL APIs (Requires API keys for additional features)
+# ------------------------------------------------------------------------------
+
+# Notion API (for Notion integration)
+# Get your API key at: https://www.notion.so/my-integrations
+# NOTION_API_KEY=your_notion_api_key_here
+
+# Required only for move/copy/delete tools. Mutations accept relative paths and
+# are rejected unless this explicit workspace exists. Delete/overwrite are
+# reversible quarantine moves beneath the same root.
+# PERCEPTION_MUTATION_ROOT=/absolute/path/to/disposable/experiment-workspace
+
+# Google Calendar (uses OAuth2 authentication)
+# Run the setup script to authenticate with Google Calendar
+# Requires: google-auth-oauthlib, google-auth-httplib2, google-api-python-client
+
+# ------------------------------------------------------------------------------
+# LEGACY APIS (No longer needed but kept for backward compatibility)
+# ------------------------------------------------------------------------------
+
+# Google Custom Search API (replaced by DuckDuckGo)
+# Get API key at: https://developers.google.com/custom-search
+# GOOGLE_API_KEY=your_google_api_key_here
+# GOOGLE_CSE_ID=your_custom_search_engine_id_here
+
+# OpenWeather API (replaced by Open-Meteo)
+# Get API key at: https://openweathermap.org/api
+# OPENWEATHER_API_KEY=your_openweather_api_key_here