Skip to content

docs: Update customizations how-to guides to use collections API and LLM factory - #2425

Merged
anistark merged 3 commits into
vibrantlabsai:mainfrom
sanjeed5:docs/update-howtos-customizations
Nov 28, 2025
Merged

docs: Update customizations how-to guides to use collections API and LLM factory#2425
anistark merged 3 commits into
vibrantlabsai:mainfrom
sanjeed5:docs/update-howtos-customizations

Conversation

@sanjeed5

@sanjeed5 sanjeed5 commented Nov 14, 2025

Copy link
Copy Markdown
Contributor

Issue Link / Problem Description

Updates customize_models.md guide to use modern llm_factory and embedding_factory APIs instead of legacy LangChain wrapper pattern.

Changes Made

  • Updated Azure OpenAI example to use llm_factory with litellm provider
  • Updated Google Vertex AI example to use llm_factory with litellm provider (major simplification)
  • Updated AWS Bedrock example to use llm_factory with litellm provider
  • Fixed Azure model naming to use deployment names

Testing

How to Test

  • Manual testing steps:
    1. Azure OpenAI, Google Vertex, AWS Bedrock: Syntax validated against LiteLLM and Instructor documentation
    2. No actual API calls made for cloud providers (no environment setup)
    3. Code patterns verified against official docs

References

@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Nov 14, 2025
Replace legacy LangChain wrapper pattern with llm_factory and
embedding_factory using LiteLLM provider for all cloud providers.

Changes:
Updated examples
- Removed LangChain dependencies (langchain_openai, langchain_google_vertexai,
  langchain_aws) in favor of litellm
- Fixed Azure model naming to use deployment names (azure/{deployment-name})
- Removed unnecessary interface="modern" parameter (auto-detected)

Benefits:
- Consistent pattern across all cloud providers
- Simpler code with fewer dependencies
- No LangChain required
- Uses modern Ragas factory APIs with Instructor and LiteLLM

All syntax verified against LiteLLM and Instructor documentation.
@sanjeed5
sanjeed5 force-pushed the docs/update-howtos-customizations branch from ba00799 to fff3d36 Compare November 27, 2025 13:46
- Use litellm.completion (function) instead of litellm (module)
- Pass Azure config directly to embedding_factory instead of global settings
- Add clarifying comments about the correct patterns

Tested with actual API calls via OpenAI/litellm integration.
@anistark
anistark merged commit 9e831f7 into vibrantlabsai:main Nov 28, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants