API7 网关 AI Agent Skill：plugin ai prompt template

本页提供 plugin ai prompt template 场景的 API7 企业版操作指南。请保留下方命令、字段、配置项和 API 路径的原样，并根据实际网关环境替换示例值。

Overview

The ai-prompt-template plugin pre-configures prompt templates with {{variable}} placeholders. Clients submit only the template name and variable values; the plugin fills the template and produces a complete chat-completion request. This enforces prompt structure and prevents clients from sending arbitrary system prompts.

Priority: 1071 (runs before ai-prompt-decorator at 1070 and ai-proxy at 1040).

When to Use

• Enforce a fixed prompt structure across all clients
• Accept user inputs only for specific fields (fill-in-the-blank)
• Prevent prompt injection by controlling the system message
• Build prompt libraries that clients select by name
• Standardize prompt templates directly on services or routes

Plugin Configuration Reference

Field	Type	Required	Description
templates	array	Yes	Array of template objects (min 1)
templates[].name	string	Yes	Template identifier (min length 1)
templates[].template	object	Yes	Template specification
templates[].template.model	string	Yes	AI model name
templates[].template.messages	array	Yes	Array of message objects (min 1)
templates[].template.messages[].role	string	Yes	system, user, or assistant
templates[].template.messages[].content	string	Yes	Prompt content with {{variable}} placeholders

Client Request Format

Instead of sending a standard messages array, clients send:

{
  "template_name": "my-template",
  "variable1": "value1",
  "variable2": "value2"
}

Step-by-Step: Create a Templated Route

1. Create a route with ai-prompt-template and ai-proxy

All runtime resources must be scoped to a gateway group using --gateway-group or -g.

a7 service create -g default -f - <<'EOF'
{
  "id": "ai-chat-service",
  "name": "AI Chat Service"
}
EOF

a7 route create -g default -f - <<'EOF'
{
  "id": "templated-chat",
  "uri": "/v1/chat/completions",
  "service_id": "ai-chat-service",
  "methods": ["POST"],
  "plugins": {
    "ai-proxy": {
      "provider": "openai",
      "auth": {
        "header": {
          "Authorization": "Bearer sk-your-key"
        }
      },
      "options": {
        "model": "gpt-4"
      }
    },
    "ai-prompt-template": {
      "templates": [
        {
          "name": "code-review",
          "template": {
            "model": "gpt-4",
            "messages": [
              {
                "role": "system",
                "content": "You are an expert {{language}} code reviewer. Review the code for bugs, performance issues, and style."
              },
              {
                "role": "user",
                "content": "Review this code:\n\n{{code}}"
              }
            ]
          }
        }
      ]
    }
  }
}
EOF

2. Send a request with template variables

curl http://127.0.0.1:9080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "code-review",
    "language": "Python",
    "code": "def add(a, b): return a + b"
  }'

Using Services

You can define standard prompt templates on a service and attach routes to that service.

a7 service create -g default -f - <<'EOF'
{
  "id": "global-ai-prompts",
  "name": "Global AI Prompts",
  "plugins": {
    "ai-prompt-template": {
      "templates": [
        {
          "name": "summarize",
          "template": {
            "model": "gpt-4",
            "messages": [
              {"role": "system", "content": "Summarize this in one sentence."},
              {"role": "user", "content": "{{text}}"}
            ]
          }
        }
      ]
    }
  }
}
EOF

Config Sync Example

Config sync is scoped by gateway group:

a7 config sync -f config.yaml --gateway-group default

version: "1"
services:
  - id: ai-chat-service
    name: AI Chat Service
routes:
  - id: templated-chat
    uri: /v1/chat/completions
    service_id: ai-chat-service
    methods:
      - POST
    plugins:
      ai-proxy:
        provider: openai
        auth:
          header:
            Authorization: Bearer sk-your-key
        options:
          model: gpt-4
      ai-prompt-template:
        templates:
          - name: code-review
            template:
              model: gpt-4
              messages:
                - role: system
                  content: "You are an expert {{language}} code reviewer."
                - role: user
                  content: "Review this code:\n\n{{code}}"

Troubleshooting

Symptom	Cause	Fix
400 "template not found"	template_name doesn't match configured template	Check spelling and case
Unfilled {{variable}}	Variable key missing from request body	Include all variables in the request JSON
404 Not Found	Missing --gateway-group	Ensure all runtime commands include -g <group>
Plugin not transforming	Wrong plugin name	Verify plugin name is ai-prompt-template

---

This page is generated from a7-plugin-ai-prompt-template/SKILL.md in the api7/a7 repository. Browse all skills on the AI Agent Skills page.