Business Services Entity

v2.0.1

Service

Professional Services

Schema for business or individual service providers (plumbers, lawyers, dentists, builders, etc.). Designed for AI agents to understand service offerings, coverage areas, and professional capabilities.

Entity Hierarchy

BusinessServices

→

service

→

professional_services

→

business_services

Format: @type → entityCategory → subcategory → entityType

Required Modules

Recommended Modules

12+

Functional Features

Site Actions

⭐ New Features in v2.0.1

Perfect AI understanding with zero ambiguity

entityCapabilities

Objective, verifiable service features with rules:

• camelCase (hasEmergencyService, hasLicensedTechnicians)
• Prefixes: has, is, accepts, supports
• Boolean values for objective verification
• Examples expandable - no limitations

siteCapabilities

Actions available on service website with rules:

• snake_case (book_service, request_quote)
• Based on verbs (what users can do)
• Only actually working actions
• Examples expandable without limitations

Recommended Modules

Enhance service business functionality and customer experience

Recommended

auth

Recommended

location

Recommended

payments

Recommended

multilingual

Recommended

user-management

No Required Modules

Business service entities have complete flexibility in module selection

Service providers can operate with any combination of modules based on their business model and customer interaction needs. Location and payments are highly recommended for most service businesses.

Common Service Categories

Examples of business services covered by this entity type

Home Services

• Plumbing
• Electrical
• HVAC
• Cleaning

Professional Services

• Legal
• Accounting
• Consulting
• Marketing

Health Services

• Dental
• Veterinary
• Therapy
• Wellness

Construction

• General Contracting
• Roofing
• Landscaping
• Painting

Entity Capabilities

Objective, verifiable service business features. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".

Naming Convention Rules

• Use camelCase formatting (e.g., "hasEmergencyService", "hasLicensedTechnicians")
• Start with prefixes: "has", "is", "accepts", "supports"
• Examples shown below can be extended - no limitations on additional capabilities
• All values are boolean (true/false) for objective verification

Service Features

hasEmergencyService

24/7 emergency response available

hasOnlineBooking

Schedule services online

hasServiceWarranty

Warranty on work performed

hasLicensedTechnicians

Licensed and certified staff

Business Operations

hasInsurance

Fully insured business

hasUpfrontPricing

Transparent pricing structure

hasWrittenEstimates

Detailed written quotes

acceptsWarrantyWork

Warranty and callback service

Customer Experience

acceptsCreditCards

Multiple payment options

hasAppointmentReminders

Automated reminders

hasCustomerPortal

Online account access

hasReviewSystem

Customer feedback system

Site Capabilities

Available actions for AI agents and automated systems. Define what users can actually do on your service website using snake_case action names.

Action Naming Rules

• Use snake_case formatting (e.g., "book_service", "request_quote")
• Actions should be verb-based describing what users can do
• Examples shown below are common patterns - extend with your specific actions
• List only actions that actually work on your website

book_service

Schedule service appointments

request_quote

Get price estimates

call_emergency

Emergency service contact

view_services

Browse available services

read_reviews

View customer testimonials

contact_support

Get customer support

schedule_maintenance

Book routine maintenance

track_appointment

Monitor service status

Schema Structure

Business Services entity schema definition

business_services.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "Business Services Entity Schema",
  "description": "Schema for business or individual service providers (plumbers, lawyers, dentists, builders, etc.)",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "business_services",
      "description": "Entity type identifier"
    },
    "entityCategory": {
      "const": "service",
      "description": "Entity category"
    },
    "subcategory": {
      "const": "professional_services",
      "description": "Subcategory of service"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Business or service provider name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of services provided"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "Business services specific properties",
      "properties": {
        "serviceCategories": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Types of services offered"
        },
        "serviceArea": {
          "type": "string",
          "description": "Geographic area where services are provided"
        },
        "businessType": {
          "type": "string",
          "description": "Type of business (individual, company, franchise)"
        }
      }
    },
    "entityCapabilities": {
      "$ref": "../components/entity-capabilities-format.json#/$defs/EntityCapabilities",
      "description": "Objective capabilities and features of the entity"
    },
    "siteCapabilities": {
      "$ref": "../components/site-capabilities-format.json#/$defs/SiteCapabilities",
      "description": "Website capabilities and interaction features"
    }
  },
  "required": ["entityType", "entityCategory", "subcategory", "name", "description", "properties"],
  "allOf": [{ "$ref": "../base/service.json" }]
}

Complete Implementation Example

Real-world business services entity with all v2.0.1 features

City Plumbers Pro - Complete Schema

{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://cityplumbers.com/entity",
  "@type": "BusinessServices",
  "schemaVersion": "2.0.1",
  "entityType": "business_services",
  "entityCategory": "service",
  "subcategory": "professional_services",

  "name": {
    "en": "City Plumbers Pro",
    "es": "Plomeros de la Ciudad Pro"
  },
  "description": {
    "en": "Professional plumbing services for residential and commercial properties with 24/7 emergency response and licensed technicians."
  },
  "url": "https://cityplumbers.com",
  "foundingDate": "2015-08-12",

  "properties": {
    "serviceCategories": ["plumbing", "drain_cleaning", "pipe_repair", "emergency_services"],
    "serviceArea": "Metro Area - 50 mile radius",
    "businessType": "licensed_company",
    "yearsInBusiness": 8,
    "certifications": ["licensed", "insured", "bonded"]
  },

  "modules": {
    "location": {
      "version": "2.0.1",
      "enabled": true,
      "address": {
        "addressType": "physical",
        "streetAddress": "456 Service Ave",
        "city": "Metro City",
        "region": "TX",
        "postalCode": "75001",
        "countryCode": "US"
      },
      "serviceArea": {
        "type": "radius",
        "radius": {
          "centerPoint": {
            "latitude": 32.7767,
            "longitude": -96.7970
          },
          "radiusKm": 80
        }
      }
    },
    "payments": {
      "version": "2.0.1",
      "enabled": true,
      "providers": ["stripe", "square"],
      "currencies": ["USD"],
      "paymentMethods": ["credit_card", "cash", "check"]
    },
    "auth": {
      "version": "2.0.1",
      "enabled": true,
      "methods": ["email", "phone"],
      "providers": ["local"]
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "hasEmergencyService": true,
      "hasOnlineBooking": true,
      "hasPhoneBooking": true,
      "hasServiceWarranty": true,
      "hasLicensedTechnicians": true,
      "hasInsurance": true,
      "accepts24HourCalls": true,
      "hasUpfrontPricing": true,
      "acceptsCreditCards": true,
      "hasWrittenEstimates": true
    },
    "serviceTypes": ["residential", "commercial", "emergency", "maintenance"],
    "businessModel": "service_provider",
    "specializations": ["plumbing", "drain_cleaning", "pipe_repair", "water_heaters"],
    "serviceHours": ["24_7_emergency", "business_hours_standard"],
    "paymentMethods": ["credit_card", "cash", "check", "financing"]
  },

  "siteCapabilities": {
    "availableActions": [
      "book_service", "request_quote", "call_emergency",
      "view_services", "read_reviews", "contact_support",
      "schedule_maintenance", "track_appointment"
    ],
    "interactionMethods": ["online_form", "phone_call", "email", "live_chat"],
    "contentAccess": ["public"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es"],
    "realTimeFeatures": ["live_chat", "real_time_booking", "emergency_dispatch"]
  }
}