Complete Guide

Agent Schedules

Learn how to automate portfolio monitoring with pre-configured AI agents. Set up recurring tasks for missing actuals checks, NAV reconciliation, quarterly reports, and more.

01What Are Agent Schedules?

Agent Schedules are pre-configured AI agents that run automatically on recurring schedules. They handle routine portfolio monitoring tasks—checking for missing actuals, reconciling NAV, generating reports—so you don't have to.

Key Benefits

  • Eliminate manual monitoring: No more monthly spreadsheet reviews
  • Catch issues early: Automatic alerts when data is missing or discrepancies exist
  • Ensure data quality: Weekly reconciliation keeps your portfolio accurate
  • Save time: Reports generated automatically, ready for distribution

How It Works

Each schedule runs on a configured timing (daily, weekly, monthly, quarterly). When the schedule triggers, an AI agent executes the task, analyzes your portfolio, and either completes the work silently or alerts you if issues are found.

1

Enable

Toggle on a schedule in the Agents page

2

Customize

Adjust timing, timezone, and thresholds

3

Relax

Agent runs automatically, alerts on issues

02Available Schedules

Nagare provides 6 pre-configured schedules covering the most common portfolio monitoring needs:

MONTHLY

Missing Actuals Check

Identifies funds where quarterly actuals are overdue. Typically, GP statements arrive within 60 days after quarter-end. This schedule alerts you when statements are late.

Default Timing:1st of each month at 9:00 AM UTC
Grace Period:2 months (configurable)
QUARTERLY

Quarterly Wealth Report

Automatically generates comprehensive wealth reports with projections and Monte Carlo analysis. Perfect for LP updates and banking partner communications.

Default Timing:1st of Jan/Apr/Jul/Oct at 8:00 AM UTC
Output Format:PDF (configurable)
WEEKLY

NAV Reconciliation

Compares reported NAV vs calculated NAV across all funds. Flags discrepancies above your configured tolerance threshold (default 1%).

Default Timing:Monday at 7:00 AM UTC
Tolerance:1% (configurable)
WEEKLY

Portfolio Health Summary

End-of-week health digest with key metrics, risk indicators, liquidity analysis, and upcoming events for the next 3 months.

Default Timing:Friday at 5:00 PM UTC
Look-ahead:3 months (configurable)
DAILY

Market Data Sync

Synchronizes public market data for holdings—equity prices, FX rates, indices. Keeps your Monte Carlo simulations calibrated to current market conditions.

Default Timing:Weekdays at 6:00 AM UTC
Data Sources:Prices, FX, Indices
MONTHLY

Commitment Expiry Alert

Monitors fund commitments approaching expiry or investment period end. Provides 90/60/30 day warnings so you can plan capital deployment.

Default Timing:15th of each month at 9:00 AM UTC
Look-ahead:6 months (configurable)

03Enabling & Disabling Schedules

Via Web Interface

1

Navigate to AI Agents page from the sidebar

2

Click the "Scheduled Tasks" tab

3

Find the schedule you want and toggle the switch to enable

4

The schedule starts running automatically on its configured timing

Via API

Enable a Schedule
curl -X POST https://api.nagarehq.com/api/v1/schedules/missing-actuals-check/enable \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"
Disable a Schedule
curl -X POST https://api.nagarehq.com/api/v1/schedules/missing-actuals-check/disable \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY"

04Customizing Timing

Each schedule has a default cron expression, but you can override it to match your organization's workflow. Common customizations include changing the day of week, adjusting the time to your timezone, or running more/less frequently.

Cron Expression Format

┌───────────── minute (0 - 59)
│ ┌─────────── hour (0 - 23)
│ │ ┌───────── day of month (1 - 31)
│ │ │ ┌─────── month (1 - 12)
│ │ │ │ ┌───── day of week (0 - 6, Sunday = 0)
│ │ │ │ │
* * * * *

Common Cron Presets

0 9 * * *

Every day at 9:00 AM

0 9 * * 1

Every Monday at 9:00 AM

0 9 1 * *

First of month at 9:00 AM

0 9 1 1,4,7,10 *

Quarterly at 9:00 AM

Setting Custom Timing via API

Enable with Custom Cron
curl -X POST https://api.nagarehq.com/api/v1/schedules/nav-reconciliation/enable \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cronExpression": "0 8 * * 1",
    "timezone": "America/New_York"
  }'

Pro Tip: Timezone Handling

All cron expressions are interpreted in the specified timezone. If no timezone is provided, UTC is used. Common values: America/New_York, Europe/London, Asia/Tokyo.

05Notification Settings

Each schedule can be configured to send notifications when issues are found. You can customize who receives alerts and under what conditions.

Email Alerts

Receive email notifications when schedules detect issues. Configure recipient email in schedule variables.

In-App Notifications

View all schedule runs and alerts in the Nagare dashboard. Filter by schedule type, status, or date range.

Configuring Alert Variables

Update Schedule Variables
curl -X PUT https://api.nagarehq.com/api/v1/schedules/missing-actuals-check \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vars": {
      "notifyEmail": true,
      "gracePeriodMonths": 3,
      "includeNavMissing": true
    }
  }'

06Viewing Run History

Track all schedule executions with complete audit trail. View run status, timing, outputs, and any errors that occurred.

SUCCESS

Schedule completed without issues

FAILED

Schedule encountered an error

RUNNING

Schedule currently executing

Trigger Manual Run

You can trigger any schedule to run immediately, without waiting for the next scheduled time. Useful for testing or when you need results right now.

Trigger Immediate Run
curl -X POST https://api.nagarehq.com/api/v1/schedules/nav-reconciliation/trigger \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY"

07API Examples

List All Schedules

GET /api/v1/schedules
curl -X GET https://api.nagarehq.com/api/v1/schedules \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY"

Get Schedule Details

GET /api/v1/schedules/:key
curl -X GET https://api.nagarehq.com/api/v1/schedules/quarterly-wealth-report \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY"

Pause & Resume

Pause (keeps config)
curl -X POST https://api.nagarehq.com/api/v1/schedules/market-data-sync/pause \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY"
Resume
curl -X POST https://api.nagarehq.com/api/v1/schedules/market-data-sync/resume \
  -H "Authorization: Bearer fnd_live_YOUR_API_KEY"

08Troubleshooting

Schedule not running

Causes: Schedule is disabled, paused, or the cron expression hasn't triggered yet.

Solution: Check the schedule status in the UI. Verify the cron expression and timezone. Try triggering manually to test.

Not receiving email notifications

Causes: Email notifications not enabled, or the schedule ran without finding issues.

Solution: Verify notifyEmail: true in schedule vars. Check spam folder. Schedules only send alerts when issues are detected.

Schedule shows FAILED status

Causes: API error, data access issue, or timeout.

Solution: Check the error message in run history. Common issues include expired API keys or missing fund data. Contact support if the issue persists.

Ready to Automate Your Portfolio?

Agent Schedules handle routine monitoring automatically. For on-demand questions and analysis, explore Portfolio Companion—our interactive AI agent.