Generated Tool Examples

Example 1: Product Search (Read)

product_search — Read / No Risk

{
  "tool_name": "product_search",
  "description": "Search the product catalog by text query with optional filters",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": { "type": "string", "description": "Search query text" },
      "category": { "type": "string", "description": "Category filter" },
      "price_min": { "type": "number", "minimum": 0, "description": "Minimum price" },
      "price_max": { "type": "number", "minimum": 0, "description": "Maximum price" },
      "sort_by": { "type": "string", "enum": ["relevance", "price_asc", "price_desc", "newest"], "description": "Sort order" }
    },
    "required": ["query"]
  },
  "safety": { "execution_type": "read", "risk_level": "none", "idempotent": true, "confirmation_required": false }
}

Example 2: Cart Add Item (Create)

cart_add_item — Create / Low Risk

{
  "tool_name": "cart_add_item",
  "description": "Add a product to the shopping cart",
  "input_schema": {
    "type": "object",
    "properties": {
      "product_id": { "type": "string", "description": "Product identifier" },
      "quantity": { "type": "number", "minimum": 1, "maximum": 99, "description": "Quantity to add" },
      "variant_id": { "type": "string", "description": "Product variant (size, color)" }
    },
    "required": ["product_id", "quantity"]
  },
  "safety": { "execution_type": "create", "risk_level": "low", "idempotent": false, "confirmation_required": false }
}

Example 3: Begin Checkout (Mutate, High Risk)

begin_checkout — Mutate / High Risk ⚠️

{
  "tool_name": "begin_checkout",
  "description": "Start checkout for a validated cart and create a checkout session",
  "input_schema": {
    "type": "object",
    "properties": {
      "cart_id": { "type": "string" },
      "payment_method_id": { "type": "string" },
      "shipping_address_id": { "type": "string" }
    },
    "required": ["cart_id", "payment_method_id", "shipping_address_id"]
  },
  "safety": {
    "execution_type": "mutate",
    "risk_level": "high",
    "idempotent": false,
    "confirmation_required": true,
    "preconditions": ["cart_validated", "inventory_reserved"],
    "postconditions": ["checkout_session_created"],
    "side_effects": ["inventory_locked", "payment_hold_created"]
  }
}

Example 4: Account Delete (Critical)

account_delete — Delete / Critical Risk 🔴

{
  "tool_name": "account_delete",
  "description": "Permanently delete user account and all associated data",
  "input_schema": {
    "type": "object",
    "properties": {
      "account_id": { "type": "string" },
      "confirmation_code": { "type": "string", "description": "User-provided confirmation code" }
    },
    "required": ["account_id", "confirmation_code"]
  },
  "safety": {
    "execution_type": "delete",
    "risk_level": "critical",
    "idempotent": false,
    "confirmation_required": true,
    "approval_required": true,
    "approval_roles": ["admin"],
    "side_effects": ["data_purged", "subscriptions_cancelled", "audit_log_created"]
  }
}

Example 5: Lead Create (CRM)

lead_create — CRM / Low Risk

{
  "tool_name": "lead_create",
  "description": "Create a new sales lead in the CRM",
  "input_schema": {
    "type": "object",
    "properties": {
      "first_name": { "type": "string" },
      "last_name": { "type": "string" },
      "email": { "type": "string", "format": "email" },
      "company": { "type": "string" },
      "source": { "type": "string", "enum": ["web", "referral", "event", "cold_call"] }
    },
    "required": ["first_name", "last_name", "email"]
  },
  "safety": { "execution_type": "create", "risk_level": "low", "idempotent": false, "confirmation_required": false }
}

Example 6: Campaign Schedule (Marketing)

campaign_schedule — Marketing / Medium Risk

{
  "tool_name": "campaign_schedule",
  "description": "Schedule a marketing campaign for future delivery",
  "input_schema": {
    "type": "object",
    "properties": {
      "campaign_id": { "type": "string" },
      "scheduled_at": { "type": "string", "format": "date-time" },
      "timezone": { "type": "string" }
    },
    "required": ["campaign_id", "scheduled_at"]
  },
  "safety": {
    "execution_type": "mutate",
    "risk_level": "medium",
    "idempotent": true,
    "confirmation_required": true,
    "preconditions": ["campaign_approved", "audience_configured"]
  }
}

Example 7: Ticket Escalate (Support)

ticket_escalate — Support / Medium Risk

{
  "tool_name": "ticket_escalate",
  "description": "Escalate a support ticket to a higher tier",
  "input_schema": {
    "type": "object",
    "properties": {
      "ticket_id": { "type": "string" },
      "escalation_reason": { "type": "string" },
      "target_tier": { "type": "string", "enum": ["tier_2", "tier_3", "manager"] }
    },
    "required": ["ticket_id", "escalation_reason", "target_tier"]
  },
  "safety": {
    "execution_type": "mutate",
    "risk_level": "medium",
    "idempotent": false,
    "confirmation_required": false,
    "side_effects": ["notification_sent", "sla_timer_reset"]
  }
}

Example 8: Report Generate (Analytics)

report_generate — Analytics / No Risk

{
  "tool_name": "report_generate",
  "description": "Generate an analytics report with specified parameters",
  "input_schema": {
    "type": "object",
    "properties": {
      "report_type": { "type": "string", "enum": ["revenue", "engagement", "retention", "funnel"] },
      "date_from": { "type": "string", "format": "date" },
      "date_to": { "type": "string", "format": "date" },
      "dimensions": { "type": "array", "items": { "type": "string" } },
      "format": { "type": "string", "enum": ["json", "csv", "pdf"] }
    },
    "required": ["report_type", "date_from", "date_to"]
  },
  "safety": { "execution_type": "read", "risk_level": "none", "idempotent": true, "confirmation_required": false }
}

Example 9: Booking Cancel (Travel)

booking_cancel — Travel / High Risk ⚠️

{
  "tool_name": "booking_cancel",
  "description": "Cancel an existing travel booking",
  "input_schema": {
    "type": "object",
    "properties": {
      "booking_id": { "type": "string" },
      "cancellation_reason": { "type": "string" }
    },
    "required": ["booking_id"]
  },
  "safety": {
    "execution_type": "mutate",
    "risk_level": "high",
    "idempotent": true,
    "confirmation_required": true,
    "side_effects": ["refund_initiated", "inventory_released", "confirmation_email_sent"]
  }
}

Example 10: Interview Schedule (Jobs)

interview_schedule — Jobs / Low Risk

{
  "tool_name": "interview_schedule",
  "description": "Schedule a job interview for a candidate",
  "input_schema": {
    "type": "object",
    "properties": {
      "candidate_id": { "type": "string" },
      "job_id": { "type": "string" },
      "interviewer_ids": { "type": "array", "items": { "type": "string" } },
      "scheduled_at": { "type": "string", "format": "date-time" },
      "duration_minutes": { "type": "number", "minimum": 15, "maximum": 240 }
    },
    "required": ["candidate_id", "job_id", "scheduled_at", "duration_minutes"]
  },
  "safety": {
    "execution_type": "create",
    "risk_level": "low",
    "idempotent": false,
    "confirmation_required": false,
    "side_effects": ["calendar_invites_sent", "candidate_notified"]
  }
}