Add AISIX AI Gateway integration page

[Yilialinn]

Summary

This adds an AISIX AI Gateway integration page showing how a Haystack RAG pipeline can send model requests through AISIX with the built-in OpenAIChatGenerator.

The example demonstrates:

• separate gateway caller and upstream provider credentials;
• a stable caller-facing model alias backed by two AISIX targets;
• gateway-owned failover with Haystack client retries disabled for the example; and
• a complete in-memory BM25 RAG pipeline, rather than only a custom api_base_url snippet.

No new Haystack component, integration package, or dependency is introduced.

Validation

• Tested with Haystack 3.1.1 and ghcr.io/api7/aisix:1.2.0.
• Validated the AISIX resource schema with aisix validate.
• Ran the documented Python example end to end against a deterministic OpenAI-compatible fixture.
• Confirmed that a primary HTTP 503 caused AISIX to use the backup target and that an invalid caller key returned HTTP 401 without reaching the upstream fixture.

Scope

The change is limited to one integration page. It adds no package, logo, generated asset, or runtime code.

Disclosure: I work at API7.ai, which maintains AISIX. AISIX is an independent Apache-2.0-licensed open-source project and is not an Apache Software Foundation project.

[vercel]

@Yilialinn is attempting to deploy a commit to the deepset Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
haystack-integrations	Ready	Preview	Sep 17, 2026 4:19pm UTC

[Copilot]

🟢 Approval recommended

No unresolved review issues were identified.

Pull request overview

Adds an AISIX AI Gateway integration guide for Haystack’s OpenAIChatGenerator, including credential separation, failover, and an end-to-end BM25 RAG example.

Changes:

• Documents AISIX installation and configuration.
• Explains gateway-owned retries and failover.
• Adds a complete Haystack RAG example.

File summaries

File	Summary
integrations/aisix.md	New AISIX integration documentation and example.

Review details

• Files reviewed: 1/1 changed files
• Comments generated: 0
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[kacperlukawski]

Thank you, @Yilialinn I made a small change and should be ready to merge