Skip to content
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

[Fix] Updated notebooks that publish to examples docs pages #585

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

Conversation

the-praxs
Copy link
Member

@the-praxs the-praxs commented Dec 16, 2024

Updated notebooks that publish to examples docs pages

Purpose

  • To make the example notebooks and docs pages clean and consistent for a good developer UX.
  • To sync the example notebook and the respective example docs pages for various integrations.
  • Clean the example notebooks

Changes

Example Docs Jupyter Notebook
v1/examples/langchain langchain_examples
v1/examples/multion Autonomous_web_browsing
v1/examples/simple_agent openai-gpt
v1/examples/camel camelai-multi-agent-example

Miscellaneous

  • Modified Anthropic example notebooks and corresponding README
  • Merged CAMEL-AI notebook examples into a single notebook camel-simple-examples.ipynb
  • Added a new notebook for the langchain v0 example langchain_v0_example.ipynb
  • Modified agentops key variable name in xAI example notebook

@the-praxs the-praxs requested a review from areibman December 16, 2024 12:21
@the-praxs the-praxs added documentation Improvements or additions to documentation and removed in progress do not merge labels Dec 16, 2024
@the-praxs
Copy link
Member Author

@TKTSWalker have a look here as I said before.

@TKTSWalker
Copy link
Contributor

Hey, just giving things a look right now! There seems to be be 2 blocks for CamelAI on the intiial readme to begin

image

image

Mine's is the second one although with a broken link (from the links being set to the wrong place, examples/camel is now examples/camel_examples)! I mainly formatted it that way to match the formatting of the rest for readability (well with the lower agents anyways), the Installation part is definitely better than what I placed for sure though!

I'm also surprised there isn't some sort of general glossary for example files if you guys would rather not have a reference to the github side journals! Adding an area to the bottom can help greatly with this, having names for each integration and a quickview of what's within!

Then on the journal end things look mostly fine (although I have been awake for the last 48h working on a few projects so I might be missing details here)! One thing I always like to do when making journals though is simplify terms and logic to best fit the example (although I should use the technical terms a little more)! So I was thinking maybe I could spin my hand and make examples with the simple terms for newcomers and once again for pros! As an example, one snippet you put was;

"first we'll create an instance of the AO LangchainCallbackHandler. After the handler is initialized, a session will be recorded automatically."

This could be mirrored with something like

"We will create an object for holding data called "Variable Name". When we call it, AgentOps will automatically record for us!"

Or something like that, just throwing ideas around there more than anything else though!

The CamelAI page has more broken references in general relating to files, although I like how you implemented the training data link way more!

I'll be a little busy today as i've gotta work on something for a little project of mines and handle a few other things, but if you want me to hop on fixing these through a push request to your repo it's something I can do!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants