Agami Connect

Introspekcja aktywnej bazy danych do walidowanego modelu semantycznego dla NL-to-SQL

Autor: AgamiAI · AgamiAI/agami-core

Działa po konfiguracji ★ 7.6/10

Agami Connect — Introspekcja aktywnej bazy danych do walidowanego modelu semantycznego dla NL-to-SQL

Co robi ten skill

Punkt wejścia do wtyczki agami: konfiguruje poświadczenia tylko do odczytu, a następnie deterministycznie introspektuje aktywną bazę danych (Postgres, MySQL, Snowflake, BigQuery i inne) w model semantyczny obszarów tematycznych, tabel, kolumn, kluczy i kardynalności połączeń, zanim nałoży wzbogacenie LLM i walidowane przez EXPLAIN przykłady NL-to-SQL. Uruchamia się przy pierwszej instalacji wtyczki lub na żądania takie jak 'connect to my database', 'introspect my schema', 'set up agami' lub 'try the sample data'. Jest to wtyczka Claude Code, a nie samodzielna umiejętność do kopiowania.

Raport z testu

To jest pełna wtyczka Claude Code (marketplace: AgamiAI/agami-core), a nie samodzielna umiejętność — jej 1009-liniowy SKILL.md stale wywołuje $AGAMI_PLUGIN_ROOT/scripts/sm, connect_resolve.py i ../../shared/*.md, z których wszystkie są nieobecne, jeśli skopiujesz tylko katalog umiejętności do ~/.claude/skills, więc żadna dosłowna komenda kopiowania nie działa. Wszystkie odwołane skrypty, udostępnione dokumenty i próbka SQLite zostały potwierdzone jako obecne w repozytorium. Wynik nie mógł być zmierzony w stosunku do wersji bazowej: introspekcja wymaga zainstalowanego pakietu agami-core plus sterownika DB i aktywnych poświadczeń tylko do odczytu (ścianka logowania), a nawet ścieżka próbki offline instaluje pakiet pipem najpierw. Warto zauważyć, że higiena poświadczeń jest twardą zasadą — hasła nigdy nie dotykają linii komend Bash, połączenia pochodzą tylko z pliku poświadczeń chmod-600.

Testowano: 2026-07-25 · Claude Code 2.x (agent harness)

Instalacja

/plugin marketplace add AgamiAI/agami-core then /plugin install agami-core@agami. Requires the agami-core Python package plus a DB driver and live read-only credentials; not installable as a single ~/.claude/skills copy.

Komendy i przykładowe prompty

  • /agami-connectIntrospekcja aktywnej bazy danych do walidowanego modelu semantycznego dla NL-to-SQL

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • Connect to my Postgres database and introspect the schema
  • Set up Agami and build a semantic model from my Snowflake data
  • Introspect my BigQuery schema so I can query it in plain English