# MS Viva Engage Agent

### What Can You Do?

Once connected, the MS Viva Engage Agent lets you:

* **Find Communities & Posts**: Search across all Viva Engage communities and discover relevant posts and discussions
* **Read & Analyze Conversations**: Get summaries of discussion threads, extract key insights, and identify trending topics
* **Monitor Your Feed**: Stay updated with your personalized feed and track important organizational communications
* **Discover Users & Experts**: Find subject matter experts, active contributors, and networking opportunities within communities
* **Extract Knowledge**: Identify best practices, solutions, and organizational updates shared across communities

### Quick Setup

#### Step 1: **Select MS Viva Engage Agent**

1. In any Blockbrain conversation, click the **AI Model selection** dropdown
2. Click **"Show detailed AI model list"**
3. Find and click **"MS Viva Engage Agent"**
4. Look for **"Configure"** under the Status column

#### **Step 2: Connect to MS Viva Engage**

1. Click **"Configure"**
2. Click the **"Connect"** button
3. Sign in with your Microsoft account when prompted
4. Click **"Accept"** to allow Blockbrain to access your Viva Engage data.

#### Step 3: Start Using Viva Engage

That's it! You can now ask Blockbrain about your Viva Engage communities, posts, discussions, and more.

### What You Can Ask

#### **Finding Communities & Posts**

```
"List all Viva Engage communities I have access to"
"Search for posts about 'remote work policies' in the last month"
"Show me recent posts in the Engineering community"  
```

#### **Reading & Analyzing Conversations**

```
"Summarize the discussion about Q3 planning in the Leadership community"
"What are the key insights from posts about 'digital transformation'?"
"Extract action items from the HR community discussions this week"  
```

#### **Monitoring Your Feed**

```
"Show me the latest posts in my personalized feed"
"What are the trending topics in my feed today?"
"Find important announcements in my recent feed"  
```

#### **Discovering Users & Experts**

```
"Who are the most active users in the Marketing community?"
"Find experts discussing 'cloud migration' across communities"
"Get details for user jane.smith@company.com"  
```

#### **Extracting Knowledge**

```
"Find best practices shared about project management"
"What solutions have been discussed for customer onboarding?"
"Show me organizational updates from the last week"  
```

### How It Works

**Your Access = Blockbrain's Access**

* Blockbrain can only see Viva Engage posts and communities you can access
* If you can't view a post or community, neither can Blockbrain
* Your permissions stay exactly the same

**Safe and Secure**

* Your data remains in Viva Engage
* Blockbrain reads and analyzes only as instructed - no unauthorized posting or changes
* All access is logged in your organization's audit trail

### Tips for Better Results

#### Be Specific

**False:** "Find my post"\
**Correct:** "Search for posts about 'Q3 budget planning' in the Finance community"

#### **Use Keywords and Topics**

**False:** "Show me discussions"\
**Correct:** "Show me all recent posts about 'remote work policies' in the HR community"

#### Mention **Communities and Context**

**False:** "Find the conversation"\
**Correct:** "Find posts in the **Engineering** community about 'API deployment guidelines'"

### Troubleshooting

**"I can't find my post or community"**

* Check if you can see the post or community directly in Viva Engage
* Try using different search terms (e.g., part of the post content, author name, or community name)
* The post might be in a community you don't have access to

**"Permission denied" errors**

* Your Viva Engage permissions may have changed
* Contact your IT team to verify your community access
* Try reconnecting the agent

**"No communities or posts found"**

* You might not have access to any Viva Engage communities
* Check with your administrator about Viva Engage licensing
* Verify you're signed in with the correct Microsoft account

### Privacy and Security

* **Respecting Permissions**: Blockbrain can only access Viva Engage posts and communities you have permission to view
* **No Unauthorized Changes**: Blockbrain only reads and analyzes content—no posting, commenting, or editing without your instruction
* **No Storage**: Blockbrain doesn't store copies of your posts, comments, or community discussions

### Common Use Cases

**Community & Discussion Management**

* Quickly list all your Viva Engage communities
* Search for posts across communities using keywords
* Monitor your personalized feed for important updates

**Content & Knowledge Analysis**

* Summarize lengthy discussion threads and conversations
* Extract action items and decisions from community posts
* Identify trending topics and organizational announcements

**User & Network Discovery**

* Find subject matter experts in specific communities
* Get user details for collaboration and networking
* Identify active contributors and thought leaders

### Example Conversation

**You:** "Search for posts about 'project management tools' in the IT community"

**Blockbrain:**"Here are recent posts about project management tools in the IT community:

* Discussion on Agile management platform evaluation (15 replies)
* Best practices for remote team coordination (8 likes)
* Integration tips for development workflows (3 shares)

Which discussion would you like to explore in detail?"

**You:** "Show me the details from the Agile platform discussion"

**Blockbrain:** *Provides comprehensive summary with key insights, participant recommendations, and action items from the discussion*

### Next Steps

Want to connect more services? Try the [OneNote Agent](/for-users/agents/onenote-agent.md) to access your notebooks, organize your notes, and manage all your OneNote content directly through Blockbrain.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.blockbrain.ai/for-users/agents/ms-viva-engage-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
