Goal
Retrieve voice profile details (tone, style, vocabulary, dos/donts, examples) to understand the brand voice before creating content. This is a foundational context tool for maintaining brand consistency.
Which Agents Use This
- content_creator — Load exact tone and style before drafting
- reviewer — Use as reference to validate drafts against
- engagement — Match brand voice in replies
- All content-related agents need voice profile for consistency
Hard Rules
- MUST validate voice_profile_id exists and belongs to workspace
- SHOULD include tone settings, dos/donts, vocabulary rules, and examples
- Cache voice profiles for performance (updates are infrequent)
Steps
1. Validate voice profile access
- Verify voice_profile_id exists
- Verify voice_profile belongs to workspace
2. Load voice profile
- Query VoiceProfile model
- Include all tone settings, rules, vocabulary, examples
3. Return structured voice data
- Tone settings (playful, professional, direct, thoughtful)
- Dos and donts
- Vocabulary preferences
- Example posts demonstrating the voice
Output
{
"success": true,
"voice_profile_id": "uuid",
"name": "Bolta Brand Voice",
"description": "Bold, founder-led voice...",
"tone": {
"playful": 3,
"professional": 7,
"direct": 9,
"thoughtful": 6
},
"dos": ["Lead with outcomes", "Use short sentences", "Be specific"],
"donts": ["No corporate jargon", "Avoid 'leverage'", "No passive voice"],
"vocabulary": {
"prefer": ["use", "build", "ship", "create"],
"avoid": ["leverage", "utilize", "synergy", "optimize"]
},
"examples": [
{
"text": "We built this in 2 weeks. You can too.",
"explanation": "Direct, specific, outcome-focused"
}
]
}
Failure Handling
- If voice_profile_id not found: return error "Voice profile not found"
- If voice_profile not in workspace: return error "Access denied"
Example Usage
Scenario: Content creator loading voice before drafting
{
"voice_profile_id": "uuid"
}
Result: Receive complete voice profile to match tone, style, and vocabulary in content
1---2name: bolta-get-voice-profile3version: 2.0.04description: Retrieve voice profile details including tone, style, vocabulary, dos/donts to understand brand voice before creating content5category: content6roles_allowed: [Viewer, Creator, Editor, Admin]7agent_types: [content_creator, reviewer, engagement, custom]8safe_defaults: {}9tools_required: []10inputs_schema:11 type: object12 required: [voice_profile_id]13 properties:14 voice_profile_id: { type: string, description: "Voice profile UUID" }15outputs_schema:16 type: object17 properties:18 success: { type: boolean }19 voice_profile_id: { type: string }20 name: { type: string }21 description: { type: string }22 tone: { type: object }23 dos: { type: array, items: { type: string } }24 donts: { type: array, items: { type: string } }25 vocabulary: { type: object }26 examples: { type: array, items: { type: object } }27organization: bolta.ai28author: Bolta Team29---3031## Goal32Retrieve voice profile details (tone, style, vocabulary, dos/donts, examples) to understand the brand voice before creating content. This is a **foundational context tool** for maintaining brand consistency.3334## Which Agents Use This35- **content_creator** — Load exact tone and style before drafting36- **reviewer** — Use as reference to validate drafts against37- **engagement** — Match brand voice in replies38- All content-related agents need voice profile for consistency3940## Hard Rules411. MUST validate voice_profile_id exists and belongs to workspace422. SHOULD include tone settings, dos/donts, vocabulary rules, and examples433. Cache voice profiles for performance (updates are infrequent)4445## Steps4647### 1. Validate voice profile access48- Verify voice_profile_id exists49- Verify voice_profile belongs to workspace5051### 2. Load voice profile52- Query VoiceProfile model53- Include all tone settings, rules, vocabulary, examples5455### 3. Return structured voice data56- Tone settings (playful, professional, direct, thoughtful)57- Dos and donts58- Vocabulary preferences59- Example posts demonstrating the voice6061## Output62```json63{64 "success": true,65 "voice_profile_id": "uuid",66 "name": "Bolta Brand Voice",67 "description": "Bold, founder-led voice...",68 "tone": {69 "playful": 3,70 "professional": 7,71 "direct": 9,72 "thoughtful": 673 },74 "dos": ["Lead with outcomes", "Use short sentences", "Be specific"],75 "donts": ["No corporate jargon", "Avoid 'leverage'", "No passive voice"],76 "vocabulary": {77 "prefer": ["use", "build", "ship", "create"],78 "avoid": ["leverage", "utilize", "synergy", "optimize"]79 },80 "examples": [81 {82 "text": "We built this in 2 weeks. You can too.",83 "explanation": "Direct, specific, outcome-focused"84 }85 ]86}87```8889## Failure Handling90- If voice_profile_id not found: return error "Voice profile not found"91- If voice_profile not in workspace: return error "Access denied"9293## Example Usage9495### Scenario: Content creator loading voice before drafting96```json97{98 "voice_profile_id": "uuid"99}100```101**Result:** Receive complete voice profile to match tone, style, and vocabulary in content
boltaai