Skip to main content

Advanced Integrations

This guide covers advanced integration scenarios and configurations for Gentic.

Advanced Knowledge Source Integrations​

Vector Databases​

const vectorSource = await client.createKnowledgeSource({
  name: 'Vector Database',
  type: 'vector-db',
  config: {
    provider: 'pinecone',
    apiKey: process.env.PINECONE_API_KEY,
    environment: 'us-west1-gcp',
    index: 'gentic-docs'
  }
});

Graph Databases​

const graphSource = await client.createKnowledgeSource({
  name: 'Neo4j Graph',
  type: 'neo4j',
  config: {
    uri: 'bolt://localhost:7687',
    username: 'neo4j',
    password: 'password',
    database: 'gentic'
  }
});

Advanced Workflow Integrations​

Event-Driven Workflows​

const eventWorkflow = await client.createWorkflow({
  name: 'Event Processing',
  trigger: {
    type: 'event',
    source: 'aws-sqs',
    config: {
      queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789012/gentic-events',
      region: 'us-east-1'
    }
  },
  steps: [
    {
      type: 'process_event',
      config: {
        event_type: '{{event.type}}',
        payload: '{{event.data}}'
      }
    }
  ]
});

Scheduled Workflows​

const scheduledWorkflow = await client.createWorkflow({
  name: 'Daily Report',
  trigger: {
    type: 'schedule',
    config: {
      cron: '0 9 * * *', // Every day at 9 AM
      timezone: 'America/New_York'
    }
  },
  steps: [
    {
      type: 'generate_report',
      config: {
        template: 'daily_summary',
        data_source: 'analytics_db'
      }
    }
  ]
});

Performance Optimization​

Caching Strategies​

const cachedSource = await client.createKnowledgeSource({
  name: 'Cached API',
  type: 'rest',
  config: {
    baseUrl: 'https://api.example.com',
    cache: {
      type: 'redis',
      ttl: 3600, // 1 hour
      maxSize: 1000
    }
  }
});

Batch Processing​

const batchWorkflow = await client.createWorkflow({
  name: 'Batch Processing',
  steps: [
    {
      type: 'batch',
      config: {
        size: 100,
        timeout: 300000 // 5 minutes
      },
      steps: [
        {
          type: 'process_item',
          input: '{{batch_item}}'
        }
      ]
    }
  ]
});

Security Considerations​

API Key Rotation​

const secureSource = await client.createKnowledgeSource({
  name: 'Secure API',
  type: 'rest',
  config: {
    baseUrl: 'https://api.example.com',
    auth: {
      type: 'api_key',
      rotation: {
        interval: '24h',
        gracePeriod: '1h'
      }
    }
  }
});

Data Encryption​

const encryptedSource = await client.createKnowledgeSource({
  name: 'Encrypted Storage',
  type: 's3',
  config: {
    bucket: 'secure-data',
    encryption: {
      type: 'kms',
      keyId: 'arn:aws:kms:us-east-1:123456789012:key/abcd1234'
    }
  }
});

Monitoring and Logging​

Custom Metrics​

const monitoredWorkflow = await client.createWorkflow({
  name: 'Monitored Process',
  steps: [
    {
      type: 'custom_metric',
      config: {
        name: 'processing_time',
        value: '{{execution_time}}',
        tags: ['workflow:monitored_process']
      }
    }
  ]
});

Structured Logging​

const loggedSource = await client.createKnowledgeSource({
  name: 'Logged API',
  type: 'rest',
  config: {
    baseUrl: 'https://api.example.com',
    logging: {
      level: 'info',
      format: 'json',
      fields: ['request_id', 'duration', 'status']
    }
  }
});

Next Steps​