plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "oracle-analytics",
  "version": "1.0.1",
  "description": "Use natural language to search your Oracle Analytics Cloud catalog for workbooks, datasets, subject areas, and folders. Inspect dataset and subject-area metadata, and ask questions using Oracle Analytics SQL query results.\n\nThe plugin includes tools for creating catalog folders, saving supported workbook or connection content, copying or moving catalog items, updating catalog access controls, and exporting workbooks to PNG or PDF.\n\nA workspace administrator configures an Oracle Analytics Cloud instance using a supported endpoint. Sign in to that instance to use its tools. Available content and operations depend on the instance configuration, connected tools, and account permissions.",
  "author": {
    "name": "Oracle Analytics"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "capabilities": [],
        "category": "Data & Analytics",
        "defaultPrompt": [
          "Find workbooks in my Oracle Analytics catalog.",
          "Help me summarize a dataset in my Oracle Analytics instance.",
          "Create a folder named Trends in a catalog location I choose."
        ],
        "developerName": "Oracle Analytics",
        "displayName": "Oracle Analytics",
        "longDescription": "Use natural language to search your Oracle Analytics Cloud catalog for workbooks, datasets, subject areas, and folders. Inspect dataset and subject-area metadata, and ask questions using Oracle Analytics SQL query results.\n\nThe plugin includes tools for creating catalog folders, saving supported workbook or connection content, copying or moving catalog items, updating catalog access controls, and exporting workbooks to PNG or PDF.\n\nA workspace administrator configures an Oracle Analytics Cloud instance using a supported endpoint. Sign in to that instance to use its tools. Available content and operations depend on the instance configuration, connected tools, and account permissions.",
        "privacyPolicyURL": "https://www.oracle.com/legal/privacy/privacy-policy",
        "shortDescription": "Explore Oracle Analytics data",
        "supportURL": "https://support.oracle.com/",
        "termsOfServiceURL": "https://www.oracle.com/legal/terms",
        "websiteURL": "https://www.oracle.com/analytics",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "publication": {
        "release_notes": "Add the beta template configuration for customer-specific Oracle Analytics Cloud instances, with one HTTPS URL pattern and OAuth authentication defaults. Scope shared skills and starter prompts to the configured instance.",
        "countries": []
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Configured-instance test setup: select an existing workbook in the test instance and substitute its name for All Charts Demo if needed. Confirm its current identifier through search. This case does not imply that a customer instance includes the demonstration workbook.",
              "prompt": "Find the All Charts Demo workbook in my Oracle Analytics catalog.",
              "tools_triggered": "oracle_analytics-search_catalog",
              "expected_behavior": "Search the exact title and return only actual matching workbook context from oracle_analytics-search_catalog. Clarify multiple matches. No SQL, export, or mutation tools."
            },
            {
              "description": "Configured-instance test setup: use an instance containing a dataset relevant to international trade tariffs, or substitute a business question supported by its test data. Assert relevance only from current tool output; the template example URL is not the test target.",
              "prompt": "Which dataset can answer questions about international trade tariffs?",
              "tools_triggered": "oracle_analytics-find_matching_datasources",
              "expected_behavior": "Preserve international-trade tariff intent in oracle_analytics-find_matching_datasources. Return only actual candidates and explanations supported by tool output. No SQL execution or mutations."
            },
            {
              "description": "Configured-instance test setup: select an existing dataset and substitute its name for Sample States if needed. Resolve its identity from current instance tools; do not reuse an object ID or account path from another instance.",
              "prompt": "What tables and columns are available in Sample States?",
              "tools_triggered": "oracle_analytics-search_catalog, oracle_analytics-describe_data",
              "expected_behavior": "Resolve Sample States through current catalog output when needed, then use oracle_analytics-describe_data on the exact dataset identity. Describe only returned table, column, and type metadata. Do not invent joins. No query execution or mutations."
            },
            {
              "description": "Configured-instance test setup: select a dataset containing a numeric measure and independently establish its maximum under the same effective data-access view. Substitute the selected dataset and measure for International Trade and tariff if needed. No fixed value or unit is assumed across instances.",
              "prompt": "In International Trade, what is the highest tariff?",
              "tools_triggered": "oracle_analytics-find_matching_datasources, oracle_analytics-describe_data, oracle_analytics-execute_logical_sql",
              "expected_behavior": "Resolve the source in the configured instance, inspect current metadata, and use oracle_analytics-execute_logical_sql to calculate the requested maximum. Compare with the independently established baseline for that same source and effective access view. Report units only when established by metadata or tool output. No catalog or ACL mutations."
            },
            {
              "description": "Configured-instance test setup: use an account allowed to create a folder in its own catalog. Resolve its actual My Folders location and verify that Trends Submission Review is absent. If the name exists, obtain a fresh name and approval. No demo account path or prior approval applies to this instance.",
              "prompt": "Create a folder named Trends Submission Review under my Oracle Analytics My Folders.",
              "tools_triggered": "oracle_analytics-search_catalog, oracle_analytics-create_catalog_folder",
              "expected_behavior": "Resolve the connected account's My Folders location from current tool output. Confirm the requested folder is absent, present its exact resolved path, and obtain approval through the supported flow before creation. Report success only from the creation result and verify by catalog readback. If the name exists, stop and obtain a fresh name and exact approval. Cancellation must create no folder."
            }
          ],
          "negative": [
            {
              "description": "OAC SQL cannot update source database records. Refuse or explain the read-only analytics boundary. Do not invoke SQL or catalog mutation tools for a database write.",
              "prompt": "Update every sales record in the source database to double its revenue."
            },
            {
              "description": "User provisioning is outside this plugin's described workflows. Explain the limitation; do not invoke catalog mutation or SQL tools to create a user, and do not claim success.",
              "prompt": "Create a new Oracle Analytics user named Plugin Reviewer."
            },
            {
              "description": "Sending exports by email is outside this plugin’s exposed workflow. Explain the limitation and do not send email or claim delivery. Ask whether the user wants a supported workbook export before starting an export job.",
              "prompt": "Email All Charts Demo as a PDF to everyone in Finance."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not offer payments or purchases.",
        "demo_recording_url": "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idkebl0fuyfa/b/oac-openai/o/demoDemo.mp4"
      }
    }
  }
}