Iris Docs

Complete User Guide to Iris

Master all features and capabilities of Iris - your AI agent platform

Last updated: January 2025

Welcome to Iris

This comprehensive guide will help you discover everything Iris can do. From basic chat interactions to advanced automation workflows, you'll learn how to leverage Iris's powerful capabilities to automate your work.

Core Capabilities

Iris comes with a powerful set of built-in tools that enable your agents to interact with the digital world:

File Management
Create, edit, and organize files and documents
Web Search & Research
Search the internet and gather information
Browser Automation
Navigate websites and interact with web pages
Code Execution
Run commands and execute scripts
Image & Vision
Analyze images and create visual content
API Integrations
Connect with external services and APIs

Image Generation & Design

Iris can generate and edit images using AI, create professional graphics for social media, and design visual content. Perfect for creating images from scratch or editing existing ones.

What Iris Can Do

  • Generate Images: Create images from text prompts using Google's Imagen 4.0
  • Edit Images: Modify existing images by adding, removing, or changing elements
  • Professional Graphics: Design social media posts, ads, banners, and marketing materials
  • Platform-Specific Sizes: Optimized dimensions for Instagram, Facebook, Twitter, LinkedIn, YouTube, and more
  • Design Styles: Modern, minimalist, material, glassmorphism, neomorphism, and 11+ more styles
  • Custom Dimensions: Specify exact pixel dimensions (256-4096px range)

How to Use Image Generation

Simply describe what you want to create or edit:

# Generate a new image"Create an image of a futuristic cityscape at sunset with flying cars"# Edit an existing image  "Edit the image at path/to/image.png to add a rainbow in the sky"# Create social media graphics"Create an Instagram post graphic for a tech startup launch event:- Size: Instagram square (1080x1080)- Style: Modern tech aesthetic- Content: 'Launching Soon' text with tech visuals- Colors: Blue and purple gradient"# Professional design"Design a LinkedIn banner for a marketing agency:- Platform: LinkedIn banner- Style: Professional- Include: Company logo placement area and tagline space- Colors: Corporate blue and white"

Comprehensive Instructions for Image Generation

For best results, provide detailed instructions:

ElementDescriptionExample
SubjectWhat should be in the imageA coffee shop interior, a robot assistant, a mountain landscape
StyleVisual aesthetic and moodModern, minimalist, vintage, professional, playful
ColorsColor palette and schemeBlue and purple gradient, warm earth tones, corporate navy
CompositionLayout and arrangementCentered subject, rule of thirds, symmetrical design
TextAny text or typography neededInclude "Sale 50% Off" text in bold, add tagline at bottom
DimensionsSize requirementsInstagram square (1080x1080), custom 1920x1080

Special Tips for Image Generation

  • Be Specific: Instead of "a landscape," say "a serene mountain landscape at sunrise with misty valleys and pine trees"
  • Mention Style: Specify "modern," "minimalist," or "vintage" to get the aesthetic you want
  • Platform Optimization: Use platform presets (Instagram, LinkedIn, etc.) for optimal sizing
  • Quality Settings: Use "high" quality for final assets, "auto" for quick iterations
  • Iterate: Generate a base image, then ask Iris to edit specific elements
  • Combine with Design: Use the designer tool for social media graphics with professional layouts

Image Editing Examples

# Simple edits"Add a sunset sky to the image at path/to/image.png"# Complex edits"Edit the product photo to:- Remove the background and replace with white- Add a subtle shadow beneath the product- Enhance the colors to be more vibrant"# Creative modifications"Transform this photo into a watercolor painting style while keeping the original composition"

Presentation & Slide Generation

Create professional HTML presentations with beautiful slide designs. Iris can generate multi-slide presentations with rich formatting, animations, and interactive elements.

