Tool Usage Examples
===================

Here are practical examples of how to use JamesAI's tools in everyday situations.

Email Examples
--------------

**Sending a Simple Email**
~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "Send an email to sarah@company.com with subject 'Meeting Tomorrow' and tell her the meeting is at 2pm in conference room B"

JamesAI will:
1. Compose the email
2. Show you a preview
3. Send it to Sarah

**Checking Sent Emails**
~~~~~~~~~~~~~~~~~~~~~~~~

You: "Show me the last 5 emails I sent"

JamesAI will list your recent sent emails with recipients, subjects, and dates.

Project Management Examples
---------------------------

**Creating a GitLab Issue**
~~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "Create a GitLab issue in project 323 titled 'Fix login bug' with description 'Users can't log in with special characters in password' and assign it to user ID 42"

JamesAI will create the issue and give you the link.

**Finding Issues**
~~~~~~~~~~~~~~~~~~

You: "Find all open issues assigned to me in GitLab"

JamesAI will search and list your assigned issues.

**Updating an Issue**
~~~~~~~~~~~~~~~~~~~~~

You: "Update GitLab issue 156 in project 323 to closed state and add label 'fixed'"

JamesAI will update the issue and confirm the changes.

Task & Reminder Examples
------------------------

**One-Time Reminder**
~~~~~~~~~~~~~~~~~~~~~

You: "Remind me on 2025-02-15 at 14:30:00 to submit the report"

JamesAI will create a scheduled task that will message you at that exact time.

**Recurring Task**
~~~~~~~~~~~~~~~~~~

You: "Every 120 minutes, remind me to take a break"

JamesAI will create a periodic task that repeats every 2 hours.

**Checking Tasks**
~~~~~~~~~~~~~~~~~~

You: "Show me all my active tasks"

JamesAI will list your scheduled reminders and recurring tasks.

Memory Examples
---------------

**Saving Information**
~~~~~~~~~~~~~~~~~~~~~~

You: "Remember that my manager's name is Jennifer and her email is jennifer@company.com"

JamesAI: "I've saved that information. I'll remember it for future conversations."

**Retrieving Information**
~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "What's my manager's email?"

JamesAI: "Your manager Jennifer's email is jennifer@company.com"

**Channel-Specific Memory**
~~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "Remember for this channel only that our standup is every Monday at 9am"

JamesAI will save this info only for the current channel.

Research Examples
-----------------

**Web Research**
~~~~~~~~~~~~~~~~

You: "Research the latest trends in artificial intelligence"

JamesAI will search the web and provide you with the top 5 relevant results.

**Scraping a Website**
~~~~~~~~~~~~~~~~~~~~~~

You: "Get me the content from https://example.com/article"

JamesAI will extract and format the article content for you.

**Creating LinkedIn Content**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "Create a LinkedIn post about remote work with key points: flexibility, productivity, work-life balance. Include facts about remote work statistics."

JamesAI will generate a professional post with hashtags.

Translation Examples
--------------------

**Simple Translation**
~~~~~~~~~~~~~~~~~~~~~~

You: "Translate 'Hello, how are you?' to German"

JamesAI: "Hallo, wie geht es dir?"

**Formal Translation**
~~~~~~~~~~~~~~~~~~~~~~

You: "Translate 'Can you help me?' to French with formal tone"

JamesAI will provide a formal French translation.

**Checking Languages**
~~~~~~~~~~~~~~~~~~~~~~

You: "What languages can you translate to?"

JamesAI will list all supported languages.

Discord Examples
----------------

**Finding Channels**
~~~~~~~~~~~~~~~~~~~~

You: "Show me all channels in this server"

JamesAI will list all channels you have access to.

**Sending to a Channel**
~~~~~~~~~~~~~~~~~~~~~~~~

You: "Send a message to channel 123456789 saying 'Meeting starts in 10 minutes'"

JamesAI will post the message to that channel.

**Searching Messages**
~~~~~~~~~~~~~~~~~~~~~~

You: "Search for messages about 'budget' in this channel"

JamesAI will find and show relevant messages.

User Interaction Examples
--------------------------

**Finding Users**
~~~~~~~~~~~~~~~~~

You: "Find users named John"

JamesAI will show all users named John in your shared servers.

**Sending a DM**
~~~~~~~~~~~~~~~~

You: "Send a DM to Discord user 987654321 saying 'Can we schedule a call?'"

JamesAI will send the direct message.

Timezone Examples
-----------------

**Setting Timezone**
~~~~~~~~~~~~~~~~~~~~

You: "Set my timezone to America/New_York"

JamesAI: "Your timezone has been set to America/New_York"

**Checking Timezone**
~~~~~~~~~~~~~~~~~~~~~

You: "What's my current timezone?"

JamesAI: "Your timezone is set to Europe/Zurich"

Fun Examples
------------

**Finding Memes**
~~~~~~~~~~~~~~~~~

You: "Find me a funny programming meme"

JamesAI will search and show you programming memes.

**Random Meme**
~~~~~~~~~~~~~~~

You: "Show me a random meme"

JamesAI will fetch a random meme for you.

Complex Workflow Examples
--------------------------

**Complete Project Setup**
~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "Create a GitLab issue for the new feature, assign it to user 42, set due date to 2025-03-01, and remind me in 2 weeks to check progress"

JamesAI will:
1. Create the GitLab issue
2. Assign it to the user
3. Set the due date
4. Create a reminder task

**Research and Share**
~~~~~~~~~~~~~~~~~~~~~~

You: "Research cloud computing trends, create a LinkedIn post about it, and send the post to channel 123456789"

JamesAI will:
1. Research the topic
2. Generate a LinkedIn post
3. Share it in the specified channel

**Multi-Step Communication**
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You: "Find user Sarah, get her email from my memory, and send her an email about tomorrow's meeting"

JamesAI will:
1. Search for Sarah
2. Retrieve her email from memory
3. Compose and send the email

Tips for Best Results
---------------------

1. **Be specific with dates/times** - Use format YYYY-MM-DD HH:MM:SS for tasks
2. **Provide IDs when known** - Channel IDs, user IDs, project IDs help accuracy
3. **Use natural language** - No need for special commands, just ask normally
4. **Chain requests** - You can ask for multiple things in one message
5. **Save frequently used info** - Use memory for emails, names, preferences
6. **Set up OAuth first** - Connect Gmail and GitLab before using those features