Agents Schema — плагин
Плагин подключает агента к хранилищу данных и находит в схеме AGENTS метаданные таблиц, моделей dbt и семантических объектов.
- 72 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Навык подключения настраивает доступ агента к хранилищу и выполняет SQL.
- Рабочие процессы записывают схему в хранилище с учетной записью из секрета GitHub.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/agents-schemaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Навык подключения настраивает доступ агента к хранилищу и выполняет SQL.
- Рабочие процессы записывают схему в хранилище с учетной записью из секрета GitHub.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agents Schema кладет контекст о данных прямо в хранилище: стандартная схема `AGENTS` хранит описания таблиц, владельцев, источники моделей dbt, представления LookML и Omni и семантические модели OSI. Рабочие процессы GitHub Actions из репозитория загружают эти метаданные в Snowflake, Databricks, BigQuery или ClickHouse. Плагин agents-schema для Claude Code и Codex ставит два независимых навыка. Навык `connect-warehouse` настраивает и проверяет доступ к хранилищу пробным запросом, не прося вставлять пароли и токены в чат. Навык `agents-schema-search` после подключения ищет метаданные через `AGENTS.ROOT`: какие таблицы есть, чем они описаны, свежи ли и кто за них отвечает.
Для кого. Аналитикам и инженерам данных, у которых агент пишет SQL к хранилищу и нуждается в контексте о таблицах.
Подходит, если
- Агент отвечает на вопрос по данным и должен найти, какие таблицы подходят.
- Нужно подключить Claude Code или Codex к Snowflake, BigQuery, Databricks или ClickHouse.
- Метаданные проекта dbt публикуют в хранилище автоматически после каждой сборки.
- Нужно понять, кто владеет набором данных и актуален ли источник.
Не подходит, если
- Агент правит исходники dbt и работает с файлами и артефактами проекта.
- Хранилище не входит в четверку Snowflake, BigQuery, Databricks и ClickHouse.
- Нужен жесткий детерминированный контракт для приложения: схема рассчитана на агента как читателя.
Пример запроса к агенту
Подключись к нашему Snowflake и найди в AGENTS.ROOT таблицы про выручку: кто владелец и когда обновлялись данные.Ограничения
Рабочие процессы пишут в хранилище с учетными данными из одного секрета GitHub Actions, `WAREHOUSE_CREDENTIALS`, поэтому у такой учетной записи должны быть минимальные права на запись схемы. Для ClickHouse есть отдельные заметки по настройке. Навыки плагина работают локально и ничего не публикуют. Строка `agents-schema-analyst` в `AGENTS.ROOT` остается поведением хранилища. Подключение к хранилищу требует собственного доступа к нему, а запросы расходуют его вычислительные ресурсы.
Как отключить. Выполните `claude plugin uninstall agents-schema@agents-schema` и при желании удалите маркетплейс. Схему `AGENTS` из хранилища и секрет в GitHub уберите отдельно.
Частые вопросы
Как поставить плагин в Codex?
Командами `codex plugin marketplace add dbt-labs/agents_schema` и `codex plugin add agents-schema@agents-schema`, затем начните новую задачу.
Какие навыки получает агент в Claude Code?
`/agents-schema:connect-warehouse` настраивает доступ, `/agents-schema:agents-schema-search` ищет метаданные. Claude может вызвать их и сам.
Откуда берутся метаданные?
Из dbt, Looker, Omni, OSI, Sigma и Markdown-навыков. Быстрее всего работает dbt: достаточно пути к проекту и `target/manifest.json`.
Какие хранилища поддерживаются?
Snowflake, Databricks, BigQuery и ClickHouse. Для каждого в руководствах есть пример учетных данных.
Заменяет ли схема MCP-сервер dbt?
Нет. Для правки dbt-проекта по-прежнему нужны его файлы и артефакты, а схема служит общей поверхностью запросов к метаданным.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Dex: агент изучает базу, строит модели dbt и семантический слой и следит за дрейфом схем с контролем затрат
Плагин hcls-agents от AWS дает Claude Code и Codex навыки по геномике, клиническим испытаниям и биомаркерам и MCP-серверы.
CLI для десятков баз данных с режимом для агентов: JSON на выходе, режим только для чтения, лимиты и брокер, скрывающий пароли
Скиллы для Neo4j: запросы Cypher, моделирование графов, драйверы, импорт, GraphRAG, GDS и создание экземпляров Aura
Каталог плагинов Google Cloud для баз и аналитики: AlloyDB, Spanner, Bigtable, Firestore, Cloud SQL и Looker.
Шаблон для аналитиков данных: AGENTS.md, CLAUDE.md и набор скиллов по Python, SQL, Polars и диагностике моделей.
Коротко о README
Репозиторий вместе с рабочими процессами содержит маркетплейс плагинов для Codex и Claude Code, спецификацию схемы `SPEC.md` и примеры. Идея в том, что читателем метаданных выступает агент, поэтому провайдеры могут хранить данные полуструктурированно и менять форму без согласования жесткого контракта.