Skip to main content

Understanding the inferRanking Query

Overview​

The inferRanking query is designed to evaluate and rank a list of items (in this context, companies) based on specific criteria defined within a PromptConfigInput. This evaluation process incorporates both predefined scores and rationales for a subset of items (scoredItems) and applies this understanding to rank additional items (items). The query leverages a model backend, specified by modelBackendName, to process and rank these items effectively.

Query Structure​

The query accepts four main arguments:

  1. promptConfig: A configuration object that outlines the evaluation criteria, including bounds for scoring, terminologies specific to the items being ranked, and a set of rules that guide the ranking process.

  2. items: An array of ItemInput objects. These are the items to be ranked based on the criteria defined in promptConfig and the insights derived from scoredItems.

  3. scoredItems: An array of ScoredItemInput objects. Each object includes an item with its name and description, a score, and a rationale for the score. This input serves as a reference to guide the ranking of items in the items array.

  4. modelBackendName: A string specifying the backend model to use for inferring rankings. This model processes the input data according to the logic and criteria defined in the promptConfig and scoredItems.

Output​

The query returns a list of ranked items, each with:

  • Item details: Name and description.
  • Rationale: Explanation for the item's ranking.
  • Score: A numerical value representing the item's rank according to the specified criteria.

Example Use Case​

In the provided example, the promptConfig outlines criteria for ranking companies based on their potential as leads for a product designed to address complex data management challenges. The criteria emphasize the importance of companies operating within IT, manufacturing, and distribution sectors, among other specifics.

Query​

query RankItems($items: [RankingItemInput!]!, $scoredItems: [ScoredItemInput!]!, $modelBackendName: String!, $promptConfig: RankPromptConfigInput) {
  inferRanking(items: $items, scoredItems: $scoredItems, modelBackendName: $modelBackendName, promptConfig: $promptConfig) {
    labelId
    predictionId
    labelValue
    scoredItem {
      item {
        name
        description
      }
      score
      rationale
    }
  }
}

Variables​

  • promptConfig: Defines the scoring bounds (1 to 10), terminologies (e.g., "company", "companies", "lead", "leads"), and detailed rules for identifying high-potential leads.
  • scoredItems: Includes pre-scored companies such as Zebra Technologies, Fortinet, AMD, Impartner, and Channel Assist, with scores and rationales based on their alignment with the product's target market.
  • items: Lists companies like Ingram Micro, Intelisys/ScanSource, and PCLiquidations to be ranked.
  • modelBackendName: "data-steward", indicating the specific backend model used for the ranking process.
{
    "promptConfig": {
        "lowerBound": 1,
        "upperBound": 10,
        "itemNoun": "company",
        "itemsNoun": "companies",
        "scoreNoun": "lead",
        "scoresNoun": "leads",
        "rules": [
            "When sourcing leads for our products, it's essential to focus on companies that grapple with complex data management challenges, particularly those operating within IT, manufacturing, and distribution sectors. Ideal leads are organizations that manage extensive sales channels, inventory, or customer data and are seeking ways to optimize their operations through actionable insights. Look for companies with a visible struggle in handling unstructured data or those expressing a need to enhance their decision-making processes based on real-time data analysis. Entities involved in lifecycle management, refurbishment, recycling, or those with large indirect sales networks, such as VARs (Value-Added Resellers) and MSPs (Managed Service Providers), are prime candidates. Their operational complexity and data richness make them perfect to benefit from our AI-driven insights and data enrichment capabilities.",
            "Consider also the company's openness to innovation and technology adoption. Organizations already leveraging or showing interest in advanced analytics, AI solutions, or partner relationship management software indicate a readiness to integrate solutions like Data Steward and Protege Engine. Pay attention to any pain points mentioned in industry forums, webinars, or case studies related to managing channel data, optimizing pricing strategies, or enhancing partner relationships. By aligning our solutions with the specific challenges these companies face, you’ll not only pinpoint leads with the highest potential but also position our offerings as indispensable tools for their success.",
            "Leads outside of Manufacturing (ex. Cyber security or IOT) aren't super valuable to us as we have to build custom solutions for them.",
            "SaaS companies are the least interesting to us as they are the most likely to have their own data management solutions so we should score them lower.",
            "Our current solution is designed for the Sales Channel at AMD, so we have the least burden of proof for companies in that space."
        ]
    },
    "scoredItems": [
        {
            "item": {
                "name": "Zebra Technologies",
                "description": "Zebra Technologies is a global company specializing in enterprise-level data capture and automatic identification solutions that provide businesses with operational visibility. Their product line includes barcode printers, mobile computers, RFID systems, and software that integrate physical assets with digital data for improved efficiency and accuracy in supply chains, retail, healthcare, and other industries."
            },
            "score": 9,
            "rationale": "Specializes in tracking technology and solutions, with extensive channel partnerships that could benefit from Data Steward's data enrichment capabilities."
        },
        {
            "item": {
                "name": "Fortinet",
                "description": "Their focus on cybersecurity solutions for a wide range of businesses includes a vast channel partner network that requires sophisticated data management."
            },
            "score": 8,
            "rationale": "Fortinet is a multinational corporation that provides a broad range of cybersecurity solutions, including firewalls, anti-virus, intrusion prevention, and endpoint security, designed to protect networks, users, and data from constantly evolving cyber threats. Their flagship product, the FortiGate firewall, is at the core of their integrated platform, which is engineered to deliver high performance, automation, and visibility for securing digital assets across on-premises, cloud, and hybrid environments."
        },
        {
            "item": {
                "name": "AMD",
                "description": "AMD (Advanced Micro Devices) is a leading global semiconductor company known for its high-performance computing, graphics, and visualization technologies, including CPUs (Central Processing Units), GPUs (Graphics Processing Units), and APUs (Accelerated Processing Units). These products serve a wide range of applications from personal computers and data centers to gaming consoles, providing the computational power necessary for everything from everyday computing to advanced scientific research and immersive digital entertainment."
            },
            "score": 8,
            "rationale": "Despite their enormity, AMD's extensive global distribution and sales channels can be optimized further with Data Steward's insights for inventory and sales."
        },
        {
            "item": {
                "name": "Impartner",
                "description": "Impartner is a prominent provider of Partner Relationship Management (PRM) software, designed to help companies optimize their channel sales by automating and enhancing the management of partner relationships, collaborations, and engagements. Their platform streamlines processes such as partner onboarding, deal registration, lead management, and marketing development funds, aiming to increase efficiency, accelerate revenue growth, and improve the overall effectiveness of channel partner programs."
            },
            "score": 7,
            "rationale": "As a PRM (Partner Relationship Management) software provider, Impartner's clients could benefit from Data Steward's data enrichment capabilities. Companies in the program management space are top prospects because they are directly connected to various manufacturers who may need data steward to plug into their Channel Data Management efforts. A PRM partnership and integration with DataSteward is a straightforward way to market to these companies. Their relative size however brings the score down."
        },
        {
            "item": {
                "name": "Channel Assist",
                "description": "Channel Assist is a software company specializing in channel sales and partner relationship management solutions that help businesses optimize their sales channels and enhance partner engagement. Their platform provides tools for partner recruitment, training, incentives, and performance tracking, enabling companies to build and manage effective channel partner programs that drive revenue growth and customer satisfaction."
            },
            "score": 9,
            "rationale": "Channel Assist's focus on channel sales and partner relationship management aligns closely with Data Steward's capabilities, making them a prime candidate for a partnership or client relationship. Their size at ~50 employees and $20m in revenue is a good fit for us."
        }
    ],
    "items": [
        {
            "name": "Ingram Micro",
            "description": "Ingram Micro is the business behind the world’s brands with the ability to reach nearly 90 percent of the world’s population. Our reach, combined with our diverse solutions portfolio and ease of doing business with our digital experience platform, Ingram Micro Xvantage™, makes us unique. We reach close to 200 countries and have approximately 27,000 associates and more than 161,000 customers and 1,500 vendor partners worldwide. Learn more at www.ingrammicro.com."
        },
        {
            "name": "Intelisys / ScanSource",
            "description": "Intelisys, a ScanSource company, is a leading technology services distributor of connectivity and cloud services, including voice, data, access, cable, collaboration, wireless, and cloud. Intelisys is committed to serving the needs and accelerating the success of the industry's top-producing telecom sales agents, IT Solution Providers, VARs, MSPs, and integrators, as they leverage the power of recurring revenue in their businesses. For more information, visit www.intelisys.com."
        },
        {
            "name": "PCLiquidations",
            "description": "PCLiquidations offers a wide range of new and sustainable IT solutions, driven by a team of employees who strive to solve your technology fulfillment and lifecycle barriers with quality products, exceptional communication, and a focus on reducing electronic waste for a greener world. We help VARs, MSPs, Telcos, and more reap higher values from used or unwanted gear by removing the wholesaler from the lifecycle process in providing pickup/packing, certified destruction, refurbishment, and remarketing direct to consumer through our own ecommerce platform. We have over 30 years of experience remarket laptops, desktops, business phones, monitors, networking, printers, and more from the top brands in the industry. Connect with us in booth 2339 at the show to learn more."
        },
    ],
    "modelBackendName": "data-steward"
}

