Skip to content

New Guide Article : "Microbots : Introduction, Installation Guide and Creating Your First MicroBot" and structural changes in blog#132

Open
shivashanmugam wants to merge 25 commits into
mainfrom
siva/getting-started-with-microbots
Open

New Guide Article : "Microbots : Introduction, Installation Guide and Creating Your First MicroBot" and structural changes in blog#132
shivashanmugam wants to merge 25 commits into
mainfrom
siva/getting-started-with-microbots

Conversation

@shivashanmugam
Copy link
Copy Markdown
Collaborator

@shivashanmugam shivashanmugam commented Apr 17, 2026

Changes with this PR

  1. Create Getting Started Article
image
  1. Creation of new sections in Guide
    Bots. Tools,
image
  1. Fix of paths in

From : microbots/copilot-bot/
To : microbots/advanced/bots/copilot-bot/

From : microbots/blog/guides/tesseract_ocr_tool_use/
To : microbots/advanced/tools/tesseract_ocr_tool_use/

From : /microbots/authentication/
To : microbots/advanced/authentication/

  1. Added Introduction, Getting Started, Advanced Section, Rename "Blogs" to "Blog"
image

@shivashanmugam shivashanmugam changed the title microbots intro New Guide Article : "Microbots : Introduction, Installation Guide and Creating Your First MicroBot" and structural changes in blog Apr 17, 2026
@codecov-commenter
Copy link
Copy Markdown

codecov-commenter commented Apr 17, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 65.04%. Comparing base (d41a0a9) to head (0c9c08e).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #132      +/-   ##
==========================================
+ Coverage   64.95%   65.04%   +0.08%     
==========================================
  Files          34       34              
  Lines        2374     2380       +6     
==========================================
+ Hits         1542     1548       +6     
  Misses        832      832              
Flag Coverage Δ
integration 36.97% <ø> (+2.47%) ⬆️
ollama_local 32.14% <ø> (-0.09%) ⬇️
slow-browser 26.76% <ø> (-0.07%) ⬇️
slow-other 38.44% <ø> (-0.10%) ⬇️
unit 59.28% <ø> (+0.10%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@shivashanmugam shivashanmugam requested a review from 0xba1a April 17, 2026 12:39
Comment thread docs/examples/microbots_introduction/code/app.js Outdated

1. **Created a Docker container** with the `code` folder mounted using the appropriate permissions.
2. **Sent your task** to the LLM along with a system prompt tailored to the bot type.
3. **Executed commands** inside the container as directed by the LLM (e.g., `cat`, `grep`, `sed`).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please import logging and set logging config to print INFO log in the LogAnalysisBot.py. So, user can see the individual command the LLM runs. Also, you can point them how to read the logs with some examples here.

Copy link
Copy Markdown
Collaborator Author

@shivashanmugam shivashanmugam Apr 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Enabled logging info in code and added the full log output when user is interested to see
image

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please check whether the relevant code is pushed to GitHub. Because I cannot see the explanation text and full log between python log_analysis_bot.py command and output snippet.

Copy link
Copy Markdown
Collaborator Author

@shivashanmugam shivashanmugam May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have not added the full log of python log_analysis_bot.py as log files are excluded. I have added a article about the what each section of the log conveys to the user. I hope this is what you are expecting.
.
image

@shivashanmugam shivashanmugam requested a review from 0xba1a April 21, 2026 08:50
Comment thread docs/examples/microbots_introduction/log_analysis_bot.py Outdated
|----------|------|----------|-------------|
| `model` | `str` | Yes | The LLM to use, in the format `<provider>/<model_name>`. Supported providers include `azure-openai`, `anthropic`, and `ollama`. |
| `folder_to_mount` | `str` | Yes | Path to the local folder the bot can access. For `LogAnalysisBot`, this is mounted as **read-only** inside the Docker container so the bot can read source files but never modify them. |
| `environment` | `any` | No | A custom execution environment. Defaults to a `LocalDockerEnvironment` if not provided. |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You don't need to mention all the possible arguments here. Please explain only those arguments. In parallel, you can generate an auto documentation and link to the class definition of LogAnalysisBot.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added references to LogAnalysisBot Class

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently, the explanation is very minimal (at section-3 of "Create your first microbot project)". Please add explanation about the api calls and their arguments (only those are there in the example). Also, the API reference page links is missing.

Copy link
Copy Markdown
Collaborator Author

@shivashanmugam shivashanmugam May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done
image

```
Prints the bot's root-cause analysis.

The `my_bot.run()` method returns a `BotRunResult` object with the following fields:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BotRunResult should be a link to the BotRunResult class documentation. In python document generation is easier. That document you should create and make corresponding link.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added references to "BotRunResult

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This BotRunResult explanation and API reference linkage is missing

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done
image

shivashanmugam and others added 3 commits April 27, 2026 09:55
Co-authored-by: Copilot <copilot@github.com>
Co-authored-by: Copilot <copilot@github.com>
@shivashanmugam shivashanmugam requested a review from 0xba1a April 29, 2026 06:29
Comment thread docs/advanced/technical-writing-guidelines.md
Comment thread docs/getting-started/create-your-first-microbot-project/index.md
Comment thread docs/getting-started/create-your-first-microbot-project/index.md Outdated
Comment thread docs/getting-started/create-your-first-microbot-project/index.md Outdated
Comment thread docs/getting-started/conclusion.md
Comment thread docs/getting-started/prerequisites.md Outdated
Comment thread docs/getting-started/prerequisites.md Outdated
Comment thread docs/getting-started/prerequisites.md Outdated
Comment thread docs/index.md Outdated
Comment thread README.md
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove logs from being checked-in

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

removed

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please don't check-in log files

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed the log files


1. **Created a Docker container** with the `code` folder mounted using the appropriate permissions.
2. **Sent your task** to the LLM along with a system prompt tailored to the bot type.
3. **Executed commands** inside the container as directed by the LLM (e.g., `cat`, `grep`, `sed`).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please check whether the relevant code is pushed to GitHub. Because I cannot see the explanation text and full log between python log_analysis_bot.py command and output snippet.

|----------|------|----------|-------------|
| `model` | `str` | Yes | The LLM to use, in the format `<provider>/<model_name>`. Supported providers include `azure-openai`, `anthropic`, and `ollama`. |
| `folder_to_mount` | `str` | Yes | Path to the local folder the bot can access. For `LogAnalysisBot`, this is mounted as **read-only** inside the Docker container so the bot can read source files but never modify them. |
| `environment` | `any` | No | A custom execution environment. Defaults to a `LocalDockerEnvironment` if not provided. |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently, the explanation is very minimal (at section-3 of "Create your first microbot project)". Please add explanation about the api calls and their arguments (only those are there in the example). Also, the API reference page links is missing.

```
Prints the bot's root-cause analysis.

The `my_bot.run()` method returns a `BotRunResult` object with the following fields:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This BotRunResult explanation and API reference linkage is missing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants