Ai Workflows

---
name: ai-workflows
description: "Mage AI-assisted pipeline generation, documentation, and model configuration."
metadata:
  disco-role: operating
disable-model-invocation: true
license: Apache 2.0
---

# AI Workflows

Use this route for Mage's AI-assisted code and documentation helpers.

## Owns

- Pipeline generation from descriptions
- Block generation from descriptions
- Block and pipeline documentation generation
- Comment generation for existing code
- OpenAI and Hugging Face AI client configuration
- AI setup and credential troubleshooting

## Excludes

- Manual block authoring, which belongs in `pipeline-authoring`
- Connector or `io_config` setup, which belongs in `batch-integrations`
- Streaming connectors, which belong in `streaming`
- dbt orchestration, which belongs in `dbt-workflows`
- CLI/bootstrap/auth/logging, which belongs in `platform-ops`

## Use this route when

- The user asks Mage to generate a pipeline or block from a prompt
- The user wants docs or comments generated for code already in the repo
- The user needs to configure or debug AI model access for Mage features

## Bundled reference

Read `references/ai-workflows.md` for the AI command matrix, config objects, and setup notes.

## Bundled script

- `scripts/check_ai_config.py` — safe AI-mode and credential inspection without calling a live model

## Core reminders

- The code supports both OpenAI and Hugging Face client paths.
- AI features require a valid API key or endpoint configuration.
- Mage Pro chat features exist in the repo, but the OSS generation helpers are the main workflow in this skill.