cai-exos-systems/daveadmin-exos-demo:copilot/connectors/OrderSherpa.swagger.json
copilot/connectors/OrderSherpa.swagger.json
```text
{
"swagger": "2.0",
"info": {
"title": "Exos Order Sherpa",
"description": "MSO/cable order fallout management agent. Diagnoses stuck orders, checks warehouse inventory, assesses SLA risk, and recommends resolution paths. 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": "Order Sherpa — diagnose and resolve order fallout",
"description": "Send a natural-language message to the Order Sherpa agent. The agent uses five tools (get_order_status, get_fallout_details, check_warehouse_inventory, get_field_ops, assess_sla_risk) to diagnose MSO order fallout and recommend resolution steps. Account 17 = Greenfield Apartments (ORD-70021 demo scenario).",
"operationId": "OrderSherpaChat",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": {
"type": "string",
"enum": ["order_sherpa"],
"description": "Agent identifier — must be order_sherpa",
"x-ms-summary": "Agent"
},
"account": {
"type": "string",
"description": "FOSSBilling account ID. Use 17 for the Greenfield Apartments MSO fallout demo.",
"x-ms-summary": "Account ID",
"default": "17"
},
"message": {
"type": "string",
"description": "Natural-language question or instruction for the Order Sherpa agent.",
"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 tool traces and recommendation",
"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_order_status": {
"post": {
"summary": "Get order status",
"description": "Fetch the current status of ORD-70021 from FOSSBilling. Returns order state, suspension reason, and task completion chain.",
"operationId": "GetOrderStatus",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": { "type": "string", "enum": ["order_sherpa"] },
"account": { "type": "string", "default": "17" },
"message": { "type": "string", "default": "get_order_status for ORD-70021" }
}
}
}
],
"responses": { "200": { "description": "Order status result" } }
}
},
"/agent.php/tools/check_warehouse_inventory": {
"post": {
"summary": "Check warehouse inventory",
"description": "Check DOCSIS 3.1 modem stock across all depots. Oslo Central Depot: 0. Bergen Depot: 12 available.",
"operationId": "CheckWarehouseInventory",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"type": "object",
"required": ["agent", "account", "message"],
"properties": {
"agent": { "type": "string", "enum": ["order_sherpa"] },
"account": { "type": "string", "default": "17" },
"message": { "type": "string", "default": "check_warehouse_inventory for DOCSIS 3.1 modems" }
}
}
}
],
"responses": { "200": { "description": "Warehouse inventory result" } }
}
}
},
"securityDefinitions": {}
}
```