Response​

The response ranks the companies in items based on the criteria and examples provided in promptConfig and scoredItems. For instance, Ingram Micro is scored highly due to its global reach and extensive network, aligning well with the target market criteria. Similarly, PCLiquidations receives a high score for its focus on sustainable IT solutions and lifecycle management, areas highlighted in the ranking criteria.

{
    "promptConfig": {
        "lowerBound": 1,
        "upperBound": 10,
        "itemNoun": "company",
        "itemsNoun": "companies",
        "scoreNoun": "lead",
        "scoresNoun": "leads",
        "rules": [
            "When sourcing leads for our products, it's essential to focus on companies that grapple with complex data management challenges, particularly those operating within IT, manufacturing, and distribution sectors. Ideal leads are organizations that manage extensive sales channels, inventory, or customer data and are seeking ways to optimize their operations through actionable insights. Look for companies with a visible struggle in handling unstructured data or those expressing a need to enhance their decision-making processes based on real-time data analysis. Entities involved in lifecycle management, refurbishment, recycling, or those with large indirect sales networks, such as VARs (Value-Added Resellers) and MSPs (Managed Service Providers), are prime candidates. Their operational complexity and data richness make them perfect to benefit from our AI-driven insights and data enrichment capabilities.",
            "Consider also the company's openness to innovation and technology adoption. Organizations already leveraging or showing interest in advanced analytics, AI solutions, or partner relationship management software indicate a readiness to integrate solutions like Data Steward and Protege Engine. Pay attention to any pain points mentioned in industry forums, webinars, or case studies related to managing channel data, optimizing pricing strategies, or enhancing partner relationships. By aligning our solutions with the specific challenges these companies face, you’ll not only pinpoint leads with the highest potential but also position our offerings as indispensable tools for their success.",
            "Leads outside of Manufacturing (ex. Cyber security or IOT) aren't super valuable to us as we have to build custom solutions for them.",
            "SaaS companies are the least interesting to us as they are the most likely to have their own data management solutions so we should score them lower.",
            "Our current solution is designed for the Sales Channel at AMD, so we have the least burden of proof for companies in that space."
        ]
    },
    "scoredItems": [
        {
            "item": {
                "name": "Zebra Technologies",
                "description": "Zebra Technologies is a global company specializing in enterprise-level data capture and automatic identification solutions that provide businesses with operational visibility. Their product line includes barcode printers, mobile computers, RFID systems, and software that integrate physical assets with digital data for improved efficiency and accuracy in supply chains, retail, healthcare, and other industries."
            },
            "score": 9,
            "rationale": "Specializes in tracking technology and solutions, with extensive channel partnerships that could benefit from Data Steward's data enrichment capabilities."
        },
        {
            "item": {
                "name": "Fortinet",
                "description": "Their focus on cybersecurity solutions for a wide range of businesses includes a vast channel partner network that requires sophisticated data management."
            },
            "score": 8,
            "rationale": "Fortinet is a multinational corporation that provides a broad range of cybersecurity solutions, including firewalls, anti-virus, intrusion prevention, and endpoint security, designed to protect networks, users, and data from constantly evolving cyber threats. Their flagship product, the FortiGate firewall, is at the core of their integrated platform, which is engineered to deliver high performance, automation, and visibility for securing digital assets across on-premises, cloud, and hybrid environments."
        },
        {
            "item": {
                "name": "AMD",
                "description": "AMD (Advanced Micro Devices) is a leading global semiconductor company known for its high-performance computing, graphics, and visualization technologies, including CPUs (Central Processing Units), GPUs (Graphics Processing Units), and APUs (Accelerated Processing Units). These products serve a wide range of applications from personal computers and data centers to gaming consoles, providing the computational power necessary for everything from everyday computing to advanced scientific research and immersive digital entertainment."
            },
            "score": 8,
            "rationale": "Despite their enormity, AMD's extensive global distribution and sales channels can be optimized further with Data Steward's insights for inventory and sales."
        },
        {
            "item": {
                "name": "Impartner",
                "description": "Impartner is a prominent provider of Partner Relationship Management (PRM) software, designed to help companies optimize their channel sales by automating and enhancing the management of partner relationships, collaborations, and engagements. Their platform streamlines processes such as partner onboarding, deal registration, lead management, and marketing development funds, aiming to increase efficiency, accelerate revenue growth, and improve the overall effectiveness of channel partner programs."
            },
            "score": 7,
            "rationale": "As a PRM (Partner Relationship Management) software provider, Impartner's clients could benefit from Data Steward's data enrichment capabilities. Companies in the program management space are top prospects because they are directly connected to various manufacturers who may need data steward to plug into their Channel Data Management efforts. A PRM partnership and integration with DataSteward is a straightforward way to market to these companies. Their relative size however brings the score down."
        },
        {
            "item": {
                "name": "Channel Assist",
                "description": "Channel Assist is a software company specializing in channel sales and partner relationship management solutions that help businesses optimize their sales channels and enhance partner engagement. Their platform provides tools for partner recruitment, training, incentives, and performance tracking, enabling companies to build and manage effective channel partner programs that drive revenue growth and customer satisfaction."
            },
            "score": 9,
            "rationale": "Channel Assist's focus on channel sales and partner relationship management aligns closely with Data Steward's capabilities, making them a prime candidate for a partnership or client relationship. Their size at ~50 employees and $20m in revenue is a good fit for us."
        }
    ],
    "items": [
        {
            "name": "Ingram Micro",
            "description": "Ingram Micro is the business behind the world’s brands with the ability to reach nearly 90 percent of the world’s population. Our reach, combined with our diverse solutions portfolio and ease of doing business with our digital experience platform, Ingram Micro Xvantage™, makes us unique. We reach close to 200 countries and have approximately 27,000 associates and more than 161,000 customers and 1,500 vendor partners worldwide. Learn more at www.ingrammicro.com."
        },
        {
            "name": "Intelisys / ScanSource",
            "description": "Intelisys, a ScanSource company, is a leading technology services distributor of connectivity and cloud services, including voice, data, access, cable, collaboration, wireless, and cloud. Intelisys is committed to serving the needs and accelerating the success of the industry's top-producing telecom sales agents, IT Solution Providers, VARs, MSPs, and integrators, as they leverage the power of recurring revenue in their businesses. For more information, visit www.intelisys.com."
        },
        {
            "name": "PCLiquidations",
            "description": "PCLiquidations offers a wide range of new and sustainable IT solutions, driven by a team of employees who strive to solve your technology fulfillment and lifecycle barriers with quality products, exceptional communication, and a focus on reducing electronic waste for a greener world. We help VARs, MSPs, Telcos, and more reap higher values from used or unwanted gear by removing the wholesaler from the lifecycle process in providing pickup/packing, certified destruction, refurbishment, and remarketing direct to consumer through our own ecommerce platform. We have over 30 years of experience remarket laptops, desktops, business phones, monitors, networking, printers, and more from the top brands in the industry. Connect with us in booth 2339 at the show to learn more."
        },
    ],
    "modelBackendName": "data-steward"
}

