Udviklingsmiljøet

Selve wi-fi-delen skal skrives i Python. Jeg bruger et forholdsvis klassisk macOS-setup med Homebrew, Python 3, Zsh og VS Code. I VS Code har jeg Python-udvidelsen med Pylance og OpenMonos egen extension. Projektfilerne ligger under følgende mappe i Dropbox:

~/Library/CloudStorage/Dropbox/Projects/

Dropbox synkroniserer kode, dokumentation, regler og de øvrige projektfiler. Hele scriptet og en kort brugsvejledning findes i appendikset. Jeg bruger et lille Zsh-script, mkpyproj, som opretter nye Python-projekter med den samme grundstruktur hver gang:

wifi-healthcheck-alpha/
+– .venv/
+– .vscode/
|   +– settings.json
+– src/
|   +– main.py
+– .gitignore
+– requirements.txt

Det virtuelle miljø oprettes med:

python3 -m venv .venv

VS Code er konfigureret til automatisk at bruge projektets interpreter:

{
“python.defaultInterpreterPath”: “${workspaceFolder}/.venv/bin/python”,
“python.terminal.activateEnvironment”: true,
“python.analysis.extraPaths”: [“${workspaceFolder}/src”]
}

Jeg har også lidt Zsh-logik, der automatisk aktiverer .venv, når jeg går ind i projektmappen, og deaktiverer miljøet igen, når jeg forlader den. En almindelig cd wifi-healthcheck-alpha giver derfor automatisk prompten (.venv), uden at jeg manuelt skal køre source .venv/bin/activate.

Hvor langt er projektet

På nuværende tidspunkt er fundamentet på plads:

Den næste komponent er den første rigtige del af      wi-fi-systemet: En Python-collector, der forbinder til en Cisco Catalyst 9800. Den første version bliver med vilje meget lille: én forbindelse, én controller og én kommando – eksempelvis show version.

Når det fungerer, begynder jeg gradvist at strukturere resultatet, hente flere data og bygge den rules engine, der senere skal sammenholde controllerens konfiguration med definerede wi-fi-best practices. Først derefter bliver AI-delen for alvor interessant.

Når en lokal agent har adgang til både strukturerede controllerdata og mine egne wi-fi-regler, kan jeg nemlig stille et mere nyttigt spørgsmål end: “Kan en LLM noget med wi-fi?” Spørgsmålet bliver i stedet, om klassisk netværksautomation, wi-fi-faglighed og lokale AI-agenter kan kombineres til et værktøj, der faktisk gør noget nyttigt.

Det er det, jeg vil forsøge at finde ud af. Fortsættelse følger.

Fortsættelsen er del 2: Et virtuelt WLC-lab fra bunden.

Publiceringsmetadata

Meta title: AI-agent til Wi-Fi-sundhedstjek på Cisco 9800 | Wingmen

Meta description: Følg arbejdet med en lokal AI-agent til Wi-Fi-sundhedstjek på Cisco Catalyst

9800. Python, lokal LLM og read-only adgang danner grundlaget for projektet.

Appendiks

Mit script til nye Pythonprojekter

Her er hele mkpyproj-scriptet, hvis du vil bruge samme projektstruktur. Det opretter et virtuelt Python-miljø, en lille main.py, VS Code-indstillinger, .gitignore og en tom requirements.txt. Jeg har samlet vejledningen her, så du kan komme i gang uden at hente noget fra et repository.

Du skal bruge macOS med Zsh og Python 3 tilgængelig i din PATH. VS Code er valgfrit. Scriptet installerer hverken Python eller VS Code og kræver ikke Git.

Gem og kør scriptet

Opret en mappe til scriptet, og åbn filen i terminaleditoren nano:

mkdir -p “$HOME/bin”
nano “$HOME/bin/mkpyproj”

Kopiér hele koden fra næste side, fra #!/usr/bin/env zsh til den sidste EOF, og indsæt den i nano. Gem med Ctrl+O, tryk Enter, og afslut med Ctrl+X. Filen skal være almindelig tekst uden .txt-endelse. Koden i dokumentet er tekst, ikke et billede; lange linjer kan være visuelt ombrudt.

Gør scriptet eksekverbart, og kontrollér syntaksen:

chmod +x “$HOME/bin/mkpyproj”
zsh -n “$HOME/bin/mkpyproj”

Hvis syntakskontrollen ikke skriver noget, er syntaksen accepteret. Opret derefter et projekt. Her vælger vi mappen eksplicit, så eksemplet også virker uden Dropbox:

“$HOME/bin/mkpyproj” –base “$HOME/Projects” \
wifi-healthcheck-alpha

Aktivér miljøet, og prøv den genererede Python-fil:

