Skip to content

docs: add Haystack (deepset) integration page#79

Merged
MVS-source merged 2 commits into
mainfrom
integrations/haystack
Jul 21, 2026
Merged

docs: add Haystack (deepset) integration page#79
MVS-source merged 2 commits into
mainfrom
integrations/haystack

Conversation

@MVS-source

@MVS-source MVS-source commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Adds the Eden AI + Haystack (deepset) integration guide under AI Frameworks.

  • v3/integrations/haystack.mdx: overview, installation, quick start (chat), switching models, streaming, embeddings + RAG, available models, env vars
  • integration-logo/haystack-icondoc.svg: official Haystack logo (currentColor)
  • docs.json: adds the page to the AI Frameworks group (after aisuite)

Eden AI is now an official Haystack integration (the edenai-haystack package, merged into deepset/haystack-core-integrations in #3615). Env var: EDENAI_API_KEY. Python snippets are marked skip-test since edenai-haystack is not in the docs test sandbox.

Summary by CodeRabbit

  • Documentation
    • Added documentation for integrating Haystack with Eden AI.
    • Included installation instructions, chat and streaming examples, model switching guidance, and embeddings with RAG workflows.
    • Added examples of supported models, API key configuration, and links to next steps.
    • Added the Haystack integration page to the V3 documentation navigation under AI Frameworks.

@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

Changes

Haystack integration documentation

Layer / File(s) Summary
Page structure and navigation
docs.json, v3/integrations/haystack.mdx
Adds the Haystack page metadata, schema, overview, installation instructions, and V3 navigation entry.
Chat generation examples
v3/integrations/haystack.mdx
Documents quick-start chat generation, model switching, and streaming callbacks.
RAG and resource reference
v3/integrations/haystack.mdx
Documents embeddings and retrieval, available models, environment variables, and next steps.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

  • edenai/docs#35: Adds an integration MDX page and navigation entry.
  • edenai/docs#70: Uses the same integration-page and TechArticleSchema pattern.
  • edenai/docs#77: Adds an AI Frameworks integration entry and documentation page.

Suggested reviewers: tristantelleb

Poem

I’m a bunny with docs in my paws,
Haystack now hops through Eden’s doors.
Chat, streams, embeddings align,
Models and RAG make the page shine.
Navigation thumps—hip-hop, hooray!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Clear and specific: it accurately describes the new Haystack integration documentation page added in this PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch integrations/haystack

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@v3/integrations/haystack.mdx`:
- Line 63: Update all Haystack 2.x run calls in v3/integrations/haystack.mdx:
lines 63-63 and 107-107 must pass messages=..., line 88-88 must pass
messages=messages, line 131-131 must pass documents=documents, and line 136-136
must pass text=....
- Line 53: Replace the EDENAI_API_KEY placeholder your_api_key_here with
api_token at both affected sites in v3/integrations/haystack.mdx: lines 53-53
and 161-161, preserving the surrounding snippets.
🪄 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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e5bd9aea-7ec9-4799-a3b6-eda766756e02

📥 Commits

Reviewing files that changed from the base of the PR and between aaf25fe and 5b88f84.

⛔ Files ignored due to path filters (1)
  • integration-logo/haystack-icondoc.svg is excluded by !**/*.svg
📒 Files selected for processing (2)
  • docs.json
  • v3/integrations/haystack.mdx


<CodeGroup>
```bash .env
EDENAI_API_KEY=your_api_key_here

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use standard token placeholder.

Both snippets use your_api_key_here, but the coding guidelines require distinguishing token types by using api_token (for production) or sandbox_api_token (for testing) in examples without real provider calls. Please update the placeholder to api_token to maintain consistency across the documentation.

  • v3/integrations/haystack.mdx#L53-L53: replace your_api_key_here with api_token
  • v3/integrations/haystack.mdx#L161-L161: replace your_api_key_here with api_token
📍 Affects 1 file
  • v3/integrations/haystack.mdx#L53-L53 (this comment)
  • v3/integrations/haystack.mdx#L161-L161
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@v3/integrations/haystack.mdx` at line 53, Replace the EDENAI_API_KEY
placeholder your_api_key_here with api_token at both affected sites in
v3/integrations/haystack.mdx: lines 53-53 and 161-161, preserving the
surrounding snippets.

Source: Coding guidelines


generator = EdenAIChatGenerator(model="mistral/mistral-large-latest")

response = generator.run([ChatMessage.from_user("What is Eden AI?")])

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Use keyword arguments for run() calls.

Haystack 2.x components enforce or strongly expect keyword arguments for their .run() methods. Passing positional arguments will result in a TypeError at runtime, causing these code examples to fail when users copy and paste them. Update these calls to explicitly use kwargs.

  • v3/integrations/haystack.mdx#L63-L63: change generator.run([...]) to generator.run(messages=[...])
  • v3/integrations/haystack.mdx#L88-L88: change generator.run(messages) to generator.run(messages=messages)
  • v3/integrations/haystack.mdx#L107-L107: change generator.run([...]) to generator.run(messages=[...])
  • v3/integrations/haystack.mdx#L131-L131: change doc_embedder.run(documents) to doc_embedder.run(documents=documents)
  • v3/integrations/haystack.mdx#L136-L136: change text_embedder.run("What is Eden AI?") to text_embedder.run(text="What is Eden AI?")
📍 Affects 1 file
  • v3/integrations/haystack.mdx#L63-L63 (this comment)
  • v3/integrations/haystack.mdx#L88-L88
  • v3/integrations/haystack.mdx#L107-L107
  • v3/integrations/haystack.mdx#L131-L131
  • v3/integrations/haystack.mdx#L136-L136
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@v3/integrations/haystack.mdx` at line 63, Update all Haystack 2.x run calls
in v3/integrations/haystack.mdx: lines 63-63 and 107-107 must pass messages=...,
line 88-88 must pass messages=messages, line 131-131 must pass
documents=documents, and line 136-136 must pass text=....

@mintlify

mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
edenai 🟢 Ready View Preview Jul 21, 2026, 1:50 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@MVS-source
MVS-source merged commit cb8972b into main Jul 21, 2026
6 checks passed
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.

1 participant