Senpilot CX Tool Manager

Multi-tenant tool registry and execution service for AI agents. Configure tenant-specific tool implementations and route tool calls to internal databases or external APIs.

API Endpoints
  • GET
    /api/health

    Health check

  • POST
    /api/tools/execute

    Execute a tool for a tenant

  • GET
    /api/tools/definitions

    Get tool definitions (for LLM integration)

  • CRUD
    /api/tenants

    Manage tenants

  • CRUD
    /api/tenants/[id]/tools

    Configure tools per tenant

Available Tools
  • check_account_balance

    Checks a customer's account balance for their utility bill (ZapCo Electric, AquaFlow Water, or GreenLeaf Energy). Returns current balance, due date, payment history, and past due amounts.

  • check_outage_map

    Checks if there are any service outages in the customer's area based on their zip code. Returns active outages, estimated restoration times, and affected areas.

  • check_current_meter

    Gets the current meter reading for a customer's account. Returns the latest reading, timestamp, and usage since last reading.

  • analyze_meter

    Analyzes meter usage patterns and trends over time to help identify unusual consumption. Returns usage trends, anomalies, and recommendations.

  • analyze_bills

    Analyzes billing history and payment patterns to help with payment plans or billing questions. Returns payment history, trends, and payment plan eligibility.

  • create_ticket

    Creates a support ticket for customer issues like billing disputes, service problems, outage reports, or meter issues.

Example: Execute Tool
curl -X POST http://localhost:3000/api/tools/execute \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "<your-tenant-id>",
    "toolName": "check_account_balance",
    "input": {
      "accountNumber": "ACC-12345"
    }
  }'