White-Label
KI-Plattform
für Agenturen

return [
    'tools.createVoucher' => [
        'description' => 'Erstelle einen Rabattcode im Shopify-Shop',
        'api'         => 'shopify',
        'endpoint'    => 'price_rules/{ruleId}/discount_codes.json',
        'method'      => 'POST',
        'body'        => [
            'discount_code' => [
                'code' => '{code}',
            ],
        ],
        'preprocess' => function($args, $ctx) {
            // Regel anlegen, ruleId zurückgeben
            $rule = $ctx['tool']('createPriceRule', [
                'value' => $args['value'],
                'code'  => $args['code'],
            ]);
            return ['ruleId' => $rule['id']];
        },
        'parameters' => [
            'type' => 'object',
            'properties' => [
                'code'  => ['type' => 'string', 'description' => 'z.B. NEUKUNDE10'],
                'value' => ['type' => 'number', 'description' => 'Rabatt in Euro'],
            ],
        ],
    ],
];

return [
    'tools.processDeliveryNote' => [
        'description'    => 'Lieferschein-Foto analysieren und Wareneingang buchen',
        'internal'       => true,
        'statusMessages' => ['Lieferschein wird analysiert...', 'Positionen werden gebucht...'],

        'handler' => function($results, $args, $ctx) {
            $logger = $ctx['logger'];

            // 1. Bild per Vision-API analysieren
            $logger->info('Lieferschein wird analysiert...');
            $items = $ctx['tool']('analyzeImage', [
                'image'  => $args['image_url'],
                'prompt' => 'Extrahiere alle Positionen mit Menge und Artikel',
            ]);

            // 2. Jede Position im ERP buchen
            $booked = 0;
            foreach ($items['positions'] as $pos) {
                $ctx['tool']('bookStockMovement', [
                    'sku' => $pos['sku'], 'qty' => $pos['quantity'],
                ]);
                $booked++;
            }

            $logger->success($booked . ' Positionen eingebucht');
            return $logger->complete(['booked' => $booked]);
        },

        'parameters' => [
            'type' => 'object',
            'properties' => [
                'image_url' => ['type' => 'string', 'description' => 'URL des Lieferschein-Fotos'],
            ],
            'required' => ['image_url'],
        ],
    ],
];

'handler' => function($results, $args, $ctx) {
    $logger = $ctx['logger'];

    // Kontext aus dem Kundenchat sammeln
    $context = [
        'customer' => $args['customer_name'],
        'order'    => $args['order_number'],
        'issue'    => $args['issue_summary'],
        'tone'     => $args['customer_tone'],
        'history'  => $ctx['chatHistory'],
    ];

    // Monkey Task mit situativen Tools
    $task = $ctx['tool']('createMonkeyTask', [
        'type'    => 'Reklamation',
        'context' => $context,
        'tools'   => ['createVoucher', 'lookupOrder',
                    'sendMail', 'processRefund'],
        'assign'  => 'kundenservice',
    ]);

    return ['task_id' => $task['id'], 'status' => 'escalated'];
},

'daily_report' => [
    'enabled'  => true,
    'interval' => '24h',
    'time'     => '07:00',
    'tool'     => 'sendDailyReport',
    'args'     => [
        'sources' => ['shopify', 'erp', 'finapi'],
        'recipients' => ['gf@kunde.de'],
        'format' => 'html_mail',
    ],
],

'sync_orders' => [
    'enabled'  => true,
    'interval' => '5min',
    'tool'     => 'processNewOrders',
],

'check_vouchers' => [
    'enabled'  => true,
    'interval' => '24h',
    'tool'     => 'syncVouchersToSheet',
],

return [
    'email_address' => 'rechnungen@meco-ops.de',

    'email_prompt' => 'Du verarbeitest eingehende Rechnungen. '
        . '1. Extrahiere Rechnungsnummer, Betrag, Datum, Lieferant. '
        . '2. Schreibe die Daten ins Google Sheet. '
        . '3. Speichere das PDF in Dropbox. '
        . '4. Prüfe ob eine passende Bankbuchung existiert.',

    'email_tools' => [
        'extractInvoiceData',
        'writeToSheet',
        'uploadToDropbox',
        'matchBankTransaction',
    ],
];

// Ein Tenant = ein Ordner. Alles konventionsbasiert.

config/tenants/client_shop/
├── tenant.php              // Name, Model, Widget-Theme, Accent-Color
├── apis.php                // Shopify, ERP, FinAPI — Credentials + Base-URLs
├── prompts/
│   ├── system.php          // Persönlichkeit + Verhalten der KI
│   ├── reminder.php        // Vor jeder User-Nachricht injiziert
│   ├── first_message.php   // Begrüßung beim Chat-Start
│   └── suggestions.php     // Buttons nach der ersten Nachricht
├── widget/
│   ├── config.php          // Theme, Position, CSS-Overrides
│   ├── qr_scanner.php      // QR/Barcode-Scanner aktivieren
│   └── voice_input.php     // Spracheingabe aktivieren
├── tools/
│   ├── shop/
│   │   ├── getOrders.php       // API-only: Endpoint + Mapping
│   │   ├── createVoucher.php   // preprocess + API
│   │   └── processRefund.php   // Handler mit Tool Chaining
│   ├── warehouse/
│   │   ├── findProduct.php
│   │   ├── updateStock.php
│   │   └── processDeliveryNote.php  // Vision + Multi-Step
│   └── support/
│       ├── createInternalTask.php   // Human Handoff
│       └── sendMail.php
├── monkey_tasks/
│   ├── warehouse.php       // Lager: Scanner, Bestände, Bewegungen
│   ├── accounting.php      // Buchhaltung: Rechnungen, Bankabgleich
│   └── customerservice.php // Reklamationen mit situativen Tools
├── scheduled_tasks.php     // Cronjobs: Sync, Reports, Prüfungen
├── email.php               // Eigene Adresse + Verarbeitungs-Prompt
└── test_cases.php          // Fixtures für bin/cake test_tool

return [
    'dashboard' => [
        'kpis' => [
            ['label' => 'Umsatz heute',   'tool' => 'getRevenue',     'format' => 'currency'],
            ['label' => 'Offene Orders',  'tool' => 'countOpenOrders', 'format' => 'number'],
            ['label' => 'Kontostand',     'tool' => 'getBalance',     'format' => 'currency'],
            ['label' => 'Retouren-Quote', 'tool' => 'getReturnRate',  'format' => 'percent'],
        ],
        'charts' => [
            [
                'label'  => 'Umsatz 30 Tage',
                'source' => 'google_sheet',
                'sheet'  => 'KPIs',
                'range'  => 'A:B',
                'type'   => 'line',
                'compare' => 'previous_year',
            ],
        ],
        'refresh' => '5min',
    ],
];

return [
    'apis' => [
        'shopify' => [
            'base_url' => 'https://{shop}.myshopify.com/admin/api/2024-01/',
            'auth'     => 'header',
            'token'    => env('SHOPIFY_TOKEN'),
        ],
        'erp_internal' => [
            'base_url' => 'https://erp.kunde.de/api/v2/',
            'auth'     => 'basic',
            'user'     => env('ERP_USER'),
            'pass'     => env('ERP_PASS'),
        ],
        'finapi' => [
            'base_url' => 'https://live.finapi.io/api/v2/',
            'auth'     => 'oauth2',
            'flow'     => 'client_credentials',
        ],
        'google_sheets' => [
            'auth' => 'oauth2',
            'flow' => 'refresh_token',  // Login-Button im Backend
        ],
    ],
];