Revamped the Collaboration section

bsyedumar · bsyedumar · commit ab7fa8127b54 · 2025-09-05T23:27:26.000+05:00
diff --git a/docs/agent-collaboration/data-pool/custom-storage.mdx b/docs/agent-collaboration/data-pool/custom-storage.mdx
@@ -50,7 +50,7 @@ Advanced users can use the `API Call` component to communicate directly with Pin
 To configure:
 
 - Add your Pinecone API key from the **Vault**  
-- Use endpoint URLs from [Pinecone's API reference](https://docs.pinecone.io/reference)  
+- Use endpoint URLs from [Pinecone's API reference](https:/docs.pinecone.io/reference)  
 - Pass headers, payloads, and parameters manually  
 
 <WarningCallout title="Vector dimension must be 1536">
diff --git a/docs/agent-collaboration/import-export-postman.mdx b/docs/agent-collaboration/import-export-postman.mdx
@@ -1,54 +1,40 @@
 ---
-title: Export / Import Agents
-description: Quickly test, validate, and import API calls using Postman in your SmythOS workflow.
-keywords: [postman, export agent, import collection, api testing, smythos postman integration]
-toc_max_heading_level: 2
+title: Postman Integration
+description: Export agents to Postman or import Postman collections into SmythOS for quick API testing and integration.
+keywords: [postman, smythos integration, export agent, import collection, api testing]
 sidebar_position: 9
 ---
 
-# How to Export / Import Agents via Postman
+# Postman Integration: Export Agents and Import Collections
 
-Use Postman to test your agent’s endpoints or import external APIs into SmythOS.
+Use Postman to test SmythOS agent endpoints or import external APIs into your workflows.
 
 <Spacer size="md" />
 
-## Export to Postman
+## Export Agents to Postman
 
-- Go to your agent in the Team Dashboard
-- Click the three-dot menu and choose <code>Export to Postman</code>
-- Choose one of the following options:
-
-  - **Test Endpoint Collection**
-    - Uses the test subdomain
-    - Best for local testing or debugging
-
-  - **Prod Endpoint Collection**
-    - Available only after deployment
-    - Uses the production subdomain
-    - Recommended for live monitoring or staging
-
-- Import the downloaded JSON file into Postman
+1. In **Team Dashboard**, open your agent.  
+2. Click the **three-dot menu** → **Export to Postman**.  
+3. Choose a collection:  
+   - **Test**: uses test subdomain, for local testing/debugging.  
+   - **Prod**: available after deployment, uses production subdomain, for staging/monitoring.  
+4. Import the JSON file into Postman.  
 
 <Arcade src="https://demo.arcade.software/CI0fMYdVuulWQlXdLHHo?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Export Agent to Postman | SmythOS" />
 
 <Spacer size="md" />
 
-## Import Postman Collection
-
-Use this to bring external API definitions into your agent.
+## Import Postman Collections
 
-- Go to the <code>Builder</code> view
-- Drag your Postman collection file into the canvas
-- SmythOS will:
-  - Automatically convert each request into an <code>API Call</code> component
-  - Preserve methods, headers, and payloads
+1. In the **Builder** view, drag your Postman JSON file onto the canvas.  
+2. SmythOS converts each request into an **API Call** component, preserving methods, headers, and payloads.  
 
 <Arcade src="https://demo.arcade.software/GTrFqGZF3az6Z128wTrU?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Import Postman Collection | SmythOS" />
 
 <Spacer size="md" />
 
-## Notes
+## Tips
 
-- Only supports JSON Postman format (v2.x recommended)
-- Use descriptive names for requests to keep imported nodes organized
-- You can update URLs and tokens directly inside the imported component
+- Only Postman JSON format is supported (v2.x recommended).  
+- Use clear request names for better organization.  
+- Update URLs and tokens directly in imported components.  
diff --git a/docs/agent-collaboration/overview.mdx b/docs/agent-collaboration/overview.mdx
@@ -1,100 +1,82 @@
 ---
 title: Collaboration
-description: Build, share, and manage agents as a team. Use Project Spaces, a secure Vault, and role-based permissions to collaborate securely and efficiently.
-keywords: [collaboration, teams, sharing, permissions, roles, vault, projects, spaces]
+description: Work together in SmythOS using Spaces, the Vault, and role-based permissions. Share agents, manage data, and collaborate securely in real time.
+keywords: ["SmythOS collaboration", "Spaces", "Vault", "roles and permissions", "Data Pool", "Chat with Agent", "Analytics", "share agents", "team workflows"]
 sidebar_position: 1
 ---
 
 # Agent Collaboration
 
-In SmythOS you can build and run agents on your own or with others.  
-Collaboration features give you a shared place to organise projects, control access, and connect agents to the resources they need.
+Great agents don’t happen in isolation. SmythOS makes it simple for teams to **build, share, and run agents together** while keeping credentials safe and projects organized.
 
-<InfoCallout title="Quick start">
-Create a [Space](/docs/agent-collaboration/spaces/), add your team, set [roles](/docs/account-management/user-management), and store any credentials in the [Vault](/docs/agent-studio/key-concepts/vault).
+<InfoCallout title="In one line">
+Create a [Space](/docs/agent-collaboration/spaces/), invite your team, store keys in the [Vault](/docs/agent-studio/key-concepts/vault), and collaborate with agents in real time.
 </InfoCallout>
-<Spacer size="md" />
 
-## How Collaboration Works in SmythOS
+<Spacer size="md" />
 
-A [space](/docs/agent-collaboration/spaces/) is the main workspace for teamwork.  
-It holds your agents, data, workflows, and settings.  
-Within a space you can:
+## Why Collaboration Matters
 
-- Keep each project or client separate  
-- Invite and remove members at any time  
-- Control exactly what each person can do  
-- Chat with agents and test ideas together in real time  
+Agents become more powerful when they’re connected to shared data, tested by multiple people, and managed with clear roles.  
+SmythOS gives you the structure to do that without losing control:
 
-[Permissions](/docs/account-management/user-management) are role-based and set per space.  
-This keeps sensitive work protected while allowing others to contribute where needed.
-<Spacer size="md" />
+- Keep client or project work separated into **[Spaces](/docs/agent-collaboration/spaces/)**  
+- Control access with **[Roles and Permissions](/docs/account-management/user-management)**  
+- Secure API keys in the **[Vault](/docs/agent-studio/key-concepts/vault)**  
+- Share knowledge through the **[Data Pool](/docs/agent-collaboration/data-pool/data-spaces)**  
+- Work directly with agents using **[Chat with Agent](/docs/agent-collaboration/chat-with-agent)**  
+- Monitor usage and costs with **[Analytics](/docs/account-management/user-management)**  
+- Export, share, or [move agents across projects](/docs/agent-collaboration/sharing-agents)  
+- Apply your own [branding with White Labeling](/docs/agent-collaboration/spaces/white-labeling)  
 
-## Main Tools for Teamwork
+This creates a single place where your whole team can work confidently, whether you’re a startup, an agency, or an enterprise.
 
-| Tool | Purpose | Best For |
-|------|---------|----------|
-| **[Spaces](/docs/agent-collaboration/spaces/)** | Create separate environments for agents, data, and members | Agencies, multi-project teams |
-| **[Vault](/docs/agent-studio/key-concepts/vault)** | Encrypted storage for API keys and secrets | Any team using third-party services |
-| **[Roles & Permissions](/docs/account-management/user-management)** | Set what each member can view or change | Teams with mixed responsibilities |
-| **[Sharing & Exporting](/docs/agent-collaboration/sharing-agents)** | Share agents or import/export workflows | Distributed or partner teams |
-| **[White Labeling](/docs/agent-collaboration/spaces/white-labeling)** | Apply your own branding per space | Client-facing or reseller workspaces |
+<Image 
+  src="/docs/img/agent_collaboration/agent-collaboration.png" 
+  alt="Agent dashboard in a SmythOS Space showing shared agents, data, and collaboration tools" 
+  caption="Work together in a Space to manage agents, share resources, and keep everything organized in one dashboard." 
+/>
 
 <Spacer size="md" />
-## Setting Up Your First Collaborative Project
 
-1. **Create a space**  
-   Go to the [Spaces page](/docs/agent-collaboration/spaces/) and click **Create Space**.  
-   Give it a clear name, choose the right branding if needed, and decide who will join.  
-   You can add members now or later.
+## Core Building Blocks
 
-2. **Invite your team**  
-   Use [Invite Members](/docs/agent-collaboration/spaces/invite-members) or add them when [sharing an agent](/docs/agent-collaboration/sharing-agents).
+| Building Block | What It Does | Why It Matters |
+|----------------|--------------|----------------|
+| **[Spaces](/docs/agent-collaboration/spaces/)** | Project-based workspaces for agents, data, and teammates | Keep projects separate but easy to manage |
+| **[Roles & Permissions](/docs/account-management/user-management)** | Assign Viewer, Editor, Admin, or Super Admin | Stay secure while enabling collaboration |
+| **[Vault](/docs/agent-studio/key-concepts/vault)** | Encrypted key and secret storage | Share API credentials safely across agents |
+| **[Data Pool](/docs/agent-collaboration/data-pool/data-spaces)** | Shared datasets and knowledge sources | Give agents collective memory |
+| **[Chat with Agent](/docs/agent-collaboration/chat-with-agent)** | Real-time collaboration and testing | Explore, debug, and iterate together |
+| **[Analytics](/docs/account-management/user-management)** | Track token usage and costs | Stay in control of performance and spend |
+| **[Sharing & Exporting](/docs/agent-collaboration/sharing-agents)** | Move workflows between projects | Flexible handoff and portability |
+| **[White Labeling](/docs/agent-collaboration/spaces/white-labeling)** | Apply custom branding to spaces | Perfect for client-facing work |
 
-3. **Assign roles**  
-   Choose `Viewer`, `Editor`, `Admin`, or `Super Admin` based on what each person needs to do.  
-   See the [Roles and Permissions guide](/docs/account-management/user-management) for details.
+<Spacer size="md" />
+
+## How to Get Started
 
-4. **Add credentials to the Vault**  
-   This lets agents connect to services like OpenAI or Google without exposing the keys.
+1. **[Create a Space](/docs/agent-collaboration/spaces/)** → Organize your first project or client.  
+2. **[Invite Teammates](/docs/agent-collaboration/spaces/invite-members)** → Add members and assign roles.  
+3. **[Assign Roles](/docs/account-management/user-management)** → Decide who can view, edit, or deploy.  
+4. **[Secure Credentials in the Vault](/docs/agent-studio/key-concepts/vault)** → Store API keys safely for shared use.  
+5. **[Add Data to the Pool](/docs/agent-collaboration/data-pool/data-spaces)** → Give agents a shared knowledge base.  
+6. **[Collaborate with Agents](/docs/agent-collaboration/chat-with-agent)** → Test and debug in real time.  
+7. **[Track Analytics](/docs/account-management/user-management)** → Monitor usage, performance, and costs.  
 
-5. **Start building and testing together**  
-   Use [Team Spaces Chat](/docs/agent-collaboration/spaces/team-spaces-chat) or [Chat with Agent](/docs/agent-collaboration/chat-with-agent) to collaborate in real time.
+<TipCallout title="Next step">
+Head over to [Spaces](/docs/agent-collaboration/spaces/) and set up your first collaborative project.
+</TipCallout>
 
 <Spacer size="md" />
 
-## Where to Go Next
+## Explore Collaboration Features
 
 <CardGrid>
-  <Card
-    title="Spaces"
-    description="Create and manage secure workspaces for your agents and data."
-    to="/docs/agent-collaboration/spaces/"
-  />
-  <Card
-    title="Invite Members"
-    description="Add people to your space and assign roles."
-    to="/docs/agent-collaboration/spaces/invite-members"
-  />
-  <Card
-    title="Roles and Permissions"
-    description="Understand and configure role-based access."
-    to="/docs/account-management/user-management"
-  />
-  <Card
-    title="The Vault"
-    description="Store and share API keys without exposing them."
-    to="/docs/agent-studio/key-concepts/vault"
-  />
-  <Card
-    title="Sharing & Exporting"
-    description="Share agents with others or move workflows between tools."
-    to="/docs/agent-collaboration/sharing-agents"
-  />
-  <Card
-    title="White Labeling"
-    description="Apply your own branding to a space."
-    to="/docs/agent-collaboration/spaces/white-labeling"
-  />
+  <Card title="Spaces" description="Create and manage workspaces for your agents and data." to="/docs/agent-collaboration/spaces/" />
+  <Card title="Roles and Permissions" description="Understand and configure role-based access." to="/docs/account-management/user-management" />
+  <Card title="Data Pool" description="Build shared knowledge bases for your agents." to="/docs/agent-collaboration/data-pool/data-spaces" />
+  <Card title="Chat with Agent" description="Collaborate and test in real time." to="/docs/agent-collaboration/chat-with-agent" />
+  <Card title="Analytics" description="Track usage and costs for each project." to="/docs/account-management/user-management" />
+  <Card title="Sharing & Exporting" description="Share agents or move workflows between tools." to="/docs/agent-collaboration/sharing-agents" />
 </CardGrid>
-
