Iris Docs
Complete User Guide to Iris
Master all features and capabilities of Iris - your AI agent platform
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:
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:
| Element | Description | Example |
|---|---|---|
| Subject | What should be in the image | A coffee shop interior, a robot assistant, a mountain landscape |
| Style | Visual aesthetic and mood | Modern, minimalist, vintage, professional, playful |
| Colors | Color palette and scheme | Blue and purple gradient, warm earth tones, corporate navy |
| Composition | Layout and arrangement | Centered subject, rule of thirds, symmetrical design |
| Text | Any text or typography needed | Include "Sale 50% Off" text in bold, add tagline at bottom |
| Dimensions | Size requirements | Instagram 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:
| Element | Description | Example |
|---|---|---|
| Presentation Name | Unique identifier for your presentation | product_launch_2024, company_overview, sales_pitch |
| Theme | Visual style and color scheme | modern, minimal, dark, corporate, vibrant, slate |
| Slide Count | Number of slides needed | 5 slides, 10 slides, 3 slides |
| Slide Content | What each slide should contain | Title slide, bullet points, charts, code examples |
| Typography | Text styling preferences | Bold headings, readable body text, professional fonts |
| Images | Visual elements to include | Company logo, product photos, charts, diagrams |
| Interactive Elements | Special features needed | Navigation 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:
| Element | Description | Example |
|---|---|---|
| Research Topic | What to research | AI agents, Python decorators, market trends, competitor analysis |
| Scope | How broad or narrow | Recent developments, comprehensive overview, specific aspect |
| Sources | Where to look | Web search, specific websites, academic papers, news articles |
| Output Format | How to present findings | Summary document, comparison table, detailed report, bullet points |
| Key Questions | Specific questions to answer | What are the benefits? How does it work? What are the alternatives? |
| Depth | Level of detail needed | Quick overview, detailed analysis, comprehensive report |
| Citations | Include source references | Include 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
| Feature | Description | Example Usage |
|---|---|---|
| Rich Text | Bold, italic, underline, strikethrough formatting | Create a document with **bold** and *italic* text |
| Headings | Multiple heading levels (H1-H6) for document structure | Use # Heading 1, ## Heading 2, etc. |
| Lists | Ordered and unordered lists with nesting support | Create bullet points or numbered lists |
| Code Blocks | Syntax-highlighted code blocks in various languages | ```python print("Hello World") ``` |
| Tables | Create structured data tables | Create a table with columns and rows |
| Links | Embed hyperlinks to external resources | Add [link text](URL) to documents |
| Images | Embed and display images | Include 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:
| Element | Description | Example |
|---|---|---|
| Document Name | Filename and title | project-proposal.md, meeting-notes.md, technical-guide.md |
| Structure | How to organize content | Sections with headings, numbered sections, hierarchical structure |
| Content Type | What kind of content | Technical docs, meeting notes, proposals, guides, reports |
| Formatting | Text styling needs | Bold headings, bullet points, code blocks, tables |
| Code Examples | Include code snippets | Python examples, bash commands, configuration files |
| Visual Elements | Tables, images, diagrams | Comparison tables, data tables, embedded images |
| References | Links and citations | Links 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 embedBuilding 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.
Popular Integrations
| Service | Category | Capabilities |
|---|---|---|
| Gmail | Communication | Send emails, read inbox, manage messages, attachments |
| Slack | Communication | Send messages, create channels, manage notifications |
| GitHub | Development | Manage repositories, create issues, pull requests, code reviews |
| Notion | Productivity | Create pages, databases, manage content, sync data |
| Google Sheets | Data | Read/write spreadsheets, formulas, data analysis |
| PostgreSQL | Database | Query 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 worksBest 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: