Platform Integration

Connect the SDK to the AgenticWork platform for full enterprise features.

Overview

Platform integration provides:

• Authentication and authorization

• Role-based access control (RBAC)

• MCP tool servers

• Flowise workflows

• Workspace management

• Telemetry and observability

• Session persistence

Initialization

Token Authentication

import { AgenticWork } from '@agentic-work/sdk';

const aw = new AgenticWork({
  apiEndpoint: 'https://api.agenticwork.io',
  authToken: process.env.AGENTICWORK_TOKEN
});

await aw.init();

console.log('User:', aw.user?.email);
console.log('Admin:', aw.user?.isAdmin);

OAuth Client Credentials

const aw = new AgenticWork({
  apiEndpoint: 'https://api.agenticwork.io',
  clientId: process.env.CLIENT_ID,
  clientSecret: process.env.CLIENT_SECRET
});

await aw.init();

Admin Impersonation

const aw = new AgenticWork({
  apiEndpoint: 'https://api.agenticwork.io',
  authToken: process.env.ADMIN_TOKEN,
  impersonateUserId: 'target-user-id'  // Admin only
});

await aw.init();

User Information

// Access user after init
const user = aw.user;

if (user) {
  console.log('ID:', user.id);
  console.log('Email:', user.email);
  console.log('Name:', user.name);
  console.log('Admin:', user.isAdmin);
  console.log('Groups:', user.groups);
  console.log('Permissions:', user.permissions);
}

Permission Checking

// Check specific permission
if (aw.can('manage_workflows')) {
  // User can manage workflows
}

if (aw.can('execute_code')) {
  // User can execute code
}

// Check group membership
const platform = aw.getPlatform();
if (platform.isInGroup('developers')) {
  // User is in developers group
}

if (platform.isInGroup('admins')) {
  // User is admin
}

MCP Tool Servers

List Servers

const servers = await aw.getMCPServers();

for (const server of servers) {
  console.log(`${server.name}: ${server.status}`);
  console.log(`  Tools: ${server.tools.length}`);
  console.log(`  Description: ${server.description}`);
}

Get All Tools

const tools = aw.getMCPTools();
console.log(`Available tools: ${tools.length}`);

// Filter by server
const webTools = tools.filter(t => t.name.startsWith('awp_web'));

Execute Tool Directly

const result = await aw.executeMCPTool(
  'awp_web',           // Server name
  'search',            // Tool name
  { query: 'AI news' } // Arguments
);

console.log('Result:', result);

Flowise Workflows

List Workflows

const workflows = await aw.listWorkflows();

for (const workflow of workflows) {
  console.log(`${workflow.name} (${workflow.id})`);
  console.log(`  Deployed: ${workflow.deployed}`);
  console.log(`  Category: ${workflow.category}`);
}

Create Workflow

const workflow = await aw.createWorkflow({
  name: 'Data Processor',
  description: 'Process incoming data',
  category: 'automation',
  flowData: {
    // Flowise flow definition
    nodes: [...],
    edges: [...],
    viewport: { x: 0, y: 0, zoom: 1 }
  }
});

console.log('Created workflow:', workflow.id);

Execute Workflow

const result = await aw.executeWorkflow(workflow.id, {
  input: 'Process this data',
  parameters: { format: 'json' }
});

console.log('Workflow result:', result);

Update Workflow

const platform = aw.getPlatform();

await platform.updateWorkflow(workflow.id, {
  name: 'Updated Name',
  description: 'New description',
  flowData: { /* updated flow */ }
});

Delete Workflow

const platform = aw.getPlatform();
await platform.deleteWorkflow(workflow.id);

Workspaces

List Workspaces

const workspaces = await aw.listWorkspaces();

for (const ws of workspaces) {
  console.log(`${ws.name} (${ws.id})`);
  console.log(`  Path: ${ws.path}`);
  console.log(`  Created: ${ws.createdAt}`);
}

Create Workspace

const workspace = await aw.createWorkspace('My Project');
console.log('Created:', workspace.id);

Get Workspace Details

const platform = aw.getPlatform();
const workspace = await platform.getWorkspace('workspace-id');

Model Discovery

const models = await aw.listModels();

for (const model of models) {
  console.log(`${model.name} (${model.provider})`);
  console.log(`  ID: ${model.id}`);
  console.log(`  Max tokens: ${model.maxTokens}`);
  console.log(`  Tools: ${model.supportsTools}`);
  console.log(`  Vision: ${model.supportsVision}`);
}

Telemetry

Log Custom Events

const platform = aw.getPlatform();

await platform.logEvent({
  type: 'custom_action',
  data: {
    action: 'user_signup',
    source: 'sdk',
    metadata: { ... }
  }
});

Log Tool Execution Metrics

await platform.logToolExecution({
  toolName: 'database_query',
  duration: 1500,  // ms
  success: true
});

// On failure
await platform.logToolExecution({
  toolName: 'api_call',
  duration: 5000,
  success: false,
  error: 'Timeout'
});

Direct Provider Access

The platform provides configured providers:

const platform = aw.getPlatform();

// Get all providers
const providers = platform.getProviders();

// Get provider for specific model
const provider = platform.getProviderForModel('gpt-4o');

if (provider) {
  const response = await provider.complete({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Hello' }]
  });
}

AgentiCode Configuration

For CLI tools:

const platform = aw.getPlatform();
const config = await platform.getAgenticodeConfig();

console.log('Providers:', config.providers.length);
console.log('Models:', config.models.length);
console.log('Default model:', config.defaultModel);
console.log('MCP servers:', config.mcpServers);
console.log('Flowise enabled:', config.flowiseEnabled);

Error Handling

try {
  await aw.init();
} catch (error) {
  if (error.message.includes('authentication')) {
    console.error('Invalid credentials');
  } else if (error.message.includes('network')) {
    console.error('Cannot reach platform');
  } else {
    console.error('Init failed:', error.message);
  }
}

Environment Variables

# Platform endpoint
AGENTICWORK_API_ENDPOINT=https://api.agenticwork.io

# Authentication (one of these)
AGENTICWORK_TOKEN=your-jwt-or-api-key
AGENTICWORK_CLIENT_ID=oauth-client-id
AGENTICWORK_CLIENT_SECRET=oauth-client-secret