plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kodata",
  "version": "1.0.1",
  "description": "Ask about your KO projects in plain words: report numbers, decision engine insights, data diagnostics and journals, read-only.",
  "author": {
    "name": "KO Data",
    "email": "hi@kodata.pro",
    "url": "https://kodata.pro"
  },
  "homepage": "https://kodata.pro",
  "keywords": [
    "marketing analytics",
    "revenue analytics",
    "attribution",
    "ad spend",
    "leads",
    "reports"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "KO Data",
        "shortDescription": "Ask your KO marketing data",
        "longDescription": "KO Data connects your AI assistant to KO, a marketing and revenue analytics platform. Ask about your projects in plain words, for example \"Which source brought the most leads last month?\" or \"Which campaigns spend money but bring no leads?\". The answer comes from your KO reports: the same numbers, counted by the same project rules as in the KO interface.\n\nThe assistant can read:\n- report numbers: your project metrics, such as spend, leads, deals and revenue, by period, source, campaign or another dimension, with the previous period for comparison;\n- insights from the KO decision engine: what to fix in tracking and where the budget works or does not, with the reason for each one;\n- data diagnostics: integrations, website tagging and checks that show whether the numbers can be trusted;\n- journals: the individual leads, deals and visits behind a number;\n- the project setup: how each metric is counted, plans for the period, segments and the business context.\n\nAccess is read-only. The assistant cannot change settings, campaigns or data in KO.\n\nYou need a KO account. To connect, you sign in on the KO page and allow access; the assistant never sees your password. It sees only the projects your account can open in KO. If the connection is not used for 30 days, the access ends and KO asks you to sign in again.",
        "developerName": "KO Data",
        "category": "Data & Analytics",
        "capabilities": [
          "Read report numbers by period, source, campaign or another project dimension",
          "Explain insights from the KO decision engine and the suggested next step",
          "Check data health: integrations, website tagging and diagnostics"
        ],
        "websiteURL": "https://kodata.pro/",
        "supportURL": "https://kodata.pro/en/help/account/connect-ai-client/",
        "privacyPolicyURL": "https://kodata.pro/en/legal/privacy/",
        "termsOfServiceURL": "https://kodata.pro/en/legal/terms/",
        "defaultPrompt": [
          "Which source brought the most leads last month in KO?",
          "What does KO suggest fixing in my marketing data?",
          "Can I trust the numbers in my KO reports?"
        ],
        "brandColor": "#FF5A00",
        "brandColorDark": "#FF7A33",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://youtu.be/vbK_IlgdOm0",
        "test_cases": {
          "positive": [
            {
              "description": "After sign-in, the assistant lists the projects the account can read",
              "prompt": "Which KO projects can I see?",
              "tools_triggered": "ko_list_projects",
              "expected_behavior": "ko_list_projects returns one project for the test account: \"WebSpeed Demo\" (id 814), currency EUR, marked as a demo project. The assistant names it and does not invent other projects."
            },
            {
              "description": "A question about lead sources is answered from the KO report, not from guesses",
              "prompt": "In KO, which traffic source brought the most leads to WebSpeed Demo in the last 30 days?",
              "tools_triggered": "ko_list_metrics, ko_get_report",
              "expected_behavior": "The assistant finds the lead metric with ko_list_metrics, then calls ko_get_report with section \"breakdown\" by source for the last 30 days. It answers with a short ranking of sources (for example google, linkedin, meta) with their lead counts, names the period, and gives money in EUR. The numbers match the report; the assistant does not add figures that the tool did not return."
            },
            {
              "description": "Decision engine insights are retold with their reason and suggested action",
              "prompt": "What does KO suggest doing about the ad budget in WebSpeed Demo?",
              "tools_triggered": "ko_get_insights",
              "expected_behavior": "ko_get_insights returns the cards of the KO decision engine, grouped into what to do now and what to watch. The assistant retells the main cards: what was found, why it matters and the suggested action, in the words of the cards. It does not present its own advice as KO findings and does not quote numbers that are not in the cards."
            },
            {
              "description": "A trust question is answered with data diagnostics",
              "prompt": "Can I trust the numbers in WebSpeed Demo? Check the KO diagnostics.",
              "tools_triggered": "ko_get_diagnostics",
              "expected_behavior": "ko_get_diagnostics returns the diagnostics panels, such as Connections, Website and Tracking tags, with their state. The assistant says which areas are healthy and which have problems, and what each problem means for the numbers. If nothing is wrong, it says so instead of inventing an issue."
            },
            {
              "description": "The records behind a number are shown as examples from a journal",
              "prompt": "Show me five recent leads from LinkedIn in WebSpeed Demo.",
              "tools_triggered": "ko_get_journal",
              "expected_behavior": "ko_get_journal returns lead records filtered by source. The assistant shows up to five of them with their source, campaign and pipeline stage. WebSpeed Demo holds sample data, so no real people appear. The assistant shows examples and does not offer a full export."
            }
          ],
          "negative": [
            {
              "description": "KO access is read-only: no tool changes anything, and the assistant says it cannot pause campaigns through KO; it may offer to show how the LinkedIn campaigns perform",
              "prompt": "Pause my LinkedIn campaigns in KO"
            },
            {
              "description": "A general marketing question with no reference to the user's data: KO tools are not called, and the assistant answers with general knowledge",
              "prompt": "What is a good conversion rate for a B2B landing page?"
            },
            {
              "description": "A request unrelated to marketing data: KO tools are not called",
              "prompt": "Write a short birthday message for my colleague"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "KO Data does not sell products or process payments in ChatGPT."
      },
      "publication": {
        "release_notes": "First release: ask about your KO projects in ChatGPT. After you sign in with your KO account, the app reads report numbers, decision engine insights, data diagnostics, journals and the project setup. Access is read-only."
      },
      "apps": "./.app.json"
    }
  }
}