Plugin SDK

Bauen Sie leistungsstarke Plugins für Adverant Nexus mit unserem umfassenden SDK

Installation

TypeScript/JavaScript

npm install @adverant-nexus/sdk

Das SDK ist kompatibel mit Node.js 18+ und enthält TypeScript-Definitionen.

Python

pip install adverant-nexus-sdk

Das Python SDK erfordert Python 3.9 oder höher.

Kernkonzepte

Plugin-Architektur

Plugins erweitern Nexus über das Model Context Protocol (MCP) und stellen Tools, Ressourcen und Prompts bereit, die KI-Agenten entdecken und nutzen können.

  • Tools: Funktionen, die Aktionen ausführen (z.B. Daten analysieren, E-Mails senden)
  • Ressourcen: Datenquellen, die Plugins bereitstellen (z.B. Datenbanken, APIs)
  • Prompts: Vorkonfigurierte Prompts für gängige Workflows

Nexus Client

Der Nexus Client bietet Zugang zu den Kern-Plattformdiensten:

import { NexusClient } from '@adverant-nexus/sdk'

const nexus = new NexusClient({
  apiKey: process.env.BRAIN_API_KEY
})

// Access GraphRAG memory
await nexus.graphrag.storeMemory({
  content: 'Important information',
  tags: ['customer', 'analysis']
})

// Orchestrate sub-agents
await nexus.agents.orchestrate({
  task: 'Analyze customer feedback',
  agents: ['sentiment', 'summarization']
})

API-Referenz

Plugin-Server erstellen

import { NexusPluginServer, Tool } from '@adverant-nexus/sdk/server'

const server = new NexusPluginServer({
  name: 'my-plugin',
  version: '1.0.0',
  description: 'My awesome plugin'
})

// Define a tool
server.tool(new Tool({
  name: 'analyze_data',
  description: 'Analyzes data and returns insights',
  inputSchema: {
    type: 'object',
    properties: {
      data: { type: 'array' },
      options: { type: 'object' }
    },
    required: ['data']
  },
  execute: async (input) => {
    // Your implementation
    return { insights: [...] }
  }
}))

// Start the server
await server.start()

Auf Nexus-Dienste zugreifen

// GraphRAG Memory
await nexus.graphrag.storeMemory({ content, tags })
await nexus.graphrag.query({ query, limit: 10 })

// Agent Orchestration
await nexus.agents.orchestrate({ task, agents })

// Learning System
await nexus.learning.recordPattern({ pattern, feedback })

Beispiele

Einfaches Plugin-Beispiel

Ein einfaches Plugin, das ein Begrüßungs-Tool bereitstellt:

import { NexusPluginServer, Tool } from '@adverant-nexus/sdk/server'

const server = new NexusPluginServer({
  name: 'greeter',
  version: '1.0.0'
})

server.tool(new Tool({
  name: 'greet',
  description: 'Greets a user by name',
  inputSchema: {
    type: 'object',
    properties: {
      name: { type: 'string' }
    },
    required: ['name']
  },
  execute: async ({ name }) => {
    return { message: `Hello, ${name}!` }
  }
}))

await server.start()

Nächste Schritte