What Iris Can Do

  • Individual Slides: Create slides one at a time, each as a standalone HTML file (1920x1080 resolution)
  • Multiple Themes: Choose from 10+ visual styles (modern, minimal, dark, corporate, vibrant, slate, etc.)
  • Rich Content: Text, images, code blocks, tables, charts, and formatted content
  • Interactive Elements: Navigation, animations, D3.js charts, Chart.js visualizations
  • Image Integration: Include images from web search or user uploads
  • Iterative Editing: Update individual slides without affecting others
  • Navigation System: Automatic slide navigation with previews
  • Responsive Design: Scales beautifully to any screen size

How to Use Presentation Generation

Describe your presentation needs:

# Simple presentation request"Create a 5-slide presentation about AI agents:- Slide 1: Title slide with 'AI Agents' - Slide 2: What are AI agents?- Slide 3: Use cases and examples- Slide 4: Benefits of using agents- Slide 5: Getting started with Iris"# Detailed presentation"Create a professional presentation called 'Product Launch 2024':- Theme: Modern corporate style- Slide 1: Title slide with company logo area and tagline- Slide 2: Problem statement with statistics- Slide 3: Our solution with feature highlights- Slide 4: Market opportunity with a chart- Slide 5: Call to action with contact information- Include navigation between slides"# Presentation with specific content"Create a technical presentation about Python decorators:- Theme: Dark theme for code-heavy content- Include code examples with syntax highlighting- Add diagrams explaining concepts- Use professional typography- Make it suitable for a developer audience"

Comprehensive Instructions for Presentations

Provide detailed specifications for best results:

ElementDescriptionExample
Presentation NameUnique identifier for your presentationproduct_launch_2024, company_overview, sales_pitch
ThemeVisual style and color schememodern, minimal, dark, corporate, vibrant, slate
Slide CountNumber of slides needed5 slides, 10 slides, 3 slides
Slide ContentWhat each slide should containTitle slide, bullet points, charts, code examples
TypographyText styling preferencesBold headings, readable body text, professional fonts
ImagesVisual elements to includeCompany logo, product photos, charts, diagrams
Interactive ElementsSpecial features neededNavigation buttons, animated transitions, clickable charts

Special Tips for Presentations

  • One Idea Per Slide: Keep slides focused - 1-2 main ideas maximum
  • Limit Bullet Points: Use 3-5 bullet points maximum per slide for readability
  • White Space: Don't fill every pixel - embrace whitespace for professional look
  • Visual Hierarchy: Use different font sizes (48-72px titles, 20-24px body)
  • Iterative Building: Create slides one at a time, then refine individual slides
  • Theme Consistency: Stick to one theme throughout for professional appearance
  • Use Charts: Leverage D3.js and Chart.js for data visualizations
  • Code Blocks: Include syntax-highlighted code for technical presentations

Example: Structured Presentation Request

"Create a professional 7-slide presentation called 'Q4 Results':Theme: Corporate modern styleSlide dimensions: 1920x1080 (16:9)Slide 1: Title Slide- Main title: 'Q4 2024 Results'- Subtitle: 'Company Name'- Include logo placement area- Use gradient backgroundSlide 2: Executive Summary- Key metrics overview- 3-4 main bullet points- Include icons for visual interestSlide 3: Revenue Performance- Title: 'Revenue Growth'- Include a bar chart showing quarterly growth- Add percentage changes- Use Chart.js for visualizationSlide 4: Key Achievements- List top 5 achievements- Use checkmark icons- Bold text for emphasisSlide 5: Challenges & Solutions- Two-column layout- Left: Challenges faced- Right: Solutions implementedSlide 6: Team Highlights- Feature 3 team members- Include photos (placeholder areas)- Name, role, contributionSlide 7: Looking Ahead- Title: '2025 Roadmap'- List 3-4 key initiatives- Call to action at bottomRequirements:- Consistent color scheme throughout- Professional typography- Navigation between slides- Responsive design"

Research & Information Gathering

