Skip to content

Add documentation for creating and modifying assistants#599

Merged
SangeetaMishr merged 4 commits intomainfrom
update-docs-assistants-new-ui
Apr 14, 2026
Merged

Add documentation for creating and modifying assistants#599
SangeetaMishr merged 4 commits intomainfrom
update-docs-assistants-new-ui

Conversation

@mahajantejas
Copy link
Copy Markdown
Collaborator

@mahajantejas mahajantejas commented Apr 14, 2026

This document provides a comprehensive guide on creating, modifying, and using assistants within Glific flows, including step-by-step instructions and key points to note.

Copied from here: https://docs.google.com/document/d/1wbhmt2xzX44KkdBfi6fFGa-Xs5J9xJ0vv_HwFyktRu0/edit?pli=1&tab=t.0 (to make reviewing easier for screenshots)

Summary by CodeRabbit

  • Documentation
    • Added comprehensive guide for creating, modifying, and copying assistants in Glific, including step-by-step instructions, configuration options, and version management best practices.

This document provides a comprehensive guide on creating, modifying, and using assistants within Glific flows, including step-by-step instructions and key points to note.
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 14, 2026

Warning

Rate limit exceeded

@mahajantejas has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 42 minutes and 40 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 42 minutes and 40 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 933bc0ab-f5e1-49ec-a319-5dc427d4b693

📥 Commits

Reviewing files that changed from the base of the PR and between 909285f and 3c19017.

📒 Files selected for processing (1)
  • docs/5. Integrations/Creating and modifying assistants in Glific.md
📝 Walkthrough

Walkthrough

A new documentation page was added explaining how to create, modify, and copy Glific assistants. The guide provides step-by-step instructions with screenshots for assistant configuration, version management, and deployment within the platform.

Changes

Cohort / File(s) Summary
Assistant Documentation
docs/5. Integrations/Creating and modifying assistants in Glific.md
New documentation page covering assistant creation, modification, copying procedures, and version management with step-by-step instructions and operational notes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • glific/docs#393: Covers OpenAI assistants configuration and usage in Glific, including creation and assistant ID management.

Suggested reviewers

  • SangeetaMishr

Poem

🐰 A guide hops into the fold,
Assistant creation steps unfold,
Modify, copy, versions so bright,
Documentation set things right! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding documentation for creating and modifying assistants in Glific, which is the primary purpose of this PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch update-docs-assistants-new-ui

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 14, 2026

@github-actions github-actions Bot temporarily deployed to pull request April 14, 2026 09:50 Inactive
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🧹 Nitpick comments (1)
docs/5. Integrations/Creating and modifying assistants in Glific.md (1)

45-45: Consider simplifying this sentence for clarity.

