Skip to main content

Overview

Enable your agents to create, edit, and manage Google Slides presentations. Create presentations, update content, import data from Google Sheets, manage pages and thumbnails, and streamline your presentation workflows with AI-powered automation.

Prerequisites

Before using the Google Slides integration, ensure you have:
  • A CrewAI AMP account with an active subscription
  • A Google account with Google Slides access
  • Connected your Google account through the Integrations page

Setting Up Google Slides Integration

1. Connect Your Google Account

  1. Navigate to CrewAI AMP Integrations
  2. Find Google Slides in the Authentication Integrations section
  3. Click Connect and complete the OAuth flow
  4. Grant the necessary permissions for presentations, spreadsheets, and drive access
  5. Copy your Enterprise Token from Integration Settings

2. Install Required Package

uv add crewai-tools

Available Actions

Description: Creates a blank presentation with no content.Parameters:
  • title (string, required): The title of the presentation.
Description: Retrieves a presentation by ID.Parameters:
  • presentationId (string, required): The ID of the presentation to retrieve.
  • fields (string, optional): The fields to include in the response. Use this to improve performance by only returning needed data.
Description: Applies updates, add content, or remove content from a presentation.Parameters:
  • presentationId (string, required): The ID of the presentation to update.
  • requests (array, required): A list of updates to apply to the presentation.
    [
      {
        "insertText": {
          "objectId": "slide_id",
          "text": "Your text content here"
        }
      }
    ]
    
  • writeControl (object, optional): Provides control over how write requests are executed.
    {
      "requiredRevisionId": "revision_id_string"
    }
    
Description: Retrieves a specific page by its ID.Parameters:
  • presentationId (string, required): The ID of the presentation.
  • pageObjectId (string, required): The ID of the page to retrieve.
Description: Generates a page thumbnail.Parameters:
  • presentationId (string, required): The ID of the presentation.
  • pageObjectId (string, required): The ID of the page for thumbnail generation.
Description: Imports data from a Google Sheet into a presentation.Parameters:
  • presentationId (string, required): The ID of the presentation.
  • sheetId (string, required): The ID of the Google Sheet to import from.
  • dataRange (string, required): The range of data to import from the sheet.
Description: Uploads a file to Google Drive associated with the presentation.Parameters:
  • file (string, required): The file data to upload.
  • presentationId (string, required): The ID of the presentation to link the uploaded file.
Description: Lists all presentations accessible to the user.Parameters:
  • pageSize (integer, optional): The number of presentations to return per page.
  • pageToken (string, optional): A token for pagination.
Description: Deletes a presentation by ID.Parameters:
  • presentationId (string, required): The ID of the presentation to delete.

Usage Examples

Basic Google Slides Agent Setup

from crewai import Agent, Task, Crew

# Create an agent with Google Slides capabilities
slides_agent = Agent(
    role="Presentation Manager",
    goal="Create and manage presentations efficiently",
    backstory="An AI assistant specialized in presentation creation and content management.",
    apps=['google_slides']  # All Google Slides actions will be available
)

# Task to create a presentation
create_presentation_task = Task(
    description="Create a new presentation for the quarterly business review with key slides",
    agent=slides_agent,
    expected_output="Quarterly business review presentation created with structured content"
)

# Run the task
crew = Crew(
    agents=[slides_agent],
    tasks=[create_presentation_task]
)

crew.kickoff()

Presentation Content Management

from crewai import Agent, Task, Crew

content_manager = Agent(
    role="Content Manager",
    goal="Manage presentation content and updates",
    backstory="An AI assistant that focuses on content creation and presentation updates.",
    apps=[
        'google_slides/create_blank_presentation',
        'google_slides/batch_update_presentation',
        'google_slides/get_presentation'
    ]
)

# Task to create and update presentations
content_task = Task(
    description="Create a new presentation and add content slides with charts and text",
    agent=content_manager,
    expected_output="Presentation created with updated content and visual elements"
)

crew = Crew(
    agents=[content_manager],
    tasks=[content_task]
)

crew.kickoff()

Data Integration and Visualization

from crewai import Agent, Task, Crew

data_visualizer = Agent(
    role="Data Visualizer",
    goal="Create presentations with data imported from spreadsheets",
    backstory="An AI assistant that specializes in data visualization and presentation integration.",
    apps=['google_slides']
)