Iris excels at research tasks. It can search the web, browse websites, extract information, and synthesize findings into comprehensive reports.

What Iris Can Do

  • Web Search: Search the internet using Tavily API with up-to-date results
  • Image Search: Find relevant images for your research topics
  • People & Company Search: Look up individuals and organizations
  • Browser Automation: Navigate websites, click buttons, fill forms, extract data
  • Web Scraping: Extract content from web pages automatically
  • Academic Papers: Search and analyze research papers from arXiv, PubMed, IEEE, and more
  • Multi-Source Research: Gather information from multiple sources and synthesize
  • Report Generation: Create comprehensive research reports with citations

How to Use Research Capabilities

Ask Iris to research any topic:

# Simple research"Search for the latest developments in AI agents and create a summary"# Comprehensive research"Research the competitive landscape for AI agent platforms:- Find top 5 competitors- Compare their features- Analyze pricing models- Create a comparison table- Include links to sources"# Multi-step research"Research Python decorators:1. Search for recent articles and tutorials2. Find code examples3. Identify common use cases4. Create a comprehensive guide document5. Include a table comparing different patterns"# Browser-based research"Navigate to example.com/product-page and extract:- Product name- Price- Features list- Customer reviews- Create a summary document"# Academic research"Search for academic papers on transformer architectures published in 2024:- Include abstracts- List authors- Summarize key findings- Create a bibliography"

Comprehensive Instructions for Research

Structure your research requests for best results:

ElementDescriptionExample
Research TopicWhat to researchAI agents, Python decorators, market trends, competitor analysis
ScopeHow broad or narrowRecent developments, comprehensive overview, specific aspect
SourcesWhere to lookWeb search, specific websites, academic papers, news articles
Output FormatHow to present findingsSummary document, comparison table, detailed report, bullet points
Key QuestionsSpecific questions to answerWhat are the benefits? How does it work? What are the alternatives?
DepthLevel of detail neededQuick overview, detailed analysis, comprehensive report
CitationsInclude source referencesInclude URLs, authors, publication dates, citations

Special Tips for Research

  • Be Specific: Instead of "research AI," say "research latest AI agent frameworks released in 2024"
  • Ask for Multiple Sources: Request 5-10 sources for comprehensive research
  • Specify Format: Ask for tables, summaries, or detailed reports based on your needs
  • Request Citations: Always ask for source URLs and references
  • Use Browser for Complex Sites: For JavaScript-heavy sites, ask Iris to browse and extract
  • Combine Tools: Use web search first, then browser automation for specific sites
  • Ask for Verification: Request cross-referencing from multiple sources
  • Set Timeframes: Specify "recent," "2024," or "latest" for current information

Example: Comprehensive Research Request

"Conduct comprehensive research on AI agent platforms:Research Tasks:1. Search for top 10 AI agent platforms available in 20242. For each platform, find:   - Key features and capabilities   - Pricing models   - Target audience   - Strengths and weaknesses   - User reviews and ratings3. Compare features across platforms:   - Create a comparison table   - Highlight unique features   - Identify common capabilities4. Analyze market trends:   - Industry growth projections   - Emerging technologies   - Investment and funding data5. Research specific use cases:   - Customer service automation   - Content creation   - Data analysis   - Integration capabilitiesOutput Requirements:- Create a detailed report document- Include comparison tables- Add citations with URLs- Organize by sections with headings- Include executive summary at the top- Add recommendations section at the endSources:- Use web search for general information- Browse specific platform websites- Look for industry reports- Check news articles from 2024- Include academic sources if relevant"

Document Creation

Iris can create beautifully formatted documents with rich text, code blocks, tables, and more. Use natural language to describe what you want, and Iris will create professional documents.

Document Features

