> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chicago.global/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Portfolio Builder

> Master natural language portfolio construction using AI-powered optimization and institutional-grade methodology

<Note>
  **AI Technology:** The Portfolio Builder uses Anthropic's Claude API for natural language understanding combined with our proprietary quantitative optimization models and factor analysis engine to translate investment ideas into mathematically optimized portfolios.
</Note>

**Build sophisticated portfolios using plain English.** The AI Portfolio Builder translates your investment ideas into mathematically optimized portfolios, combining the intuitive power of natural language with rigorous quantitative methods.

Instead of manually researching, selecting, and weighting hundreds of securities, simply describe your investment thesis in natural language. Our AI interprets your goals, applies institutional-grade optimization techniques, and generates allocation-ready portfolios with clear rationale.

## The Science Behind AI Portfolio Construction

### Bridging Human Intuition and Mathematical Optimization

Traditional portfolio construction requires extensive quantitative knowledge. You need to understand correlation matrices, covariance calculations, and optimization algorithms.

The AI Builder democratizes this process by translating natural language investment ideas into mathematical frameworks.

**The Process**:

<Steps>
  <Step title="Natural Language Processing">
    AI interprets your investment thesis, constraints, and objectives
  </Step>

  <Step title="SQL Matching & Validation">
    Natural language queries matched to structured SQL queries to ensure reproducible output and mitigate hallucination
  </Step>

  <Step title="Universe Construction">
    Identifies relevant securities based on your validated criteria
  </Step>

  <Step title="Factor Analysis">
    Evaluates holdings across multiple risk factors using Fama-French based models updated for real-time data
  </Step>

  <Step title="Mathematical Optimization">
    Applies modern portfolio theory including Black-Litterman, Risk Parity, and other academic optimization methods
  </Step>

  <Step title="Constraint Integration">
    Respects your specified limits and preferences
  </Step>
</Steps>

### Academic Foundations

| Theory                         | Description                                                                                           |
| ------------------------------ | ----------------------------------------------------------------------------------------------------- |
| **Modern Portfolio Theory**    | Harry Markowitz's groundbreaking work on efficient portfolios—maximizing return for given risk levels |
| **Black-Litterman Model**      | Combines market equilibrium with investor views to generate more intuitive portfolio recommendations  |
| **Factor Investing Framework** | Eugene Fama and Kenneth French's research on systematic factors that drive returns                    |
| **Risk Parity Theory**         | Ray Dalio's approach to balancing risk contribution rather than dollar amounts                        |

## Understanding Natural Language Processing

### How AI Interprets Investment Ideas

The AI Builder uses advanced natural language understanding to extract:

| Element                   | Examples                                                                        |
| ------------------------- | ------------------------------------------------------------------------------- |
| **Investment Objectives** | Growth, income, capital preservation, wealth building                           |
| **Risk Tolerance**        | Conservative, moderate, aggressive, or specific volatility targets              |
| **Time Horizon**          | Short-term (less than 2 years), medium-term (2-10 years), long-term (10+ years) |
| **Constraints**           | ESG requirements, sector preferences, geographic limits                         |
| **Factor Preferences**    | Value, growth, momentum, quality, defensive characteristics                     |

### The Translation Process

**Example Input**: "Create a \$50,000 growth portfolio focused on technology and healthcare innovation with moderate risk tolerance for a 10-year time horizon, avoiding tobacco and fossil fuel companies."

**AI Interpretation**:

* Investment amount: \$50,000
* Objective: Growth-focused returns
* Sector preference: Technology and healthcare
* Theme: Innovation/disruption
* Risk level: Moderate (target volatility 12-15%)
* Time horizon: Long-term (10 years)
* ESG constraint: Exclude tobacco and fossil fuels
* Optimization goal: Maximize risk-adjusted returns subject to constraints

## Getting Started with Natural Language Prompts

### Basic Prompt Structure

**Effective prompts typically include**:

1. **Investment Amount**: Specify portfolio size for proper allocation
2. **Primary Objective**: Growth, income, stability, or balanced
3. **Risk Tolerance**: Conservative, moderate, aggressive, or specific metrics
4. **Time Horizon**: Investment timeline affects asset selection
5. **Preferences/Constraints**: Sectors, themes, geography, ESG considerations

### Starter Prompt Templates

<AccordionGroup>
  <Accordion title="Growth-Focused Portfolios">
    ```
    "Create a $100,000 aggressive growth portfolio targeting technology
    innovation and emerging markets, with high risk tolerance and a
    15-year time horizon."
    ```

    **AI Focus**: High-growth sectors, emerging market exposure, higher volatility tolerance

    ```
    "Build a growth portfolio emphasizing artificial intelligence,
    robotics, and clean energy companies for someone comfortable
    with substantial volatility."
    ```

    **AI Focus**: Thematic exposure, disruptive technologies, higher risk/reward profile
  </Accordion>

  <Accordion title="Income-Oriented Portfolios">
    ```
    "Generate a $75,000 dividend-focused portfolio for retirement income,
    emphasizing stability and quarterly distributions with low to moderate risk."
    ```

    **AI Focus**: Dividend-paying stocks, REITs, utilities, consumer staples, lower volatility

    ```
    "Create a high-yield portfolio balancing dividend stocks and REITs,
    targeting 4-5% annual income with some potential for capital appreciation."
    ```

    **AI Focus**: Yield optimization, income sustainability analysis
  </Accordion>

  <Accordion title="Balanced and Strategic Portfolios">
    ```
    "Build a $200,000 balanced portfolio for a 35-year-old professional
    saving for retirement, combining growth and stability with
    international diversification."
    ```

    **AI Focus**: Age-appropriate allocation, domestic/international balance

    ```
    "Design a defensive portfolio that can weather economic uncertainty
    while providing modest growth, emphasizing quality companies and
    avoiding cyclical sectors."
    ```

    **AI Focus**: Quality factors, defensive characteristics, recession resilience
  </Accordion>

  <Accordion title="Factor-Based Portfolios">
    ```
    "Create a value-investing portfolio following Warren Buffett's principles,
    focusing on undervalued quality companies with strong competitive moats."
    ```

    **AI Focus**: Value factors, quality metrics, competitive advantages

    ```
    "Build a momentum portfolio capturing trending stocks and sectors
    while managing drawdown risk through diversification."
    ```

    **AI Focus**: Momentum factors, trend analysis, risk management
  </Accordion>
</AccordionGroup>

### Advanced Prompt Engineering

#### Multi-Objective Optimization

```
"Create a $150,000 portfolio with three goals: ESG compliance with high
environmental scores, international diversification across developed and
emerging markets, and factor balance between growth and value. Target
moderate risk for a 20-year horizon."
```

#### Constraint-Heavy Portfolios

```
"Build a portfolio excluding: all fossil fuel companies, tobacco, weapons
manufacturers, and companies with poor labor practices. Focus on: renewable
energy, sustainable agriculture, educational technology, and healthcare
innovation. Target moderate growth with below-average volatility."
```

## Understanding AI Responses

### Response Structure

AI-generated portfolios typically include:

| Component                | Description                                          |
| ------------------------ | ---------------------------------------------------- |
| **Executive Summary**    | Investment thesis and key characteristics            |
| **Detailed Holdings**    | Individual securities with allocations and rationale |
| **Risk/Return Profile**  | Expected performance and volatility estimates        |
| **Factor Analysis**      | Exposure to key investment factors                   |
| **Implementation Notes** | Practical considerations for execution               |

### Interpreting Allocations

**Portfolio Weights**:

* Large positions (over 5%): High-conviction ideas aligned with thesis
* Medium positions (2-5%): Diversification and factor balance
* Small positions (under 2%): Tactical exposures or constraints-driven

### Factor Exposure Analysis

```
Generated Portfolio Factor Analysis:
Market Beta: 1.15 (15% more volatile than market)
Value Factor: -0.2 (slight growth tilt)
Size Factor: 0.3 (modest small-cap exposure)
Momentum Factor: 0.8 (strong momentum characteristics)
Quality Factor: 0.6 (above-average quality)
Defensive Factor: -0.1 (slightly aggressive positioning)
```

**Interpretation**: This portfolio emphasizes momentum and quality while maintaining growth characteristics—consistent with a growth-oriented investment thesis.

## Refining and Iterating

### Continuous Improvement Process

