Skip to content

Conversation

@pedrominatel
Copy link
Member

@pedrominatel pedrominatel commented Apr 22, 2025

Description

This PR adds the chatbot AI to the Developer Portal.

Similar to the Docs and the ESP32.com Forum, the chatbot adds a new interface for search and advanced chat with the Espressif chatbot, which includes the Developer Portal in the LLM.

TODO:

  • Get a new data-website-id.
  • Fix the layout when the pop-up is shown.

Related

Testing


Checklist

Before submitting a Pull Request, please ensure the following:

  • 🚨 This PR does not introduce breaking changes.
  • All CI checks (GH Actions) pass.
  • Documentation is updated as needed.
  • Tests are updated or added as necessary.
  • Code is well-commented, especially in complex areas.
  • Git history is clean — commits are squashed to the minimum necessary.

@pedrominatel pedrominatel requested a review from f-hollow April 22, 2025 10:44
@pedrominatel pedrominatel added the needs review Needs someone to be assigned to review label Apr 24, 2025
@pedrominatel
Copy link
Member Author

@f-hollow, PTAL.

@f-hollow
Copy link
Collaborator

@pedrominatel The layout seems to be working fine.

From this PR it looks like we include the AI bot just because it can be included.

I believe it is important to set expectations and goals for it first in the context of our project and then strive to realize these expectations and goals.

With that in mind, my questions are:

  • What we want from the AI bot on the Developer Portal?
  • How it is supposed to help the readers?

If you have the answers, please add them to the description. If not, we can discuss it at our meeting.

@pedrominatel pedrominatel marked this pull request as draft April 28, 2025 10:15
@pedrominatel
Copy link
Member Author

Let's investigate how to include/integrate the chatbot into the portal search, like this integration: docs.lyzr.ai.

Screenshot 2025-05-02 at 14 30 44

Added the new data-site-id for the Developer Portal

Fix the layout issue

Fix the layout issue and webp images for the chatbot logos
@pedrominatel pedrominatel marked this pull request as ready for review September 3, 2025 10:35
@pedrominatel
Copy link
Member Author

@f-hollow, PTAL.

@f-hollow
Copy link
Collaborator

f-hollow commented Sep 4, 2025

@pedrominatel Integration into the portal looks seamless.

Suggestion on leaving feedback:

The chatbot preamble says:

Give it a try, share your thoughts, and let us know your feedback—we truly appreciate it!

However, it is not clear how to share feedback. If I was a user, I would probably leave a comment on the chatbot performance in some article related to my question. From a maintainer's perspective, it is not a desirable outcome.

Suggestion for the chatbot window:

  • Better adapt the chatbot window to the mobile version (if it is possible from the Espressif side). Now there is too much white space between the example questions and the search box (see the screenshot below).
image

@pedrominatel pedrominatel merged commit f265990 into espressif:main Sep 9, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs review Needs someone to be assigned to review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants