agent-invocation-reference

Agent Invocation Reference — Quick Patterns

This is a reference guide showing exactly how to invoke agents with full logging, including copy-paste command templates.

Quick Copy-Paste Setup

Template 1: One-Off Design Session

# Step 1: Set env vars
$env:SOLIDWORKS_MCP_ENABLE_DB_LOGGING = "true"
$env:SOLIDWORKS_MCP_CONVERSATION_ID = "SESSION_NAME_HERE"
$env:SOLIDWORKS_MCP_RUN_ID_PREFIX = "SESSION_NAME_HERE"

# Example:
$env:SOLIDWORKS_MCP_CONVERSATION_ID = "baseball-bat-rebuild"
$env:SOLIDWORKS_MCP_RUN_ID_PREFIX = "bat-initial"

# Step 2: Start server
.\dev-commands.ps1 dev-run

# Step 3: In VS Code Copilot Chat, ask:
# @solidworks-part-reconstructor: Open the Baseball Bat sample, 
# classify the feature family, and show me the first 10 tool calls 
# needed to rebuild it.

Template 2: Multi-Turn Interactive Session

# Terminal 1: Start server with logging
$env:SOLIDWORKS_MCP_ENABLE_DB_LOGGING = "true"
$env:SOLIDWORKS_MCP_CONVERSATION_ID = "u-joint-assembly"
.\dev-commands.ps1 dev-run

# Terminal 2: Run interactive script
.\.venv\Scripts\python.exe .\scripts\interactive_design.py

interactive_design.py:

import os
from src.solidworks_mcp.agents import (
    insert_conversation_event,
    find_run_timeline,
)

session_id = "u-joint-assembly"
os.environ["SOLIDWORKS_MCP_ENABLE_DB_LOGGING"] = "true"
os.environ["SOLIDWORKS_MCP_CONVERSATION_ID"] = session_id

for pass_num in range(1, 3):
    run_id = f"ujoint-pass-{pass_num}"
    os.environ["SOLIDWORKS_MCP_RUN_ID_PREFIX"] = run_id
    
    print(f"\n=== Pass {pass_num} ===")
    print("Use Claude Code to run tool calls.")
    print(f"Session ID: {session_id}")
    print(f"Run ID: {run_id}")
    
    input("Press Enter when done with this pass...")
    
    timeline = find_run_timeline(run_id)
    print(f"Logged {len(timeline['events'])} events in pass {pass_num}.")

Template 3: Batch Test of Sample Parts

# Test all sample parts with logging
$env:SOLIDWORKS_MCP_ENABLE_DB_LOGGING = "true"

@("Paper Airplane", "Baseball Bat", "U-Joint\pin") | ForEach-Object {
    $part_name = $_
    $env:SOLIDWORKS_MCP_CONVERSATION_ID = "batch-test-$part_name"
    $env:SOLIDWORKS_MCP_RUN_ID_PREFIX = "classify-$part_name"
    
    Write-Host "Testing: $part_name"
    .\.venv\Scripts\python.exe -c `
        "from src.solidworks_mcp.agents import find_conversation_events; `
         print(f'Logged: {len(find_conversation_events(\"batch-test-$part_name\"))} events')"
}