# Task to create data-driven presentations
visualization_task = Task(
    description="""
    1. Create a new presentation for monthly sales report
    2. Import data from the sales spreadsheet
    3. Create charts and visualizations from the imported data
    4. Generate thumbnails for slide previews
    """,
    agent=data_visualizer,
    expected_output="Data-driven presentation created with imported spreadsheet data and visualizations"
)

crew = Crew(
    agents=[data_visualizer],
    tasks=[visualization_task]
)

crew.kickoff()

Presentation Library Management

from crewai import Agent, Task, Crew

library_manager = Agent(
    role="Presentation Library Manager",
    goal="Manage and organize presentation libraries",
    backstory="An AI assistant that manages presentation collections and file organization.",
    apps=['google_slides']
)

# Task to manage presentation library
library_task = Task(
    description="""
    1. List all existing presentations
    2. Generate thumbnails for presentation previews
    3. Upload supporting files to Drive and link to presentations
    4. Organize presentations by topic and date
    """,
    agent=library_manager,
    expected_output="Presentation library organized with thumbnails and linked supporting files"
)

crew = Crew(
    agents=[library_manager],
    tasks=[library_task]
)

crew.kickoff()

Automated Presentation Workflows

from crewai import Agent, Task, Crew

presentation_automator = Agent(
    role="Presentation Automator",
    goal="Automate presentation creation and management workflows",
    backstory="An AI assistant that automates complex presentation workflows and content generation.",
    apps=['google_slides']
)

# Complex presentation automation task
automation_task = Task(
    description="""
    1. Create multiple presentations for different departments
    2. Import relevant data from various spreadsheets
    3. Update existing presentations with new content
    4. Generate thumbnails for all presentations
    5. Link supporting documents from Drive
    6. Create a master index presentation with links to all others
    """,
    agent=presentation_automator,
    expected_output="Automated presentation workflow completed with multiple presentations and organized structure"
)

crew = Crew(
    agents=[presentation_automator],
    tasks=[automation_task]
)

crew.kickoff()

Template and Content Creation

from crewai import Agent, Task, Crew

template_creator = Agent(
    role="Template Creator",
    goal="Create presentation templates and standardized content",
    backstory="An AI assistant that creates consistent presentation templates and content standards.",
    apps=['google_slides']
)

# Task to create templates
template_task = Task(
    description="""
    1. Create blank presentation templates for different use cases
    2. Add standard layouts and content placeholders
    3. Create sample presentations with best practices
    4. Generate thumbnails for template previews
    5. Upload template assets to Drive and link appropriately
    """,
    agent=template_creator,
    expected_output="Presentation templates created with standardized layouts and linked assets"
)

crew = Crew(
    agents=[template_creator],
    tasks=[template_task]
)

crew.kickoff()

Troubleshooting

Common Issues

Permission Errors
  • Ensure your Google account has appropriate permissions for Google Slides
  • Verify that the OAuth connection includes required scopes for presentations, spreadsheets, and drive access
  • Check that presentations are shared with the authenticated account
Presentation ID Issues
  • Verify that presentation IDs are correct and presentations exist
  • Ensure you have access permissions to the presentations you’re trying to modify
  • Check that presentation IDs are properly formatted
Content Update Issues
  • Ensure batch update requests are properly formatted according to Google Slides API specifications
  • Verify that object IDs for slides and elements exist in the presentation
  • Check that write control revision IDs are current if using optimistic concurrency
Data Import Issues
  • Verify that Google Sheet IDs are correct and accessible
  • Ensure data ranges are properly specified using A1 notation
  • Check that you have read permissions for the source spreadsheets
File Upload and Linking Issues
  • Ensure file data is properly encoded for upload
  • Verify that Drive file IDs are correct when linking files
  • Check that you have appropriate Drive permissions for file operations
Page and Thumbnail Operations
  • Verify that page object IDs exist in the specified presentation
  • Ensure presentations have content before attempting to generate thumbnails
  • Check that page structure is valid for thumbnail generation
Pagination and Listing Issues
  • Use appropriate page sizes for listing presentations
  • Implement proper pagination using page tokens for large result sets
  • Handle empty result sets gracefully

Getting Help

Need Help?

Contact our support team for assistance with Google Slides integration setup or troubleshooting.
I