Description
From: lena@dust.tt
Context: Customer feedback on missing granular assistant classification in monthly reports
Background
After the migration to the new assistant sharing framework (April 2025, migration 20250429_update_agent_scopes.ts), the monthly reports "assistants" CSV only shows simplified "settings" values (published/unpublished) instead of the richer classification data now available.
Before migration: Settings showed workspace/published/private distinctions
After migration: Settings only shows published/unpublished (visible/hidden scope mapping)
Customer Impact
Clara from Brevo (and likely other customers) relies on the monthly assistants report to:
- Identify which assistants should be moved to Company folder based on usage
- Understand assistant governance and permissions
- Make data-driven decisions about assistant lifecycle management
The simplified "settings" column no longer provides enough granular information for these use cases.
Proposed Solution
Enhance the monthly assistants CSV export to include additional columns that leverage the new classification system:
New columns to add:
tags- Comma-separated list of tag names (e.g., "Company,Marketing,Beta")has_company_tag- Boolean indicating if assistant has the "Company" tageditor_count- Number of users with edit permissionsscope- Raw scope value (visible/hidden) for transparency
Keep existing:
settingscolumn - Current published/unpublished mapping for backward compatibility
Technical Implementation
The data is readily available in:
agent_configurations.scopefor raw visibilityagent_tag_relations+tagstables for tag informationgroup_agent_relations+groupstables for editor counts
Current implementation in getAssistantsUsageData() function in workspace_usage.ts already has scope mapping logic that can be extended.
Expected Outcome
Customers would have access to the same (and better) granular assistant classification data they had before the migration, enabling them to:
- Continue existing reporting workflows
- Take advantage of the new tag-based classification system
- Make informed decisions about assistant management and governance