FeatureDescriptionExample Usage
Rich TextBold, italic, underline, strikethrough formattingCreate a document with **bold** and *italic* text
HeadingsMultiple heading levels (H1-H6) for document structureUse # Heading 1, ## Heading 2, etc.
ListsOrdered and unordered lists with nesting supportCreate bullet points or numbered lists
Code BlocksSyntax-highlighted code blocks in various languages```python print("Hello World") ```
TablesCreate structured data tablesCreate a table with columns and rows
LinksEmbed hyperlinks to external resourcesAdd [link text](URL) to documents
ImagesEmbed and display imagesInclude images in your documents

What Iris Can Do

  • Rich Text Formatting: Bold, italic, underline, strikethrough, and inline code
  • Structured Content: Headings (H1-H6), paragraphs, lists (ordered and unordered)
  • Code Blocks: Syntax-highlighted code in Python, TypeScript, JavaScript, Bash, and more
  • Tables: Create structured data tables with multiple columns and rows
  • Links: Embed hyperlinks to external resources and internal references
  • Images: Include images from web search or uploads
  • Blockquotes: Highlight important information or quotes
  • Nested Lists: Create multi-level lists with proper indentation

How to Use Document Creation

Simply describe what you want in your document:

# Simple document"Create a document called 'project-notes.md' with my meeting notes from today"# Technical documentation"Create a technical guide about Python decorators:- Introduction explaining what they are- Code examples showing basic usage- Advanced patterns section- A comparison table of different approaches- Links to official Python documentation"# Comprehensive document"Create a detailed project proposal document:- Title: 'Q4 Marketing Campaign Proposal'- Executive summary section- Objectives and goals- Budget breakdown table- Timeline with milestones- Team responsibilities- Risk assessment- Appendices section"

Comprehensive Instructions for Documents

Provide detailed specifications for best results:

ElementDescriptionExample
Document NameFilename and titleproject-proposal.md, meeting-notes.md, technical-guide.md
StructureHow to organize contentSections with headings, numbered sections, hierarchical structure
Content TypeWhat kind of contentTechnical docs, meeting notes, proposals, guides, reports
FormattingText styling needsBold headings, bullet points, code blocks, tables
Code ExamplesInclude code snippetsPython examples, bash commands, configuration files
Visual ElementsTables, images, diagramsComparison tables, data tables, embedded images
ReferencesLinks and citationsLinks to external resources, internal references, citations

Special Tips for Document Creation

  • Specify Structure: Mention headings, sections, and organization upfront
  • Request Formatting: Ask for bold headings, bullet points, or numbered lists explicitly
  • Include Examples: Request code examples, use cases, or practical examples
  • Use Tables: Ask for comparison tables, data tables, or feature matrices
  • Add Links: Request links to relevant resources, documentation, or references
  • Iterate: Create a base document, then ask for additions or modifications
  • Combine with Research: Ask Iris to research first, then create a document from findings

Example: Comprehensive Document Request

"Create a comprehensive technical documentation file called 'python-decorators-guide.md':Document Structure:1. Title: 'Python Decorators: Complete Guide'2. Table of Contents (auto-generated)3. Introduction section explaining what decorators are4. Basic Usage section with code examples5. Advanced Patterns section6. Common Use Cases section7. Best Practices section8. Comparison table of different decorator patterns9. References section with linksContent Requirements:- Use H1 for main title, H2 for sections, H3 for subsections- Include Python code examples with syntax highlighting- Use bold text for important concepts- Create bullet points for lists- Add a comparison table showing:  - Decorator pattern name  - Use case  - Code complexity  - Performance impactCode Examples:- Basic decorator syntax- Decorator with arguments- Class-based decorators- Decorator chaining- Real-world examplesFormatting:- Bold all section headings- Use code blocks for all code examples- Include inline code for function names- Add links to Python official documentation- Use blockquotes for important notesAdditional Requirements:- Make it beginner-friendly- Include practical examples- Add warnings for common pitfalls- Provide links to further reading"

Presentation Creation

Create professional HTML presentations with beautiful slide designs. Iris can generate multi-slide presentations with formatted content, images, and animations.

