Operations Manual

1. 1

   Visit OpenAI Platform

   Go to https://platform.openai.com and create an account or log in.

2. 2

   Add Payment Method

   Go to Settings → Billing → Add payment method. You need credits to use the API.

3. 3

   Create API Key

   Go to API Keys → Create new secret key. Copy and save it securely (you'll need it for the backend).

1. 1

   Visit Railway

   Go to https://railway.app and sign up with GitHub.

2. 2

   Create New Project

   Click "New Project" → "Empty Service" to create a new project.

3. 3

   Add Environment Variables

   Go to Variables tab → Add OPENAI_API_KEY with your OpenAI key.

1. 1

   Visit Replit

   Go to https://replit.com and sign up.

2. 2

   Create New Repl

   Click "+ Create" → Select "Node.js" template → Name it "ai-agent-backend".

3. 3

   Add Secret

   Click Secrets (lock icon) → New Secret → Add OPENAI_API_KEY.

// Storage Key: 'aiAgents'
// Stored in localStorage as JSON string

Agent Object:
{
  id: "agent_1707000000000_abc123def",    // Unique identifier (timestamp + random)
  name: "Customer Support Bot",            // User-defined agent name
  role: "support",                         // support | sales | operations | admin
  description: "Handles customer inquiries...", // User-defined description
  tone: "friendly",                        // friendly | professional | direct
  status: "active",                        // active | draft
  createdAt: 1707000000000,               // Unix timestamp in milliseconds
  updatedAt: 1707000000000                 // Unix timestamp in milliseconds
}

// Storage Key: 'aiAgentFiles'
// Stored in localStorage as JSON string

File Object:
{
  id: "agent_1707000000000_file123",      // Unique identifier
  agentName: "Customer Support Bot",        // Name of agent that generated file
  agentRole: "support",                     // Role of agent
  filename: "support-output-1707000000000.txt", // Auto-generated filename
  content: "Agent Execution Report\n...",   // Full text content
  wordCount: 350,                           // Number of words in content
  timestamp: 1707000000000,                // Unix timestamp
  type: "support"                           // Same as agent role
}

Get Agents

function getAgents() {
  const stored = localStorage.getItem('aiAgents')
  return stored ? JSON.parse(stored) : []
}

Save Agents

function saveAgents(agents) {
  localStorage.setItem('aiAgents', JSON.stringify(agents))
}

Create New Agent

function createAgent(formData) {
  const agent = {
    id: generateId(),  // "agent_" + Date.now() + "_" + random string
    name: formData.get('agentName'),
    role: formData.get('role'),
    description: formData.get('agentDescription'),
    tone: formData.get('tone'),
    status: 'draft',
    createdAt: Date.now(),
    updatedAt: Date.now(),
  }
  
  const agents = getAgents()
  agents.unshift(agent)  // Add to beginning of array
  saveAgents(agents)
  
  renderAgents()  // Update UI
}

const express = require('express');
const cors = require('cors');
const OpenAI = require('openai');

const app = express();
const PORT = process.env.PORT || 3000;

// Middleware
app.use(cors());
app.use(express.json());

// Initialize OpenAI with API key from environment
const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY
});

// ============================================
// API ENDPOINTS
// ============================================

// Health check endpoint
app.get('/health', (req, res) => {
  res.json({
    status: 'OK',
    message: 'AI Agent Backend is running',
    timestamp: new Date().toISOString()
  });
});

// Root endpoint
app.get('/', (req, res) => {
  res.json({
    message: 'AI Agent Backend API',
    version: '1.0.0',
    endpoints: {
      health: '/health',
      chat: '/api/chat (POST)'
    }
  });
});

// Main chat endpoint - processes agent requests
app.post('/api/chat', async (req, res) => {
  try {
    const { systemPrompt, userMessage, agentRole } = req.body;

    // Validate required fields
    if (!systemPrompt || !userMessage) {
      return res.status(400).json({ 
        error: 'Missing required fields: systemPrompt and userMessage' 
      });
    }

    // Check if API key is configured
    if (!process.env.OPENAI_API_KEY) {
      return res.status(500).json({ 
        error: 'OpenAI API key not configured on server' 
      });
    }

    // Call OpenAI API
    const completion = await openai.chat.completions.create({
      model: 'gpt-4',
      messages: [
        { role: 'system', content: systemPrompt },
        { role: 'user', content: userMessage }
      ],
      temperature: 0.7,
      max_tokens: 1000
    });

    // Extract response
    const response = completion.choices[0].message.content;

    // Return successful response
    res.json({
      response: response,
      model: completion.model,
      usage: completion.usage,
      agentRole: agentRole
    });

  } catch (error) {
    console.error('OpenAI API Error:', error);
    res.status(500).json({ 
      error: 'Failed to generate response',
      details: error.message 
    });
  }
});

// Start server
app.listen(PORT, '0.0.0.0', () => {
  console.log(`Server running on port ${PORT}`);
});