Admin Overview

The Admin section of PebbleAI provides organization administrators with powerful tools to manage users, configure AI capabilities, monitor usage, and customize the platform for their teams.

Accessing the Admin Panel

To access the admin features:

1. Log in with an administrator account
2. Click on Admin in the main navigation
3. You’ll see the admin dashboard with various management options

Note: Admin access is role-based. If you don’t see the Admin option, contact your organization’s administrator.

Key Admin Areas

User Management

Manage who has access to your PebbleAI instance and what they can do.

Adding Users

1. Navigate to Admin → Users
2. Click Add User
3. Enter user details:
   • Email address
   • Name
   • Role assignment
   • Initial password (or send invitation)

Managing Roles

PebbleAI uses role-based access control (RBAC):

• Admin: Full access to all features and settings
• Editor: Can create and modify chatflows and use PebbleChat
• Viewer: Can use existing chatflows and PebbleChat only
• Custom Roles: Create specific permission sets for your needs

User Actions

• Reset passwords
• Activate/deactivate accounts
• View login history
• Manage API access

Organization Settings

Configure your organization’s PebbleAI environment.

General Settings

• Organization name and details
• Default AI models
• Usage limits and quotas
• Branding customization

Security Settings

• Password policies
• Session timeout
• IP restrictions
• SSO configuration

AI Model Configuration

Control which AI models your team can access and how they’re configured.

Available Models

Manage access to:

• OpenAI models (GPT-4, GPT-3.5)
• Anthropic models (Claude 3 family)
• Google models (Gemini Pro)
• Custom models

API Key Management

• Add organization-wide API keys
• Set usage limits per model
• Monitor API consumption
• Configure fallback models

Usage Analytics

Monitor how your organization uses PebbleAI.

Dashboard Metrics

• Active users
• Chat sessions
• Chatflow executions
• API calls
• Token usage

Reports

• User activity reports
• Model usage breakdown
• Cost analysis
• Performance metrics

Alerts

Set up notifications for:

• Usage threshold warnings
• Unusual activity
• System issues
• Budget alerts

Customization

Make PebbleAI feel like your own platform.

Branding Options

• Upload company logo
• Set brand colors
• Customize email templates
• Configure welcome messages

Workspace Templates

• Create starter chatflows
• Set default configurations
• Build template libraries
• Share best practices

Integrations

Connect PebbleAI with your existing tools.

Available Integrations

• Slack/Teams notifications
• Email systems
• CRM platforms
• Analytics tools
• Custom webhooks

API Management

• Generate API keys
• Set rate limits
• Configure CORS
• Monitor API usage

Common Admin Tasks

Onboarding New Team Members

1. Create User Account

   • Add user with appropriate role
   • Set temporary password or send invite

2. Configure Access

   • Assign to workspaces
   • Set model permissions
   • Configure limits if needed

3. Provide Resources

   • Share getting started guides
   • Assign training chatflows
   • Schedule orientation if needed

Managing Costs

1. Set Usage Limits

   • Configure per-user limits
   • Set model-specific quotas
   • Enable usage warnings

2. Monitor Consumption

   • Review usage reports
   • Identify heavy users
   • Optimize model selection

3. Implement Policies

   • Create usage guidelines
   • Set approval workflows
   • Configure auto-shutoffs

Ensuring Security

1. Regular Audits

   • Review user access
   • Check API key usage
   • Monitor unusual activity

2. Update Policies

   • Enforce strong passwords
   • Enable 2FA when available
   • Regular security training

3. Data Management

   • Configure retention policies
   • Manage data exports
   • Ensure compliance

Best Practices for Admins

User Management

• Regular Reviews: Audit user access quarterly
• Role Assignment: Follow principle of least privilege
• Documentation: Maintain clear role definitions

Cost Control

• Budget Alerts: Set up early warning systems
• Model Selection: Guide users to appropriate models
• Usage Education: Train teams on efficient AI use

Security

• Access Control: Regularly review and update
• API Keys: Rotate regularly and monitor usage
• Compliance: Stay updated with regulations

Support

• Help Resources: Create internal documentation
• Champions: Identify and train power users
• Feedback Loop: Regular check-ins with teams

Troubleshooting Common Issues

User Can’t Access Features

1. Check role assignments
2. Verify workspace membership
3. Review any restrictions

High Usage Alerts

1. Identify top users
2. Review usage patterns
3. Implement controls if needed

Integration Problems

1. Verify API keys
2. Check network settings
3. Review error logs

Getting Help

For admin-specific support:

• Check the Admin FAQ
• Contact PebbleAI support
• Join admin community forums