This comprehensive guide walks you through setting up Context’s enterprise APIs, including Context Engine integration and Background Agent deployment for your organization.
Context Enterprise services are available exclusively to enterprise customers. Contact enterprise@context.ai to begin your setup process.

Getting Started

Enterprise Onboarding Process

Before you can begin technical setup, you’ll need to complete our enterprise onboarding process:
1

Initial Consultation

Contact our enterprise team at enterprise@context.ai to discuss your requirements and use cases
2

Requirements Assessment

Our team will work with you to assess your integration needs, security requirements, and deployment preferences
3

Contract & SLA Agreement

Finalize enterprise agreement including SLA terms, security requirements, and support levels
4

Technical Setup

Receive enterprise credentials and begin technical integration following this guide

Prerequisites

Technical Requirements

Infrastructure

  • Compute: 8+ CPU cores, 16GB+ RAM
  • Storage: 500GB+ SSD storage
  • Network: Stable internet, 100+ Mbps
  • SSL: Valid certificates for HTTPS endpoints

Security

  • Domain: Dedicated subdomain for API endpoints
  • Firewall: Outbound HTTPS (port 443) access
  • Authentication: Enterprise SSO integration
  • Encryption: TLS 1.3 for all communications

Software Dependencies

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Authentication Setup

Enterprise API Keys

Once your enterprise account is provisioned, you’ll receive enterprise API credentials: JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

JWT Token Generation

Authenticate with Context Enterprise APIs using JWT tokens:
async function getEnterpriseToken() {
  const response = await fetch('https://api.context.ai/v1/auth/enterprise/token', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.CONTEXT_API_KEY
    },
    body: JSON.stringify({
      grant_type: 'client_credentials',
      client_id: process.env.CONTEXT_ENTERPRISE_ORG_ID,
      client_secret: process.env.CONTEXT_API_SECRET,
      scope: 'context-engine:read context-engine:write background-agents:read background-agents:write'
    })
  });

  const { access_token, expires_in } = await response.json();
  
  // Store token securely for reuse
  return {
    token: access_token,
    expiresAt: Date.now() + (expires_in * 1000)
  };
}

SSO Integration

Context Enterprise supports integration with your existing SSO providers:

Okta Integration

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Azure AD Integration

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Context Engine Setup

Basic Configuration

Set up Context Engine access for your enterprise:
const ContextEngine = require('@context-ai/context-engine-sdk');

const contextEngine = new ContextEngine({
  apiKey: process.env.CONTEXT_API_KEY,
  organizationId: process.env.CONTEXT_ENTERPRISE_ORG_ID,
  environment: 'production',
  timeout: 30000,
  retryAttempts: 3
});

// Test connection
async function testContextEngine() {
  try {
    const health = await contextEngine.health.check();
    console.log('Context Engine connection successful:', health);
  } catch (error) {
    console.error('Context Engine connection failed:', error);
  }
}

testContextEngine();

Data Source Integration

Configure your enterprise data sources with Context Engine:
async function setupDataSources() {
  // Configure financial data integration
  await contextEngine.dataSources.create({
    name: "enterprise_financial_data",
    type: "database",
    connection: {
      type: "postgresql",
      host: "your-db-host.com",
      port: 5432,
      database: "financial_data",
      username: "${DB_USERNAME}",
      password: "${DB_PASSWORD}",
      ssl: true
    },
    indexing_schedule: "0 2 * * *", // Daily at 2 AM
    security: {
      encryption_at_rest: true,
      access_control: "role_based"
    }
  });

  // Configure document repository
  await contextEngine.dataSources.create({
    name: "corporate_documents",
    type: "sharepoint",
    connection: {
      tenant_id: "${SHAREPOINT_TENANT_ID}",
      client_id: "${SHAREPOINT_CLIENT_ID}",
      client_secret: "${SHAREPOINT_CLIENT_SECRET}",
      site_url: "https://yourcompany.sharepoint.com/sites/corporate"
    },
    indexing_options: {
      file_types: ["pdf", "docx", "xlsx", "pptx"],
      extract_metadata: true,
      ocr_enabled: true
    }
  });

  console.log('Data sources configured successfully');
}

Background Agent Deployment

Docker-based Deployment

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Configuration Management

Create comprehensive configuration for enterprise deployment: JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Networking and Security

SSL Certificate Setup

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Firewall Configuration

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Testing and Validation

Health Check Verification

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Integration Test

Run comprehensive integration tests:
// test/integration.test.js
const test = require('ava');
const ContextEnterprise = require('@context-ai/enterprise-sdk');

const client = new ContextEnterprise({
  apiKey: process.env.CONTEXT_API_KEY,
  organizationId: process.env.CONTEXT_ENTERPRISE_ORG_ID,
  environment: 'production'
});

test('Context Engine query integration', async t => {
  const response = await client.contextEngine.query({
    query: "Test integration query",
    sources: ["test_data"],
    processing_mode: "fast"
  });

  t.is(response.status, 'completed');
  t.truthy(response.results);
});

test('Background Agent task submission', async t => {
  const task = await client.backgroundAgents.submitTask({
    task_type: "research_agent",
    priority: 5,
    input: {
      query: "Test task submission",
      sources: ["test_data"]
    }
  });

  t.truthy(task.task_id);
  t.is(task.status, 'accepted');
});

test('WebSocket connection', async t => {
  const ws = await client.backgroundAgents.connectWebSocket();
  
  return new Promise((resolve) => {
    ws.on('authenticated', () => {
      t.pass('WebSocket authentication successful');
      ws.close();
      resolve();
    });
    
    ws.on('error', (error) => {
      t.fail(`WebSocket connection failed: ${error}`);
      resolve();
    });
  });
});

Monitoring and Observability

Prometheus Metrics Configuration

JavaScript SDK is available exclusively for enterprise customers. Contact enterprise@context.ai

Grafana Dashboard Configuration

{
  "dashboard": {
    "title": "Context Enterprise Monitoring",
    "panels": [
      {
        "title": "Background Agent Task Throughput",
        "type": "graph",
        "targets": [
          {
            "expr": "rate(background_agent_tasks_completed_total[5m])",
            "legendFormat": "Tasks/sec"
          }
        ]
      },
      {
        "title": "Context Engine Response Time",
        "type": "graph",
        "targets": [
          {
            "expr": "histogram_quantile(0.95, rate(context_engine_request_duration_seconds_bucket[5m]))",
            "legendFormat": "95th percentile"
          }
        ]
      }
    ]
  }
}

Production Deployment Checklist

Troubleshooting

Common Issues

Support and Maintenance

Enterprise Support Channels

Maintenance Windows

  • Scheduled Maintenance: First Sunday of each month, 2-4 AM UTC
  • Emergency Patches: As needed with 24-hour notice
  • Version Updates: Quarterly with 2-week notice

Next Steps