cd “$HOME/Projects/wifi-healthcheck-alpha”
source .venv/bin/activate
python src/main.py

Du bør få svaret “Hej, verden!”. Når du er færdig, kan du forlade miljøet med deactivate. Min automatiske aktivering ved cd ligger separat i .zshrc; den er ikke en del af dette script. Hvis ~/bin allerede er i din PATH, kan du skrive mkpyproj uden den fulde sti.

Placering og eksisterende filer

Uden –base bruger scriptet først MKPYPROJ_BASE, hvis variablen er sat. Ellers vælger det den eksisterende mappe ~/Library/CloudStorage/Dropbox/Projects og falder tilbage til ~/Projects. Brug –no-open, hvis VS Code ikke skal åbnes, og –help for at se mulighederne.

Eksisterende projektfiler bevares som udgangspunkt. –force overskriver src/main.py, .vscode/settings.json og .gitignore. Det overskriver hverken requirements.txt eller et eksisterende virtuelt miljø.

Dropbox-undtagelsen for .venv gælder kun under ~/Library/CloudStorage/Dropbox/ på macOS med File Provider. En anden sti valgt med –base bliver ikke automatisk genkendt som Dropbox. Kontrollér synkroniseringsstatus i Dropbox; .gitignore påvirker kun Git. Hvis attributten ikke kan sættes, skriver scriptet en advarsel og fortsætter.

Hele scriptet

#!/usr/bin/env zsh
# Til macOS med Zsh og Python 3. VS Code er valgfrit.
set -euo pipefail

usage() {
cat <<‘EOF’
mkpyproj – Opret et nyt Python-projekt med .venv, .vscode og mere.

Brug:
mkpyproj [options] <projektnavn>

Options:
-b, –base <dir>   Basis-mappe til projekter (default auto-detekteret).
Rækkefølge for auto-detect:
1) $MKPYPROJ_BASE (hvis sat)
2) ~/Library/CloudStorage/Dropbox/Projects
3) ~/Projects
–no-open          Åbn ikke i VS Code automatisk.
-f, –force        Overskriv eksisterende filer (.vscode/settings.json, main.py, .gitignore).
-h, –help         Vis hjælp.

Eksempel:
mkpyproj DNAC
mkpyproj -b “$HOME/Library/CloudStorage/Dropbox/Projects” AP

Dropbox:
Automatisk undtagelse af .venv gælder kun projekter under
~/Library/CloudStorage/Dropbox/ på macOS med File Provider.
Andre Dropbox-placeringer skal håndteres separat; –base ændrer
projektplaceringen, men ikke Dropbox-genkendelsen.
.gitignore styrer Git, ikke cloud-synkronisering.

Miljøet aktiveres manuelt med source .venv/bin/activate.
Automatisk aktivering ved cd kræver separat opsætning i din .zshrc.
EOF
}

# — Parse args —
BASE=”${MKPYPROJ_BASE:-}”
OPEN_VSCODE=1
FORCE=0
NAME=””

while [[ $# -gt 0 ]]; do
case “$1” in
-b|–base)
[[ $# -lt 2 ]] && { echo “Manglende argument til $1” >&2; usage; exit 2; }
[[ -z “$2” || “$2” == -* ]] && { echo “Ugyldig basis-mappe: $2″ >&2; exit 2; }
BASE=”$2”; shift 2;;
–no-open)
OPEN_VSCODE=0; shift;;
-f|–force)
FORCE=1; shift;;
-h|–help)
usage; exit 0;;
-*)
echo “Ukendt option: $1” >&2; usage; exit 2;;
*)
if [[ -z “$NAME” ]]; then
NAME=”$1″; shift
else
echo “Ukendt argument: $1” >&2; usage; exit 2
fi
;;
esac
done

