Перейти к основному содержимому

Использование навыков с dbt Wizard на dbt platform Бета-версия

Навыки — это многократно используемые инструкции, которые помогают dbt Wizard соблюдать принятые в вашей команде соглашения по SQL, правила именования, шаблоны моделирования и рабочие процессы без необходимости повторять их в каждом запросе.

dbt Wizard также включает встроенные навыки из dbt Agent skills, поддерживаемые dbt Labs. Они всегда доступны и не требуют настройки.

Общие сведения о контексте проекта (AGENTS.md, CLAUDE.md) см. в разделе Переход на dbt Wizard — dbt Wizard читает эти файлы инструкций без дополнительной настройки.

Как работают навыки​

В начале каждого сеанса dbt Wizard ищет навыки уровня репозитория в каталоге .agents/skills/ в корне вашего проекта dbt:

.agents/
  skills/
    your-skill-name/
      SKILL.md

Пользовательские навыки используют формат Agent Skills — тот же формат, который используется в dbt Agent Skills на GitHub. Файл навыка содержит блок метаданных YAML (name, description) и основную часть в формате Markdown с инструкциями.

Если пользовательский и встроенный навыки имеют одинаковое имя, приоритет имеет пользовательский навык.

Создание навыка​

В Studio IDE используйте проводник файлов, чтобы создать каталог и файл навыка:

  1. Создайте папку .agents/skills/SKILL_NAME/ в корне проекта.
  2. Добавьте в неё файл SKILL.md. Обычно SKILL.md включает:
    • Блок метаданных YAML как минимум с полями name и description.
    • Основную часть в формате Markdown с разделами об условиях применения навыка, этапах рабочего процесса и соглашениях.
    • Необязательные файлы в references/ с дополнительными сведениями, которые агент может загружать при необходимости.
  3. При необходимости добавьте вспомогательные файлы в .agents/skills/SKILL_NAME/references/ (например, references/naming-conventions.md), которые агент сможет читать, когда навык активен.
  4. Начните новый чат с dbt Wizard — навыки обнаруживаются в начале сеанса, поэтому изменения, внесённые во время сеанса, не будут учтены, пока вы не начнёте новый чат.

Формат файла навыка​

Файл навыка состоит из двух обязательных частей: блока метаданных YAML и основной части в формате Markdown.

  • Блок метаданных: содержит как минимум name и description. Поле description особенно важно: именно по нему dbt Wizard определяет, когда автоматически применять навык.
  • Основная часть: разделы Markdown, объясняющие, когда использовать навык, что он делает, а также какие соглашения или ограничения следует соблюдать.
  • Справочные материалы (необязательно): вспомогательные файлы .md в подпапке references/ со сведениями, которые сделали бы SKILL.md слишком длинным.

Пример файла навыка​

Если вы только начинаете работать с навыками, создайте небольшой SKILL.md, как в примере ниже, а затем постепенно дополняйте его:

---
name: my-team-style
description: Apply Santi Corp's modeling conventions when editing or creating dbt models. Use when the user asks for refactors, new models, or YAML in this project.
---

# My team style

## When to use

Use this skill whenever you are changing SQL or YAML under `models/` and the user did not override these rules.

## Conventions

- Staging models use prefix `stg_` and live in `models/staging/`.
- Facts and dimensions use `fct_` and `dim_` prefixes respectively.
- Document new columns in the same PR as the model change.

Полноценный пример для использования в реальном проекте см. в навыке adding-dbt-unit-test от dbt.

Использование навыка​

В панели чата dbt Wizard:

  1. Отправьте агенту запрос и укажите навык по имени — например: Use my-team-style to refactor this model and update related YAML.
  2. При необходимости используйте упоминания через @, чтобы напрямую указать файл навыка или вспомогательные файлы .md.
  3. Просмотрите и подтвердите предложенные изменения в панели dbt Wizard, как обычно.

Встроенные навыки dbt​

dbt Wizard поставляется с навыками из dbt Agent Skills, поддерживаемыми dbt Labs и сообществом. Они содержат знания по аналитической инженерии для типовых рабочих процессов и все входят в комплект dbt Wizard. Вам не нужно вызывать их напрямую: агент сам загружает навык, соответствующий вашему запросу.

Актуальный каталог см. в репозитории dbt Agent Skills.

Советы​

  • Ограничивайте область применения SKILL.md. Один навык должен решать одну задачу (руководство по стилю, соглашения по тестированию, процесс развёртывания). Небольшие навыки загружаются надёжнее, чем крупные монолитные.
  • Используйте description, чтобы управлять тем, когда dbt Wizard активирует навык. Точное описание («Используйте при создании или редактировании моделей в models/marts/») позволяет применять навык в подходящих случаях, а не при каждом запросе.
  • Начинайте новый сеанс после добавления или редактирования навыка. Навыки обнаруживаются в начале сеанса — изменения, внесённые во время сеанса, не учитываются, пока вы не начнёте новый чат.
  • Совместное использование навыков между проектами пока не поддерживается. Чтобы повторно использовать навык в другом репозитории, скопируйте файлы навыка вручную.

Связанная документация​

Нашли ошибку?

0
Loading