# migrating-ai-sdk-to-common-ai

Переводит Airflow-проекты с airflow-ai-sdk на официальный провайдер apache-airflow-providers-common-ai 0.4.0+. Пригодится, когда LLM-декораторы и конфигурация моделей переезжают на соединения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 348 установок · ★ 456
- Автор: astronomer
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/astronomer/agents/tree/HEAD/skills/migrating-ai-sdk-to-common-ai/SKILL.md
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/skills/migrating-ai-sdk-to-common-ai

## Что делает

Скилл ведёт миграцию по шагам. Сначала он ищет по репозиторию всё, что связано со старым SDK: импорты `airflow_ai_sdk`, декораторы `@task.llm`, `@task.agent`, `@task.llm_branch`, `@task.embed`, строки моделей вроде `"gpt-5"` и классы `airflow_ai_sdk.BaseModel`. По этой описи строятся дальнейшие правки.

Дальше меняются зависимости: `airflow-ai-sdk[openai]` уходит, вместо него встаёт `apache-airflow-providers-common-ai[openai]>=0.4.0`. Конфигурация модели переезжает из кода в Airflow-соединение типа `pydanticai` с идентификатором `pydanticai_default`, модель задаётся в формате `provider:model`. Параметр `model` в декораторе заменяется на `llm_conn_id`, а `result_type` — на `output_type`.

Что нужно заранее: новый провайдер требует Airflow 3.0+ и для 0.4.0 — `pydantic-ai-slim >= 1.71.0`. Декоратора `@task.embed` в новом провайдере нет, эмбеддинги уезжают в интеграцию с LlamaIndex или в обычный `@task`. Если проект уже на common-ai 0.1.x, скилл тоже пригодится: между 0.1.0 и 0.4.0 поменялись мультимодальные промпты, `toolsets`, операторы эмбеддингов и поведение XCom при структурированном выводе.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill migrating-ai-sdk-to-common-ai -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/migrating-ai-sdk-to-common-ai/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/migrating-ai-sdk-to-common-ai/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill migrating-ai-sdk-to-common-ai -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/migrating-ai-sdk-to-common-ai/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill migrating-ai-sdk-to-common-ai -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/migrating-ai-sdk-to-common-ai/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install astronomer/agents migrating-ai-sdk-to-common-ai
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/migrating-ai-sdk-to-common-ai/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill migrating-ai-sdk-to-common-ai -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/astronomer/agents --path skills/migrating-ai-sdk-to-common-ai
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/migrating-ai-sdk-to-common-ai/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill migrating-ai-sdk-to-common-ai -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/astronomer/agents/tree/HEAD/skills/migrating-ai-sdk-to-common-ai/SKILL.md

## Когда брать
- заменить `airflow-ai-sdk` на официальный провайдер `common-ai`
- перенести конфигурацию модели из кода в Airflow-соединение `pydanticai`
- переписать импорты с `airflow_ai_sdk` на новый провайдер
- обновить проект с common-ai 0.1.x до 0.4.x
- перевести `@task.embed` на оператор эмбеддингов LlamaIndex

## Примеры запросов агенту
- Пройди по проекту и найди всё, что использует `airflow-ai-sdk`, потом помоги мигрировать на `apache-airflow-providers-common-ai`
- Замени в моих DAG-ах `model="gpt-5"` на соединение `pydanticai_default`
- Обнови проект с common-ai 0.1.x до 0.4.0: мультимодальные промпты, toolsets, операторы эмбеддингов

## Похожие
- [migrating-vercel-ai-sdk-and-eve-to-pydantic-ai](https://affpapa.org/nevibecode/skills/migrating-vercel-ai-sdk-and-eve-to-pydantic-ai.md) — скилл · 306 установок
- [migrating-claude-agent-sdk-to-pydantic-ai](https://affpapa.org/nevibecode/skills/migrating-claude-agent-sdk-to-pydantic-ai.md) — скилл · 308 установок
- [arize-phoenix-migration](https://affpapa.org/nevibecode/skills/arize-phoenix-migration.md) — скилл · 467 установок
- [openai-agents-sdk](https://affpapa.org/nevibecode/skills/laguagu-openai-agents-sdk.md) — скилл · 2200 установок
- [sap-cloud-sdk-ai-python](https://affpapa.org/nevibecode/skills/sap-cloud-sdk-ai-python.md) — скилл · 545 установок
- [migrating-to-workflow-sdk](https://affpapa.org/nevibecode/skills/migrating-to-workflow-sdk.md) — скилл · 734 установки

Из того же набора: [astronomer/agents](https://affpapa.org/nevibecode/by/astronomer/agents.md) — 23 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md