Response​

The response ranks the companies in items based on the criteria and examples provided in promptConfig and scoredItems. For instance, Ingram Micro is scored highly due to its global reach and extensive network, aligning well with the target market criteria. Similarly, PCLiquidations receives a high score for its focus on sustainable IT solutions and lifecycle management, areas highlighted in the ranking criteria.

{
  "data": {
    "inferRanking": {
      "ranking": [
        {
          "item": {
            "name": "Ingram Micro",
            "description": "Ingram Micro is the business behind the world’s brands with the ability to reach nearly 90 percent of the world’s population. Our reach, combined with our diverse solutions portfolio and ease of doing business with our digital experience platform, Ingram Micro Xvantage™, makes us unique. We reach close to 200 countries and have approximately 27,000 associates and more than 161,000 customers and 1,500 vendor partners worldwide. Learn more at www.ingrammicro.com."
          },
          "rationale": "Ingram Micro is a global distributor with an extensive network reaching nearly 200 countries, making them an ideal candidate for Data Steward's data enrichment capabilities. Their large customer base and vendor partnerships can benefit from optimizing inventory and sales through our insights. Their size and global reach align well with our target market, making them a prime candidate for partnership or client relationship.",
          "score": 9
        },
        {
          "item": {
            "name": "Intelisys / ScanSource",
            "description": "Intelisys, a ScanSource company, is a leading technology services distributor of connectivity and cloud services, including voice, data, access, cable, collaboration, wireless, and cloud. Intelisys is committed to serving the needs and accelerating the success of the industry's top-producing telecom sales agents, IT Solution Providers, VARs, MSPs, and integrators, as they leverage the power of recurring revenue in their businesses. For more information, visit www.intelisys.com."
          },
          "rationale": "Intelisys, as a ScanSource company, focuses on connectivity and cloud services distribution, which aligns with our capabilities in data enrichment and optimization. Their involvement with telecom sales agents, IT Solution Providers, VARs, MSPs, and integrators indicates a need for advanced analytics and AI solutions to manage their extensive sales channels and customer data. Their size and involvement in the technology services distribution sector make them an attractive lead for our offerings.",
          "score": 8
        },
        {
          "item": {
            "name": "PCLiquidations",
            "description": "PCLiquidations offers a wide range of new and sustainable IT solutions, driven by a team of employees who strive to solve your technology fulfillment and lifecycle barriers with quality products, exceptional communication, and a focus on reducing electronic waste for a greener world. We help VARs, MSPs, Telcos, and more reap higher values from used or unwanted gear by removing the wholesaler from the lifecycle process in providing pickup/packing, certified destruction, refurbishment, and remarketing direct to consumer through our own ecommerce platform. We have over 30 years of experience remarket laptops, desktops, business phones, monitors, networking, printers, and more from the top brands in the industry. Connect with us in booth 2339 at the show to learn more."
          },
          "rationale": "PCLiquidations operates within the IT sector, offering sustainable IT solutions and refurbishment services. They have experience in handling various types of technology products from top brands and have an ecommerce platform. Their involvement in lifecycle management and refurbishment aligns with our capabilities, making them a potential candidate for our solutions. Additionally, their focus on reducing electronic waste aligns with our commitment to sustainability.",
          "score": 9
        }
      ]
    }
  }
}

Conclusion​

The inferRanking query is a powerful tool for evaluating and ranking items based on complex, multi-faceted criteria. By integrating predefined scores and rationales with a dynamic ranking model, it offers tailored insights that can guide decision-making processes in various contexts, such as lead generation, market analysis, and strategic planning.