apache/apisix

config.yaml.example is missing some AI plugins and has incorrect ordering

Open

#13108 opened on Mar 19, 2026

View on GitHub
 (4 comments) (0 reactions) (1 assignee)Lua (16,597 stars) (2,860 forks)batch import
docgood first issue

Description

Description

Follow-up from #12926. While that PR fixed incorrect priority comments for ai-proxy, ai-proxy-multi, and ai-aws-content-moderation, there are still remaining issues in conf/config.yaml.example:

1. Missing AI plugins

The following plugins are registered in apisix/cli/config.lua but are not listed in config.yaml.example:

Plugin Priority Source
ai-request-rewrite 1073 apisix/plugins/ai-request-rewrite.lua
ai-aliyun-content-moderation 1029 apisix/plugins/ai-aliyun-content-moderation.lua

2. AI plugins not fully sorted by descending priority

The current AI plugin section in config.yaml.example:

  - ai-prompt-template             # priority: 1071
  - ai-prompt-decorator            # priority: 1070
  - ai-prompt-guard                # priority: 1072
  - ai-rag                         # priority: 1060
  - ai-aws-content-moderation      # priority: 1050
  - ai-proxy-multi                 # priority: 1041
  - ai-proxy                       # priority: 1040
  - ai-rate-limiting               # priority: 1030

ai-prompt-guard (priority 1072) should be listed before ai-prompt-template (priority 1071) to maintain descending priority order.

Expected result

After adding the missing plugins and fixing the order, the AI plugins section should look like:

  - ai-request-rewrite             # priority: 1073
  - ai-prompt-guard                # priority: 1072
  - ai-prompt-template             # priority: 1071
  - ai-prompt-decorator            # priority: 1070
  - ai-rag                         # priority: 1060
  - ai-aws-content-moderation      # priority: 1050
  - ai-proxy-multi                 # priority: 1041
  - ai-proxy                       # priority: 1040
  - ai-rate-limiting               # priority: 1030
  - ai-aliyun-content-moderation   # priority: 1029

Contributor guide

Tech stack
None
Domain
documentation
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Knowledge of YAML syntaxUnderstanding of APISIX plugin priorities
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
90
Research direction
The issue requires adding two missing plugins (ai request rewrite and ai aliyun content moderation) to conf/config.yaml.example and reordering one entry (ai prompt guard) to maintain descending priority order. The correct priorities are provided in the issue description. The fix involves editing the YAML file and verifying the order matches the expected list. Ensure no other plugins are out of order.