docs(agent): Implement stale issue bot

Merge https://github.com/google/adk-python/pull/3546 Co-authored-by: Xuan Yang <xygoogle@google.com> COPYBARA_INTEGRATE_REVIEW=https://github.com/google/adk-python/pull/3546 from ryanaiagent:feat/stale-issue-agent bcf45098c1c6406b4a42228e4a8ef02f12840425 PiperOrigin-RevId: 835327931
2026-07-09 18:19:28 -07:00 · 2025-11-21 12:54:20 -08:00
parent 5583bb819b
commit 23f1d8914a
8 changed files with 793 additions and 0 deletions
@@ -0,0 +1,57 @@
+# .github/workflows/stale-issue-auditor.yml
+
+# Best Practice: Always have a 'name' field at the top.
+name: ADK Stale Issue Auditor
+
+# The 'on' block defines the triggers.
+on:
+  # The 'workflow_dispatch' trigger allows manual runs.
+  workflow_dispatch:
+
+  # The 'schedule' trigger runs the bot on a timer.
+  schedule:
+    # This runs at 6:00 AM UTC (e.g., 10 PM PST).
+    - cron: '0 6 * * *'
+
+# The 'jobs' block contains the work to be done.
+jobs:
+  # A unique ID for the job.
+  audit-stale-issues:
+    # The runner environment.
+    runs-on: ubuntu-latest
+
+    # Permissions for the job's temporary GITHUB_TOKEN.
+    # These are standard and syntactically correct.
+    permissions:
+      issues: write
+      contents: read
+
+    # The sequence of steps for the job.
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        # The '|' character allows for multi-line shell commands.
+        run: |
+          python -m pip install --upgrade pip
+          pip install requests google-adk
+
+      - name: Run Auditor Agent Script
+        # The 'env' block for setting environment variables.
+        env:
+          GITHUB_TOKEN: ${{ secrets.ADK_TRIAGE_AGENT }}
+          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
+          OWNER: google
+          REPO: adk-python
+          ISSUES_PER_RUN: 100
+          LLM_MODEL_NAME: "gemini-2.5-flash"
+          PYTHONPATH: contributing/samples
+
+        # The final 'run' command.
+        run: python -m adk_stale_agent.main