Skip to main content

Developer Portal Service — AI Integration

Version: 1.0 Status: Draft Owner: Product + Developer Relations (DevRel) Last Updated: 2026-04-20

1. Intent​

Catalogue every AI call the Developer Portal makes. The portal uses AI narrowly: enriching auto-generated code snippets with natural-language descriptions and onboarding hints. AI is never used to generate, sign, or evaluate credentials, verify codes, or security-sensitive logic. All AI calls route through the platform's AI gateway, never direct to vendor SDKs.

2. Use Cases​

  • Snippet description enrichment — TBD (the snippet code is deterministic; AI only authors the surrounding "what this does / why" prose)
  • Onboarding chatbot ("Ask the docs") — TBD (deferred to v1.1 — see SERVICE_OVERVIEW §13)
  • Localised guide drafts (English → Pashto/Dari) — TBD (DevRel reviews every translation before publish)

3. Prompt Templates​

  • TBD

4. Moderation Policy​

  • TBD (no PII in prompts; all AI output passes a regex + classifier filter for credentials, code-injection patterns, and policy-violating content)

5. HITL (Human-in-the-Loop) Flow​

  • TBD (DevRel reviews AI-authored guide content before publish; AI-augmented snippets show an info banner indicating review status)

6. AIProvenance Touch Points​

  • TBD (every AI-augmented field is annotated with { provider, model, version, promptHash, reviewedBy, reviewedAt } in devportal.docs_articles.ai_provenance jsonb column)

7. Rules​

  • AI never generates, stores, or evaluates Verify codes, API keys, or any cryptographic material.
  • AI output that affects code is always human-reviewed before going live.
  • All AI calls flow through the ai-gateway-service; no vendor SDK in this service.