Docs: update Discord agent configuration and fix syntax issues

- Update AGENTS.md with current Discord agent configuration
  - Add discord-agent service details
  - Update storage structure to include discord-agent directory
- Update README.md Discord agent integration section
  - Correct LLM configuration from OpenCode to Ollama
  - Update environment variables and configuration details
  - Fix storage structure documentation
- Update RESTORE.md Discord agent restoration steps
  - Correct service configuration for Ollama integration
  - Add proper troubleshooting steps
  - Update environment variable documentation
- Fix docker-compose.yaml Discord agent environment variables
  - Add DISCORD_BOT_TOKEN, OLLAMA_ENDPOINT, OLLAMA_MODEL
  - Correct database and network configuration
- Add AGENTS.md to .gitignore tracked files
- Remove old discord agent versions and test files
- Create working discord_agent.py and health_check.py
This commit is contained in:
Jamie Miller
2026-02-06 04:34:43 +00:00
parent 5029b13f02
commit a3f6855f32
5 changed files with 398 additions and 58 deletions

View File

@@ -17,19 +17,102 @@ If you are restoring, follow the standard restoration steps below, and refer to
- Access to NAS storage (if applicable)
- Root or sudo access
## Step 1: Extract Backup
## Discord Agent Service
### Step 1: Create Discord Agent Directory
```bash
# Navigate to your backup location
cd /path/to/backups
# Extract the backup archive
tar xzf docker-backup-YYYYMMDD_HHMMSS.tar.gz
# Navigate into the extracted backup
cd YYYYMMDD_HHMMSS
mkdir -p /docker/discord-agent/config /docker/discord-agent/data/logs /docker/discord-agent/data/database /docker/discord-agent/data/cache /docker/discord-agent/cogs /docker/discord-agent/scripts
```
### Step 2: Copy Configuration Files
```bash
# Copy agent configuration
cp agent-config.yaml /docker/discord-agent/config/
cp permissions.json /docker/discord-agent/config/
# Copy scripts
cp startup.sh /docker/discord-agent/scripts/
cp health_check.sh /docker/discord-agent/scripts/
```
### Step 3: Copy Python Files
```bash
cp discord_agent.py /docker/discord-agent/
cp base_cog.py /docker/discord-agent/cogs/
cp integration_cog.py /docker/discord-agent/cogs/
```
### Step 4: Copy Requirements
```bash
cp requirements.txt /docker/discord-agent/
cp Dockerfile /docker/discord-agent/
```
### Step 5: Update Environment Variables
Add these to your `.env` file:
```bash
# Discord Agent
DISCORD_BOT_TOKEN=your_discord_bot_token_here
OLLAMA_ENDPOINT=http://192.168.0.31:11434
OLLAMA_MODEL=mistral-3:8b
TZ=Pacific/Auckland
```
### Step 6: Update Configuration
Edit `/docker/discord-agent/config/agent-config.yaml` with your specific settings:
```yaml
discord:
token: ${DISCORD_BOT_TOKEN}
prefix: "!"
status: "AI Assistant | !help"
ollama:
endpoint: "${OLLAMA_ENDPOINT:http://192.168.0.31:11434}"
model: "${OLLAMA_MODEL:mistral-3:8b}"
parameters:
temperature: 0.7
top_p: 0.9
top_k: 40
timeout: 60
```
### Step 7: Build and Start Service
```bash
# Build the Discord agent image
docker compose build discord-agent
# Start the service
docker compose up -d discord-agent
# Verify the service is running
docker compose logs discord-agent
```
### Step 8: Verify Integration
```bash
# Check Discord bot connection
docker exec discord-agent python3 -c "import discord; print('Discord library available')"
# Check Ollama connection
curl http://192.168.0.31:11434/api/tags
# Check MySQL database
docker compose exec agent-db mysql -u agent -pagent -e "SHOW DATABASES;"
```
### Step 9: Test Bot Functionality
- The bot should appear in your Discord server
- Test with `!help` command to verify functionality
- Test with `!agent <message>` to verify Ollama integration
- Test with `!status` to check bot status
### Troubleshooting
- If bot doesn't start, check logs: `docker compose logs discord-agent`
- Verify DISCORD_BOT_TOKEN is set correctly in `.env` file
- Ensure Ollama is running and accessible at the configured endpoint
- Verify internal_net and db_net networks are available
- Check that MySQL database agent-db is running and healthy
## Step 2: Restore Directory Structure
```bash