48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
|
# trollagent_gear - Google Cloud Vertex AI (Gemini) Troll Agent
|
||
|
|
|
||
|
|
`trollagent_gear` delegates autonomous tactical reasoning to Google Cloud Vertex AI and Gemini models (`gemini-2.5-flash`, `gemini-1.5-flash`, etc.) to drive a solitary Troll character in **botWebWars**.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 👹 Troll Strategy & Gemini Reasoning
|
||
|
|
|
||
|
|
- **Hunter Instinct**: Evaluates radar minimaps to track and corner player bots and squads.
|
||
|
|
- **Troll Truce**: Instinctively ignores other trolls.
|
||
|
|
- **Sleep & Regeneration Strategy**: Leverages Gemini reasoning to evaluate current HP against target proximity—choosing when to safely **rest and sleep** (+0.1 HP regeneration) vs. when to strike.
|
||
|
|
- **Obstacle Navigation**: Balances Euclidean and Chebyshev distance against the -0.1 strength diagonal squeeze penalty.
|
||
|
|
- **No Wizard Challenges**: Never interacts with Gary the Wizard.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## ⚙️ Configuration & CLI Options
|
||
|
|
|
||
|
|
| Flag | Short | Default | Description |
|
||
|
|
|---|---|---|---|
|
||
|
|
| `--url` | `-u` | `http://localhost:8000/api` | botWebWars API base endpoint |
|
||
|
|
| `--name` | `-n` | `GeminiTroll` | Troll avatar name |
|
||
|
|
| `--color` | `-c` | `#047857` | Troll hex color |
|
||
|
|
| `--strength` | `-s` | `3.0` | Initial troll strength |
|
||
|
|
| `--health` | `-H` | `10.0` | Initial troll health points |
|
||
|
|
| `--project-id` | | `None` (auto-detected) | Google Cloud Project ID |
|
||
|
|
| `--location` | | `global` | Vertex AI region (e.g. `global`, `us-central1`) |
|
||
|
|
| `--model` | | `gemini-2.5-flash` | Gemini model name |
|
||
|
|
| `--api-key` | | `None` | Google AI Studio or Vertex API key |
|
||
|
|
| `--loop-delay` | | `1.0` | Turn polling loop delay in seconds |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 🚀 Invocation Example
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Using gcloud ADC authentication
|
||
|
|
gcloud auth application-default login
|
||
|
|
export VERTEX_PROJECT_ID="my-gcp-project"
|
||
|
|
|
||
|
|
python3 trollagent_gear/bot.py \
|
||
|
|
--name ApexTroll \
|
||
|
|
--color "#059669" \
|
||
|
|
--strength 5 \
|
||
|
|
--health 12 \
|
||
|
|
--url http://localhost:8000/api
|
||
|
|
```
|