Azure DevOps Galaxy Sync
Automatically mirror your Azure DevOps work items into Forese.ai's Knowledge Graph, enabling AI-powered semantic search across your entire project portfolio.
How Galaxy Sync Works
Work Items to Entities
Azure DevOps work items are converted to Galaxy entities
Vector Embeddings
Embeddings generated for semantic search
Relationship Sync
Work item links become Galaxy edges
Auto Sync
Changes synced automatically based on interval
Enabling Galaxy Sync
Navigate to Azure DevOps Settings
Go to Settings > Integrations > Azure DevOps and ensure your organization is connected.
Set Sync Mode
Set Sync Mode to either Galaxy Sync Only (only auto sync) or Both (Galaxy sync + manual canvas import).
Enable Auto-Sync
Enable the Auto-Sync toggle. Sync will run periodically based on system schedule.
Save Configuration
Click Save Configuration to start syncing.
Sync Intervals
Active projects with frequent updates
Standard projects (Recommended)
Stable projects with occasional changes
Archive/reference projects
Filter Options
Project Filter
Leave empty for all projects, or select specific Azure DevOps project names.
Work Item Type Filter
Control which work item types sync: Epic, Feature, User Story, Task, Bug.
State Filter
Filter by state: New, Active, Resolved, Closed.
Work Item to Entity Mapping
| Azure DevOps Field | Galaxy Entity Field |
|---|---|
| ID | metadata.azureDevOpsId |
| Title | name |
| Description | content (used for embeddings) |
| Work Item Type | entity_type |
| State | metadata.state |
| Assigned To | metadata.assignedTo |
| Tags | metadata.tags |
| Story Points | metadata.storyPoints |
| Effort | metadata.effort |
| Area Path | metadata.areaPath |
| Iteration Path | metadata.iterationPath |
| Created Date | metadata.created |
| Changed Date | metadata.updated |
Relationship Syncing
Azure DevOps work item links become Galaxy edges:
depends_ondepends_on (reverse)related_topart_ofrelated_toSearching Azure DevOps Content
Once synced, Azure DevOps work items are searchable in Galaxy using natural language queries:
Semantic Search Examples
- "What are the high priority features?"
- "Show me work items related to API security"
- "Find all bugs in the current sprint"
Filter by Source
In Galaxy search, select External to see only Azure DevOps-synced entities, or search all sources for comprehensive results.
Manual Sync Trigger
To sync immediately without waiting for the interval:
Full Sync
Re-sync all work items from scratch
Incremental
Only sync changes since last sync
Project Sync
Sync a specific project only
Monitoring Sync Status
View past sync jobs in Settings > Integrations > Azure DevOps > Sync History:
- Start time
- Status (pending, running, completed, failed)
- Work items processed
- Errors (if any)
Best Practices
Use project filters
Don't sync unnecessary projects to optimize performance.
Match sync frequency
Set sync interval based on how often your project updates.
Keep descriptions updated
Better work item descriptions = better semantic search results.
Use consistent tagging
Tags improve search relevance across the Knowledge Graph.
Link related work items
Azure DevOps links create meaningful Galaxy edges for context.
Monitor sync history
Check for failed syncs and resolve permission issues.
Troubleshooting
Work items not appearing in Galaxy
- Check that Galaxy Sync is enabled
- Verify the sync has run (check sync history)
- Ensure the Azure DevOps project is in your project filter
Sync failed
- Check connection status in Settings
- Review sync history for error details
- Verify Azure DevOps permissions haven't changed
- Try triggering a manual sync
Token expired
- Tokens are automatically refreshed
- If issues persist, disconnect and reconnect Azure DevOps