Signals

AI-generated strategic insights for leads

Signals are AI-generated insights that highlight key information, opportunities, and risks for each lead.

What Are Signals?

Signals extract and surface important information from lead data:

• Opportunities - Potential advantages or timing windows
• Risks - Concerns or red flags to address
• Insights - Key facts and context
• Recommendations - Suggested actions

Signal Structure

interface Signal {
  id: string;
  leadId: string;
  type: 'opportunity' | 'risk' | 'insight' | 'recommendation';
  title: string;
  content: string;
  confidence: number;      // 0-100
  citations: string[];     // Source references
  model: string;           // AI model used
  generatedAt: number;
}

Example Signals

Opportunity

{
  "type": "opportunity",
  "title": "Expedited Timeline",
  "content": "Project has aggressive Q2 completion target, suggesting urgency for vendor selection.",
  "confidence": 85
}

Risk

{
  "type": "risk",
  "title": "Budget Uncertainty",
  "content": "Funding source not yet confirmed. May delay decision timeline.",
  "confidence": 72
}

Insight

{
  "type": "insight",
  "title": "Key Decision Maker",
  "content": "VP of Development has final authority. Previously worked with competitor.",
  "confidence": 90
}

Generating Signals

Signals are generated during augmentation or on-demand:

curl -X POST "https://api.adaptengine.com/api/v1/leads/{leadId}/signals/regenerate" \
  -H "Authorization: Bearer YOUR_TOKEN"

Fetching Signals

Get all signals for a lead:

curl "https://api.adaptengine.com/api/v1/leads/{leadId}/signals" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response:

{
  "ok": true,
  "data": {
    "signals": [
      {
        "id": "sig_abc123",
        "type": "opportunity",
        "title": "Expedited Timeline",
        "content": "...",
        "confidence": 85,
        "generatedAt": 1706623200000
      }
    ],
    "generatedAt": 1706623200000,
    "model": "gpt-4.1"
  }
}

Confidence Scoring

Confidence indicates AI certainty (0-100):

Range	Meaning
90-100	Very high confidence, well-supported
70-89	High confidence, likely accurate
50-69	Moderate confidence, verify important details
< 50	Low confidence, treat as speculation

Signal Versioning

Signals are versioned - regenerating creates a new version while preserving history.

API Endpoints

Method	Endpoint	Description
GET	/api/v1/leads/{leadId}/signals	Get current signals
POST	/api/v1/leads/{leadId}/signals/regenerate	Regenerate signals
GET	/api/v1/leads/{leadId}/signals/history	Get signal history