[[ -z “$NAME” ]] && { echo “Angiv et projektnavn.” >&2; usage; exit 2; }
# Projektnavnet skal være én mappe, ikke en sti ud af basis-mappen.
if [[ “$NAME” == */* || “$NAME” == ‘.’ || “$NAME” == ‘..’ ]]; then
echo “Projektnavnet skal være et mappenavn uden / og må ikke være . eller ..” >&2
exit 2
fi

# — Find base dir —
if [[ -z “${BASE}” ]]; then
# Prøv Dropbox først, derefter ~/Projects. Bevar mellemrum i stier.
for p in \
“$HOME/Library/CloudStorage/Dropbox/Projects” \
“$HOME/Projects”
do
if [[ -d “$p” ]]; then BASE=”$p”; break; fi
done
: “${BASE:=”$HOME/Projects”}”
fi

# — Find python —
PY_BIN=””
if command -v python3 >/dev/null 2>&1; then
PY_BIN=”$(command -v python3)”
elif command -v python >/dev/null 2>&1; then
PY_BIN=”$(command -v python)”
else
echo “Kunne ikke finde python3 eller python i PATH.” >&2
echo “Installer Python via Homebrew:  brew install python” >&2
exit 1
fi
if ! “$PY_BIN” -c ‘import sys; sys.exit(0 if sys.version_info.major == 3 else 1)’; then
echo “Scriptet kræver Python 3.” >&2
exit 1
fi
echo “>> Bruger Python: $PY_BIN”

mkdir -p — “$BASE”
BASE=”${BASE:A}”
PROJ_DIR=”$BASE/$NAME”
echo “>> Opretter projekt under: $PROJ_DIR”
mkdir -p — “$PROJ_DIR/src” “$PROJ_DIR/.vscode”

# — Opret venv (kun hvis den ikke findes) —
if [[ ! -d “$PROJ_DIR/.venv” ]]; then
echo “>> Opretter .venv …”
“$PY_BIN” -m venv “$PROJ_DIR/.venv”
else
if [[ ! -x “$PROJ_DIR/.venv/bin/python” ]]; then
echo “Eksisterende .venv mangler en brugbar Python-interpreter; undersøg den manuelt.” >&2
exit 1
fi
echo “>> .venv findes allerede (springer over)”
fi

# — Undgå at Dropbox synkroniserer .venv —
if [[ “$PROJ_DIR” == “$HOME/Library/CloudStorage/Dropbox/”* ]]; then
if [[ “$OSTYPE” == darwin* ]] && command -v xattr >/dev/null 2>&1 &&
xattr -w ‘com.apple.fileprovider.ignore#P’ 1 “$PROJ_DIR/.venv”; then
echo “>> Ignore-attribut sat på .venv. Kontrollér sync-status i Dropbox.”
else
echo “ADVARSEL: .venv blev ikke undtaget fra Dropbox-sync. Kontrollér det manuelt.” >&2
fi
fi

# — .gitignore —
GITIGNORE_CONTENT=$’# Python\n.venv/\n__pycache__/\n*.pyc\n*.pyo\n*.pyd\n*.DS_Store\n.pytest_cache/\n’
if [[ ! -f “$PROJ_DIR/.gitignore” || $FORCE -eq 1 ]]; then
echo “>> Skriver .gitignore”
print -r — “$GITIGNORE_CONTENT” > “$PROJ_DIR/.gitignore”
else
echo “>> .gitignore findes (brug –force for at overskrive)”
fi

# — requirements.txt (opret tom, hvis ikke findes) —
if [[ ! -f “$PROJ_DIR/requirements.txt” ]]; then
echo “>> Opretter tom requirements.txt”
: > “$PROJ_DIR/requirements.txt”
fi

# — src/main.py —
MAIN_CONTENT=$’def main():\n    print(“Hej, verden!”)\n\n\nif __name__ == “__main__”:\n    main()\n’
if [[ ! -f “$PROJ_DIR/src/main.py” || $FORCE -eq 1 ]]; then
echo “>> Skriver src/main.py”
print -r — “$MAIN_CONTENT” > “$PROJ_DIR/src/main.py”
else
echo “>> src/main.py findes (brug –force for at overskrive)”
fi

# — .vscode/settings.json —
SETTINGS_PATH=”$PROJ_DIR/.vscode/settings.json”
SETTINGS_CONTENT=$(cat <<‘JSON’
{
“python.defaultInterpreterPath”: “${workspaceFolder}/.venv/bin/python”,
“python.terminal.activateEnvironment”: true,
“python.analysis.extraPaths”: [“${workspaceFolder}/src”]
}
JSON
)
if [[ ! -f “$SETTINGS_PATH” || $FORCE -eq 1 ]]; then
echo “>> Skriver .vscode/settings.json”
print -r — “$SETTINGS_CONTENT” > “$SETTINGS_PATH”
else
echo “>> .vscode/settings.json findes (brug –force for at overskrive)”
fi

# — Åbn i VS Code (hvis ønsket og tilgængelig) —
if [[ $OPEN_VSCODE -eq 1 ]]; then
if command -v code >/dev/null 2>&1; then
echo “>> Åbner i VS Code …”
(cd “$PROJ_DIR” && code . >/dev/null 2>&1 &)
else
echo “>> Tip: Installér ‘code’ CLI fra VS Code (Cmd+Shift+P -> Shell Command: Install ‘code’ command in PATH).”
fi
fi

cat <<EOF

Projekt klar: $PROJ_DIR

Næste skridt:
cd ${(q)PROJ_DIR}
source .venv/bin/activate
which python
python -m pip install -r requirements.txt  # hvis du har afhængigheder
python src/main.py

God fornøjelse!