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:
101
RESTORE.md
101
RESTORE.md
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user