Line 45 is understandable, but can be made crisper by removing “in order to.”
Example: “This action is needed to modify knowledge bases associated with assistants created before March 10, 2026.”

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/5`. Integrations/Creating and modifying assistants in Glific.md at line
45, Replace the sentence "This action is needed in order to modify knowledge
bases associated with assistants created before 10th March 2026." with a crisper
version that removes "in order to" and standardizes the date format; e.g.,
change it to "This action is needed to modify knowledge bases associated with
assistants created before March 10, 2026." — update the sentence in the same
paragraph that currently contains "This action is needed in order to modify
knowledge bases associated with assistants created before 10th March 2026." in
the document "Creating and modifying assistants in Glific".
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/5`. Integrations/Creating and modifying assistants in Glific.md:
- Line 4: The Markdown heading is malformed ("##Creating a new assistant");
update the heading text used in the docs (the line containing "##Creating a new
assistant") to include a space after the hashes so it reads "## Creating a new
assistant" to satisfy MD018 linting.
- Line 58: Replace the generic link text "here" in the sentence "The workflow on
using the assistants remains the same, can be seen [here](...)" with a
descriptive phrase such as "OpenAI assistant usage in Flow Editor" to satisfy
MD059; update the markdown link so it reads e.g. "can be seen [OpenAI assistant
usage in Flow
Editor](https://glific.github.io/docs/docs/Integrations/Filesearch%20Using%20OpenAI%20Assistants#using-the-openai-assistant-in-floweditor!)"
so the link text is explicit and accessible.
- Around line 49-54: Tighten and correct wording in the key notes and the "Why
are versions created..." paragraph: replace "Be default" with "By default",
change "incase" to "in case", remove repeated "in order to" phrasing by
rewriting sentences for concision (e.g., "By default, new changes are not
applied to a flow; to use the latest modifications you must click 'Set as
LIVE'." and "Versions are created so you can easily revert to a previous state
if needed."), and ensure consistent capitalization of "Set as LIVE"; update the
bullets and explanatory sentence in the key notes and the following paragraph to
use these corrected, tighter phrasings.

---

Nitpick comments:
In `@docs/5`. Integrations/Creating and modifying assistants in Glific.md:
- Line 45: Replace the sentence "This action is needed in order to modify
knowledge bases associated with assistants created before 10th March 2026." with
a crisper version that removes "in order to" and standardizes the date format;
e.g., change it to "This action is needed to modify knowledge bases associated
with assistants created before March 10, 2026." — update the sentence in the
same paragraph that currently contains "This action is needed in order to modify
knowledge bases associated with assistants created before 10th March 2026." in
the document "Creating and modifying assistants in Glific".
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4799edfc-3267-46f5-8fb2-2977514f60de

📥 Commits

Reviewing files that changed from the base of the PR and between c202919 and 909285f.

📒 Files selected for processing (1)
  • docs/5. Integrations/Creating and modifying assistants in Glific.md

Comment thread docs/5. Integrations/Creating and modifying assistants in Glific.md Outdated
Comment thread docs/5. Integrations/Creating and modifying assistants in Glific.md Outdated
2. Any new updates can be evaluated (evaluations feature coming soon in Glific) before deploying to live assistants.

### How to use the assistants in the Glific flow?
The workflow on using the assistants remains the same, can be seen [here](https://glific.github.io/docs/docs/Integrations/Filesearch%20Using%20OpenAI%20Assistants#using-the-openai-assistant-in-floweditor!)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Use descriptive link text instead of “here.”

Line 58 triggers MD059; replace generic link text with something explicit (for example, “OpenAI assistant usage in Flow Editor”).

🧰 Tools
🪛 markdownlint-cli2 (0.22.0)

[warning] 58-58: Link text should be descriptive

(MD059, descriptive-link-text)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/5`. Integrations/Creating and modifying assistants in Glific.md at line
58, Replace the generic link text "here" in the sentence "The workflow on using
the assistants remains the same, can be seen [here](...)" with a descriptive
phrase such as "OpenAI assistant usage in Flow Editor" to satisfy MD059; update
the markdown link so it reads e.g. "can be seen [OpenAI assistant usage in Flow
Editor](https://glific.github.io/docs/docs/Integrations/Filesearch%20Using%20OpenAI%20Assistants#using-the-openai-assistant-in-floweditor!)"
so the link text is explicit and accessible.

@SangeetaMishr
Copy link
Copy Markdown
Collaborator

@mahajantejas Can you add the below code update the relevant fields.

3 minutes read Level: Advanced Last Updated: December 2025

Do include the comments added by coderabit.

mahajantejas and others added 3 commits April 14, 2026 15:34
Added metadata table for reading time, level, and last updated date.
…ic.md

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@mahajantejas
Copy link
Copy Markdown
Collaborator Author

@SangeetaMishr - added the header, and also addressed from the comments from coderabit. thanks

@github-actions github-actions Bot temporarily deployed to pull request April 14, 2026 10:07 Inactive
@SangeetaMishr SangeetaMishr merged commit 28bda69 into main Apr 14, 2026
7 checks passed
@SangeetaMishr SangeetaMishr deleted the update-docs-assistants-new-ui branch April 14, 2026 10:08
@SangeetaMishr
Copy link
Copy Markdown
Collaborator

@mahajantejas - I have reviewed and merged it. Good Work on the screenshot with explanation looks neat

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.

2 participants