plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "ciro",
  "version": "1.0.0",
  "description": "Read-only access to a consumer brand's sell-out analytics in Ciro: sales, stock, out-of-stocks, purchase suggestions, saved dashboards and data freshness across retail chains.",
  "author": {
    "name": "HeyCiro",
    "email": "support@heyciro.com",
    "url": "https://heyciro.com"
  },
  "homepage": "https://heyciro.com/ai-agents",
  "keywords": [
    "sell-out",
    "retail",
    "sales",
    "inventory",
    "analytics",
    "consumer goods"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Ciro",
        "shortDescription": "Sell-out and stock analytics",
        "longDescription": "Ciro is a sell-out analytics platform for consumer brands that sell through retail chains. It brings together the sales and stock data each chain shares with its suppliers, links the chain's product and store codes to the brand's own catalog, and keeps that data current.\n\nCiro for ChatGPT answers questions with that data for the Ciro organization you connect:\n- Sales and units by retail chain, banner, brand, category, product, store, region or time, including comparisons with last year or last month.\n- Stock, out-of-stocks and stock coverage by product and store.\n- Purchase suggestions to reach your target days of inventory.\n- Your saved Ciro dashboards, over their own date range or another one.\n- Data freshness: the last day with sales and the last stock report for each chain, and the state of each integration.\n\nIt's read-only: it can't change data, settings or users in Ciro. You approve each connection for one Ciro organization, and your access is checked again on every request.\n\nCiro is built for key account managers, sales teams and demand planners at consumer brands, mainly in Latin America. You need a Ciro account with access to an organization. Answers reflect the retail chains your organization has connected, and data usually arrives one day late.",
        "developerName": "HEY CIRO S.A.C.",
        "category": "Data & Analytics",
        "capabilities": [
          "Sales and units by chain, brand, product, store or time",
          "Stock and out-of-stock analysis",
          "Purchase suggestions to reach target days of inventory",
          "Saved Ciro dashboards",
          "Data freshness for each retail chain"
        ],
        "websiteURL": "https://heyciro.com",
        "supportURL": "https://heyciro.com/support",
        "privacyPolicyURL": "https://heyciro.com/privacy",
        "termsOfServiceURL": "https://heyciro.com/terms",
        "defaultPrompt": [
          "What were my sales by retail chain last month, compared with last year?",
          "Which products have the most stores out of stock?",
          "Is my sales and stock data up to date for every chain?"
        ],
        "brandColor": "#F95C0E",
        "brandColorDark": "#F95C0E",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "demo_recording_url": "https://heyciro.com/videos/ciro-chatgpt-demo.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Sales for a period, broken down by retail chain.",
              "prompt": "What were my sales and units by retail chain this year?",
              "tools_triggered": "query_data",
              "expected_behavior": "Returns a table with net sales and units sold for each retail chain in the connected organization for this year, and states the date range and the currency."
            },
            {
              "description": "A sales trend over time.",
              "prompt": "Show my monthly sales for the last six months.",
              "tools_triggered": "query_data",
              "expected_behavior": "Returns net sales for each of the last six months, oldest first, and points out a month that's only partly covered."
            },
            {
              "description": "Out-of-stock analysis from the latest stock report.",
              "prompt": "Which products have the most stores out of stock?",
              "tools_triggered": "query_data",
              "expected_behavior": "Lists products ranked by the number of stores without stock, with their out-of-stock coverage, based on the latest stock report."
            },
            {
              "description": "Data freshness for each retail chain before analyzing recent days.",
              "prompt": "Is my sales and stock data up to date for every chain?",
              "tools_triggered": "get_data_status",
              "expected_behavior": "Lists each retail chain with its last day of sales, its last stock report and the state of its integration, and points out chains whose data is behind."
            },
            {
              "description": "Reading a saved Ciro dashboard.",
              "prompt": "List my Ciro dashboards and summarize the first one.",
              "tools_triggered": "list_dashboards, run_dashboard",
              "expected_behavior": "Lists the dashboards the test account can see, then summarizes the data of each tile of the first dashboard with its date range."
            }
          ],
          "negative": [
            {
              "description": "Changing data isn't supported: every Ciro tool is read-only. The assistant should explain that it can't update stock in Ciro.",
              "prompt": "Set the stock of all my products in Ciro to 100 units."
            },
            {
              "description": "Deleting data isn't supported: every Ciro tool is read-only. The assistant should explain that it can't delete data in Ciro.",
              "prompt": "Delete last month's sales data from Ciro."
            },
            {
              "description": "Data outside the connected organization isn't accessible: a connection reads only the organization the user approved. The assistant should say it can only see the connected organization's data.",
              "prompt": "Show me the sales of another company's brands from their Ciro account."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Ciro doesn't sell products or process payments."
      },
      "publication": {
        "release_notes": "First release: six read-only tools for Ciro's sell-out analytics, covering the data catalog, queries, dimension values, saved dashboards, dashboard data and data freshness."
      },
      "apps": "./.app.json"
    }
  }
}