cai-exos-systems/daveadmin-exos-demo:copilot/connectors/EnterpriseBillingExpert.swagger.json
copilot/connectors/EnterpriseBillingExpert.swagger.json
```text
{
"swagger": "2.0",
"info": {
"title": "Exos Enterprise Billing Expert",
"description": "Enterprise telco billing agent for parent/child account hierarchies. Consolidates multi-subsidiary spend, detects anomalies (unused seats, overages), checks SuiteCRM contract compliance, and allocates costs by cost centre. Powered by Exos Agentic BSS at demo.exos.bluenotelogic.com.",
"version": "1.0.0"
},
"host": "demo.exos.bluenotelogic.com",
"basePath": "/api",
"schemes": ["https"],
"consumes": ["application/json"],
"produces": ["application/json"],
"paths": {
"/agent.php": {
"post": {
"summary": "Enterprise Billing Expert — consolidated hierarchy billing",
"description": "Send a natural-language message to the Enterprise Billing Expert agent. The agent uses five tools (get_enterprise_hierarchy, get_consolidated_bill, detect_billing_anomalies, check_contracts, get_cost_allocation) to analyse multi-subsidiary telco billing. Account 18 = Acme Holdings (parent), 19 = Acme Nordics, 20 = Acme UK, 21 = Acme EMEA. March 2026 consolidated spend: EUR 22,547.",
"operationId": "EnterpriseBillingChat",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": {
"type": "string",
"enum": ["enterprise_billing"],
"description": "Agent identifier — must be enterprise_billing",
"x-ms-summary": "Agent"
},
"account": {
"type": "string",
"description": "FOSSBilling account ID. Use 18 for Acme Holdings (parent), 19-21 for subsidiaries.",
"x-ms-summary": "Account ID",
"default": "18"
},
"message": {
"type": "string",
"description": "Natural-language question or instruction for the Enterprise Billing Expert.",
"x-ms-summary": "Message"
},
"model": {
"type": "string",
"description": "LLM model override (optional). Defaults to telecom-bss-v1 on cuttlefish.",
"x-ms-summary": "Model"
}
}
}
}
],
"responses": {
"200": {
"description": "Agent response with consolidated billing analysis and tool traces",
"schema": {
"type": "object",
"properties": {
"reply": {
"type": "string",
"description": "Agent's natural-language response"
},
"tool_calls": {
"type": "array",
"description": "List of tools called during inference",
"items": {
"type": "object",
"properties": {
"tool": { "type": "string" },
"result": { "type": "object" }
}
}
}
}
}
}
}
}
},
"/agent.php/tools/get_enterprise_hierarchy": {
"post": {
"summary": "Get enterprise account hierarchy",
"description": "Fetch the Acme Holdings account hierarchy from SuiteCRM. Returns parent (Holdings) and three child accounts (Nordics, UK, EMEA) with country, cost centre, and account type.",
"operationId": "GetEnterpriseHierarchy",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": { "type": "string", "enum": ["enterprise_billing"] },
"account": { "type": "string", "default": "18" },
"message": { "type": "string", "default": "get_enterprise_hierarchy for Acme Holdings" }
}
}
}
],
"responses": { "200": { "description": "Account hierarchy from SuiteCRM" } }
}
},
"/agent.php/tools/get_consolidated_bill": {
"post": {
"summary": "Get consolidated bill across subsidiaries",
"description": "Roll up FOSSBilling invoices for all Acme subsidiaries (accounts 19, 20, 21). Returns per-subsidiary totals and group consolidated spend for March 2026 (EUR 22,547).",
"operationId": "GetConsolidatedBill",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": { "type": "string", "enum": ["enterprise_billing"] },
"account": { "type": "string", "default": "18" },
"message": { "type": "string", "default": "get_consolidated_bill for March 2026" }
}
}
}
],
"responses": { "200": { "description": "Consolidated billing rollup" } }
}
},
"/agent.php/tools/detect_billing_anomalies": {
"post": {
"summary": "Detect billing anomalies",
"description": "Scan all subsidiary accounts for billing anomalies. Returns: UK — 31 unused PBX extensions (EUR 372/mo waste); EMEA — cloud compute overage +32% (EUR 1,248 above EUR 5,000 commitment).",
"operationId": "DetectBillingAnomalies",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": { "type": "string", "enum": ["enterprise_billing"] },
"account": { "type": "string", "default": "18" },
"message": { "type": "string", "default": "detect_billing_anomalies for the Acme Holdings group" }
}
}
}
],
"responses": { "200": { "description": "Billing anomaly report" } }
}
},
"/agent.php/tools/check_contracts": {
"post": {
"summary": "Check contracts",
"description": "Fetch SuiteCRM contracts for all Acme subsidiaries. Returns: Nordics — 150 SIM commitment Jan 2025–Dec 2026 (173 active, above commit); UK — 200 PBX seats Mar 2025–Feb 2026 (expires soon, 31 unused); EMEA — EUR 5,000/mo cloud Jun 2025–May 2026 (overage +EUR 1,248).",
"operationId": "CheckContracts",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": { "type": "string", "enum": ["enterprise_billing"] },
"account": { "type": "string", "default": "18" },
"message": { "type": "string", "default": "check_contracts for all Acme subsidiaries" }
}
}
}
],
"responses": { "200": { "description": "Contract compliance report from SuiteCRM" } }
}
},
"/agent.php/tools/get_cost_allocation": {
"post": {
"summary": "Get cost allocation by cost centre",
"description": "Allocate March 2026 spend across cost centres. Nordics: Engineering (100 SIMs) + Sales (73 SIMs). UK: IT Operations (214 PBX).
copilot/connectors/EnterpriseBillingExpert.swagger.json "agent": { "type": "string", "enum": ["enterprise_billing"] }, "account": { "type": "string", "default": "18" }, "message": { "type": "string", "default": "check_contracts for all Acme subsidiaries" } } } } ], "responses": { "200": { "description": "Contract compliance report from SuiteCRM" } } } }, "/agent.php/tools/get_cost_allocation": { "post": { "summary": "Get cost allocation by cost centre", "description": "Allocate March 2026 spend across cost centres. Nordics: Engineering (100 SIMs) + Sales (73 SIMs). UK: IT Operations (214 PBX). EMEA: Human Resources (cloud compute).", "operationId": "GetCostAllocation", "parameters": [ { "in": "body", "name": "body", "required": true, "schema": { "type": "object", "required": ["agent", "account", "message"], "properties": { "agent": { "type": "string", "enum": ["enterprise_billing"] }, "account": { "type": "string", "default": "18" }, "message": { "type": "string", "default": "get_cost_allocation for March 2026 across all cost centres" } } } } ], "responses": { "200": { "description": "Cost centre allocation breakdown" } } } } }, "securityDefinitions": {} } ```
copilot/connectors/EnterpriseBillingExpert.swagger.json "agent": { "type": "string", "enum": ["enterprise_billing"] }, "account": { "type": "string", "default": "18" }, "message": { "type": "string", "default": "check_contracts for all Acme subsidiaries" } } } } ], "responses": { "200": { "description": "Contract compliance report from SuiteCRM" } } } }, "/agent.php/tools/get_cost_allocation": { "post": { "summary": "Get cost allocation by cost centre", "description": "Allocate March 2026 spend across cost centres. Nordics: Engineering (100 SIMs) + Sales (73 SIMs). UK: IT Operations (214 PBX). EMEA: Human Resources (cloud compute).", "operationId": "GetCostAllocation", "parameters": [ { "in": "body", "name": "body", "required": true, "schema": { "type": "object", "required": ["agent", "account", "message"], "properties": { "agent": { "type": "string", "enum": ["enterprise_billing"] }, "account": { "type": "string", "default": "18" }, "message": { "type": "string", "default": "get_cost_allocation for March 2026 across all cost centres" } } } } ], "responses": { "200": { "description": "Cost centre allocation breakdown" } } } } }, "securityDefinitions": {} } ```