Presentation Features

  • Beautiful Slide Designs: Professional templates with modern aesthetics
  • Multiple Layouts: Title slides, content slides, image slides, and more
  • Rich Content: Text, images, code blocks, and formatted content
  • Interactive Navigation: Click through slides easily
  • Export Options: Share as HTML files or embed in websites

Example: Creating a Presentation

# Request a Presentation"Create a 5-slide presentation about AI agents:- Slide 1: Title slide with 'AI Agents' - Slide 2: What are AI agents?- Slide 3: Use cases and examples- Slide 4: Benefits of using agents- Slide 5: Getting started with Iris"# Iris will generate a beautiful HTML presentation# that you can view, share, or embed

Building Custom Agents

One of Iris's most powerful features is the ability to create specialized agents for specific tasks. You can configure agents with unique personalities, capabilities, and integrations.

Agent Configuration

  • Custom Personality: Define how your agent communicates and behaves
  • Tool Selection: Enable specific capabilities (web search, file management, etc.)
  • MCP Integrations: Connect to external services (Gmail, Slack, GitHub, etc.)
  • Scheduled Triggers: Automate recurring tasks with cron schedules
  • Event Triggers: Respond to events from connected services

Example Agent Types

Research Agent

Configured with web search, browser automation, and document creation tools.

Perfect for: Market research, competitive analysis, information gathering

Content Creator

Configured with document creation, presentation tools, and image editing.

Perfect for: Blog posts, presentations, marketing materials

Data Analyst

Configured with API integrations, file processing, and data providers.

Perfect for: Data processing, report generation, analytics

Integration Specialist

Configured with MCP integrations for Gmail, Slack, and other services.

Perfect for: Workflow automation, cross-platform tasks

External Integrations

Iris supports integration with over 2700 external services through MCP (Model Context Protocol) servers. Connect your agents to the tools you already use.

ServiceCategoryCapabilities
GmailCommunicationSend emails, read inbox, manage messages, attachments
SlackCommunicationSend messages, create channels, manage notifications
GitHubDevelopmentManage repositories, create issues, pull requests, code reviews
NotionProductivityCreate pages, databases, manage content, sync data
Google SheetsDataRead/write spreadsheets, formulas, data analysis
PostgreSQLDatabaseQuery databases, manage schemas, execute SQL

Automation & Triggers

Make your agents work automatically with scheduled triggers and event-based automation.

Scheduled Triggers

Run agents automatically on a schedule using cron expressions:

  • Daily: Run every day at a specific time (e.g., "0 9 * * *" for 9 AM daily)
  • Weekly: Run on specific days of the week
  • Custom: Any cron schedule you need

Event Triggers

Respond to events from connected services:

  • Email Received: Trigger when new emails arrive in Gmail
  • GitHub Activity: Trigger on new issues, PRs, or commits
  • Database Changes: Trigger on data updates
  • Custom Events: Any event from connected services

Example: Creating a Scheduled Trigger

# Ask Iris to create a scheduled trigger"Create a daily trigger that runs at 9 AM to:1. Check my email for important messages2. Generate a summary of tasks3. Send a morning briefing report"# Iris will:# - Set up the cron schedule (0 9 * * *)# - Configure the agent to run automatically# - Test the trigger to ensure it works

Best Practices

Get the most out of Iris by following these best practices:

Communication Tips

  • Be Specific: The more details you provide, the better Iris can help you
  • Break Down Tasks: Complex tasks work better when broken into steps
  • Provide Context: Share relevant information about your goals
  • Iterate: Refine requests based on results

Security Considerations

  • Review what permissions integrations request
  • Use credential profiles to manage access
  • Regularly review and update integrations

Next Steps

Now that you understand Iris's capabilities, here's what to do next:

Try Your First Task
Start with a simple task to see Iris in action
Explore Formatting
See all the formatting options available