Boss Agent Connector Capability Discovery Guide

"When to Use" Table

User Request	Tool
"What connectors are available?"	`connector_discover`
"What can QuickBooks do?"	`connector_get_capability`
"Register new connector"	`connector_register`
"Initialize connectors"	`connector_backfill`
"Call QuickBooks API"	`connector_invoke`
"Validate my payload"	`connector_validate_input`
"How is the connector performing?"	`connector_get_stats`
"Connector service status"	`connector_discovery_status`

TRIGGERS: "discover connector", "list connectors", "connector capabilities", "invoke connector", "call connector", "use connector", "register connector", "connector stats", "connector status", "what connectors", "available connectors"

Key Concepts

Capability ID Format: {connector}.{action}.{resource}:v{version} (e.g., quickbooks.read.transactions:v1)
Tags: finance, ads, analytics, communication
Schema Validation: JSON Schema validation before invocation
Auth Types: oauth2, api_key, service_account, bearer_token, basic_auth, none
Data Classifications: public, internal, confidential, pii, financial

Example Usage

Discovery

# "Discover finance connectors"
tools.connector_discover(tag="finance")

Invocation

# "Read QuickBooks transactions"
tools.connector_invoke(
    capability_id="quickbooks.read.transactions:v1",
    payload={"start_date": "2024-01-01"}
)

Inspection

# "What can Google Ads do?"
results = tools.connector_discover(tag="google")
# then
tools.connector_get_capability(name="google_ads.create.campaign:v1")

ACTION_KEYWORDS Integration

The Boss Agent automatically detects these intents via ACTION_KEYWORDS mapping:

connector_discover: ["discover connectors", "list connectors", "available connectors"]
connector_invoke: ["invoke connector", "call connector", "use connector"]
connector_get_capability: ["connector details", "capability info"]
connector_stats: ["connector stats", "connector performance"]
connector_status: ["connector status", "is connector up"]

The Boss Agent is now a virtuoso - it has:

✅ Clear tool descriptions and numbering ✅ User request → tool mapping table ✅ Trigger phrases for automatic detection ✅ Core concepts for context understanding ✅ Example usage patterns for guidance ✅ ACTION_KEYWORDS for intent routing