Skill Pack SDK Documentation

my-skill-pack/
├── manifest.yaml          # Metadata, permissions, triggers
├── src/
│   ├── index.ts           # Entrypoint — handler utama
│   ├── handlers/          # Handler per trigger type
│   │   ├── keyword.ts     # Handler untuk keyword trigger
│   │   ├── intent.ts      # Handler untuk intent trigger
│   │   └── schedule.ts    # Handler untuk scheduled trigger
│   └── utils/             # Helper functions
│       └── api-client.ts  # HTTP client wrapper
├── tests/
│   ├── unit.test.ts       # Unit tests
│   └── integration.test.ts # Integration tests (sandbox)
├── conai.config.ts        # SDK configuration
├── package.json
└── README.md

# manifest.yaml
name: isp-troubleshoot
version: 1.0.0
description: "Skill Pack untuk troubleshooting ISP — cek bandwidth, latency, dan status ONU."
author: "ConAI Engineering"
license: MIT
entrypoint: src/index.ts

permissions:
  - network:http
  - database:read
  - secret:access

triggers:
  - type: keyword
    keywords: ["cek bandwidth", "troubleshoot", "status onu"]
  - type: intent
    intent: "network_diagnostics"

parameters:
  - name: mikrotik_host
    type: string
    required: true
    description: "Hostname atau IP MikroTik router"
  - name: customer_pppoe
    type: string
    required: false
    description: "Username PPPoE pelanggan untuk cek spesifik"

tags:
  - isp
  - troubleshooting
  - mikrotik
  - network

min_platform_version: "2.0.0"

// src/index.ts
import { SkillContext, SkillResponse } from "@conai/sdk";

export async function execute(
  ctx: SkillContext,
  params: Record<string, unknown>
): Promise<SkillResponse> {
  const { mikrotik_host, customer_pppoe } = params;

  // Invoke ConAI Provisioning API untuk cek bandwidth
  const bandwidth = await ctx.api.get(
    `${mikrotik_host}/rest/interface/pppoe-active`,
    { headers: ctx.auth.mikroTikHeaders() }
  );

  const activeSessions = bandwidth.data.filter(
    (s: { name: string }) =>
      !customer_pppoe || s.name === customer_pppoe
  );

  return {
    status: "success",
    message: `Ditemukan ${activeSessions.length} sesi aktif.`,
    data: { sessions: activeSessions },
    suggest_runbook: activeSessions.length === 0
      ? "isp-onu-reboot"
      : undefined,
  };
}