Skip to content

OpenAI agents docs #99

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

CakeCrusher
Copy link

@CakeCrusher CakeCrusher commented Aug 4, 2025

OpenAI agent docs & backlinks when mentioning llm agent frameworks (to avoid bloated docs)


Important

Update documentation to include OpenAI Agents as a supported framework and link to supported frameworks list.

  • Documentation Updates:
    • Add OpenAI Agents to supported frameworks in supported.mdx.
    • Replace specific framework mentions (e.g., LangChain, LlamaIndex) with a link to [supported LLM framework](/openllmetry/tracing/supported#frameworks) in introduction.mdx, getting-started-nextjs.mdx, getting-started-python.mdx, getting-started-ts.mdx, and annotations.mdx.

This description was created by Ellipsis for 1191cb0. You can customize this summary. It will automatically update as commits are pushed.

Summary by CodeRabbit

  • Documentation
    • Updated references to LLM frameworks across documentation to point to a centralized list of supported frameworks, replacing specific examples with a general link.
    • Added "OpenAI Agents" to the list of supported frameworks, indicating Python support and Typescript non-support.

Copy link

coderabbitai bot commented Aug 4, 2025

Walkthrough

The documentation was updated to generalize references to supported LLM frameworks by replacing explicit framework names with links to a centralized list of supported frameworks. Additionally, "OpenAI Agents" was added as a supported framework in the relevant documentation section. No changes were made to code, logic, or public entities.

Changes

Cohort / File(s) Change Summary
Generalize framework references in documentation
monitoring/introduction.mdx, openllmetry/getting-started-nextjs.mdx, openllmetry/getting-started-python.mdx, openllmetry/getting-started-ts.mdx, openllmetry/introduction.mdx, openllmetry/tracing/annotations.mdx
Replaced explicit mentions of LLM frameworks (e.g., LangChain, LlamaIndex, Haystack) with generalized links to a supported frameworks list.
Update supported frameworks list
openllmetry/tracing/supported.mdx
Added "OpenAI Agents" to the supported frameworks table, indicating Python support and Typescript non-support.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

In docs we hopped, with links anew,
No more naming just a few!
All frameworks now in one grand list,
So none are ever missed.
OpenAI Agents join the crew—
The garden of support just grew!
🐇✨

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.


📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 1191cb0 and 6fb8a6f.

📒 Files selected for processing (1)
  • monitoring/introduction.mdx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • monitoring/introduction.mdx
✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed everything up to 1191cb0 in 1 minute and 20 seconds. Click for details.
  • Reviewed 87 lines of code in 7 files
  • Skipped 0 files when reviewing.
  • Skipped posting 8 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. monitoring/introduction.mdx:9
  • Draft comment:
    Updated link to [supported LLM framework] improves clarity and maintainability. Confirm that '/openllmetry/tracing/supported#frameworks' is the intended anchor.
  • Reason this comment was not posted:
    Comment looked like it was already resolved.
2. openllmetry/getting-started-nextjs.mdx:175
  • Draft comment:
    Consistent update: replacing explicit framework names with a link to [supported LLM framework] improves doc upkeep. Verify that the supported frameworks list is up‐to‐date.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% The comment is asking the PR author to verify that the supported frameworks list is up-to-date, which falls under the rule of not asking the author to ensure or verify things. It doesn't provide a specific code suggestion or ask for a specific test to be written. Therefore, it should be removed.
3. openllmetry/getting-started-python.mdx:60
  • Draft comment:
    Tip update: Using the [supported LLM framework] link streamlines guidance and aligns with other SDK docs.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative and does not provide any actionable feedback or suggestions for improvement. It simply states a tip about using a supported LLM framework link, which does not align with the rules for useful comments.
4. openllmetry/getting-started-ts.mdx:73
  • Draft comment:
    Updated tip in the Typescript guide now references [supported LLM framework], ensuring consistency across documentation.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative, as it only states that a tip in the Typescript guide has been updated to reference a supported LLM framework. It does not provide any actionable feedback or suggestions for improvement.
5. openllmetry/introduction.mdx:12
  • Draft comment:
    Link update in the tip now directs to [supported LLM framework], which improves clarity about framework support vs. direct API usage.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative, as it only describes what the change does without providing any actionable feedback or suggestions. It doesn't ask for confirmation or suggest improvements.
6. openllmetry/tracing/annotations.mdx:14
  • Draft comment:
    Updated tip in annotations docs now links to [supported LLM framework] for clarity and consistency in usage instructions.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative, as it only states that a tip in the documentation has been updated to link to a supported framework. It doesn't provide any actionable feedback or suggestions for improvement.
7. openllmetry/tracing/supported.mdx:53
  • Draft comment:
    Added 'OpenAI Agents' to the supported frameworks table. Please verify that the support status (Python: ✅, Typescript: ❌) is accurate.
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% The comment is asking the PR author to verify the accuracy of the support status for 'OpenAI Agents' in the supported frameworks table. This falls under asking the author to confirm or double-check something, which is against the rules.
8. openllmetry/introduction.mdx:15
  • Draft comment:
    Typo: The term "OpenLLMetry" appears here. It looks like it might be a misspelling of "OpenTelemetry" (as mentioned earlier in the document). Please verify and correct if necessary.
  • Reason this comment was not posted:
    Comment was on unchanged code.

Workflow ID: wflow_z2TD9y0jWsypBlX3

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@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: 1

🧹 Nitpick comments (2)
openllmetry/getting-started-ts.mdx (1)

75-78: Double-check anchor validity & tighten copy

  1. Ensure /openllmetry/tracing/supported#frameworks is the correct anchor. If the section header ever changes, the link will silently break.
  2. Minor wording polish: use an em-dash instead of a trailing dash+line-break and drop the extra space.
-If you're using a [supported LLM framework](/openllmetry/tracing/supported#frameworks) - 
-  we'll do that for you. No need to add any annotations to your code.
+If you're using a [supported LLM framework](/openllmetry/tracing/supported#frameworks),  
+we’ll do that for you—no need to add any annotations to your code.
openllmetry/getting-started-python.mdx (1)

60-63: Keep link in sync & streamline phrasing

Same comments as the TS doc: verify the #frameworks anchor and switch to a comma + em-dash for smoother reading.

-If you're using a [supported LLM framework](/openllmetry/tracing/supported#frameworks) - 
-  we'll do that for you. No need to add any annotations to your code.
+If you're using a [supported LLM framework](/openllmetry/tracing/supported#frameworks),  
+we’ll do that for you—no need to add any annotations to your code.
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between edd6ef7 and 1191cb0.

📒 Files selected for processing (7)
  • monitoring/introduction.mdx (1 hunks)
  • openllmetry/getting-started-nextjs.mdx (1 hunks)
  • openllmetry/getting-started-python.mdx (1 hunks)
  • openllmetry/getting-started-ts.mdx (1 hunks)
  • openllmetry/introduction.mdx (1 hunks)
  • openllmetry/tracing/annotations.mdx (1 hunks)
  • openllmetry/tracing/supported.mdx (1 hunks)
🔇 Additional comments (4)
openllmetry/tracing/supported.mdx (1)

53-54: Entry addition looks accurate

The new “OpenAI Agents” row is alphabetically positioned and the support flags match the current SDK reality. No further changes needed.

openllmetry/introduction.mdx (1)

14-16: Anchor check

The new link to /openllmetry/tracing/supported#frameworks should resolve to the “Frameworks” section slug. It usually does, but please do a quick local run to confirm the hash is indeed #frameworks (Docusaurus sometimes lower-cases headers or adds dashes for duplicates).

openllmetry/getting-started-nextjs.mdx (1)

178-180: Consistent phrasing 👍

The generic reference keeps the docs DRY and future-proof.

openllmetry/tracing/annotations.mdx (1)

14-16: Good cross-linking

Same comment as above: just double-check the #frameworks hash renders exactly as written to avoid a silent 404.

This is correct

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
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