Portfolio construction is iterative. Use these techniques to refine AI suggestions:

**Feedback and Adjustment**:

```
Initial: "Create a tech-focused growth portfolio"
Refinement: "The portfolio seems too concentrated in large-cap tech.
Add some mid-cap innovation companies and reduce the Apple/Microsoft weighting."
Further: "Good balance now, but can we add some international tech exposure?"
```

**Risk Adjustment**:

```
Initial Portfolio: 18% expected volatility
Adjustment: "This seems too aggressive for my moderate risk tolerance.
Can we reduce volatility to around 12-14% while maintaining the growth focus?"
```

## Integration with Investment Process

### From Builder to Analyzer

Every AI-generated portfolio can be immediately analyzed:

1. **Generate Portfolio**: Use natural language to create allocation
2. **Instant Analysis**: Automatically analyze risk, return, and factor characteristics
3. **Optimization Review**: Understand strengths and potential improvements
4. **Implementation Planning**: Get specific trade recommendations

### Connecting to Research

**From Chat to Builder**:

```
Chat Insight: "Clean energy sector showing strong momentum with supportive policy"
Builder Prompt: "Create a clean energy portfolio capitalizing on current momentum
while managing regulatory and technology risks"
```

**From Screener to Builder**:

```
Screener Results: Found 25 high-quality dividend stocks in defensive sectors
Builder Prompt: "Build a portfolio using these screened stocks, optimized for
income and stability with appropriate diversification"
```

## Advanced Use Cases

### Lifecycle Investing

<CardGroup cols={2}>
  <Card title="Young Professional (25)" icon="user">
    "Create an aggressive growth portfolio for someone 25 years old with 40 years until retirement and high risk tolerance"
  </Card>

  <Card title="Mid-Career (45)" icon="briefcase">
    "Design a balanced portfolio for a 45-year-old focusing on wealth accumulation with moderate risk management"
  </Card>

  <Card title="Pre-Retirement (60)" icon="house">
    "Build a capital preservation portfolio for someone 5 years from retirement, emphasizing income and stability"
  </Card>

  <Card title="Goal-Based" icon="graduation-cap">
    "Create a portfolio to fund college expenses in 10 years, balancing growth potential with certainty of funds"
  </Card>
</CardGroup>

### Institutional-Style Strategies

**Factor Investing Implementation**:

```
"Create a multi-factor portfolio systematically capturing value, momentum,
and quality factors while maintaining broad diversification and managing turnover"
```

**Risk Parity Approach**:

```
"Build a risk parity portfolio where each major asset class contributes
equally to overall portfolio risk, not dollar allocation"
```

## Best Practices and Common Pitfalls

### Effective Prompt Writing

* **Be Specific About Constraints**: Vague preferences lead to generic portfolios
* **Include Context**: Market views, personal situation, and investment experience matter
* **Specify Success Metrics**: How will you measure if the portfolio meets objectives?
* **Consider Implementation**: Include practical constraints like account types, tax implications

### Avoiding Common Mistakes

<Warning>
  **Over-Complexity**: Simple, well-executed strategies often outperform complex ones

  **Chasing Performance**: Don't build portfolios based solely on recent winners

  **Ignoring Costs**: Factor in transaction costs, expense ratios, and tax implications

  **Perfect Portfolio Fallacy**: No portfolio is perfect for all market conditions
</Warning>

## Troubleshooting

| Issue                     | Cause                                | Solution                                                     |
| ------------------------- | ------------------------------------ | ------------------------------------------------------------ |
| **Generic Portfolios**    | Criteria too broad                   | Provide more specific constraints and preferences            |
| **Over-Concentration**    | Too much weight in single securities | Add diversification constraints or risk limits               |
| **Misaligned Risk Level** | Volatility doesn't match tolerance   | Specify numerical targets (e.g., "target 10-12% volatility") |
| **Poor Factor Balance**   | Extreme factor exposures             | Request more balanced factor exposure or specific targets    |

***

## Next Steps

* **[Portfolio Analyzer](/console/analyzer)**: Deep quantitative analysis of AI-generated allocations
* **[Stock Screener](/console/screener)**: Find specific securities to include in portfolios
* **[Methodology](/methodology/overview)**: Complete investment process workflows