Airbyte Agent SDK — плагин
Скиллы Airbyte ведут агента от выбора коннектора до готовых инструментов для Stripe, GitHub, Jira и других сторонних API.
- 136 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Коннекторы работают с вашими ключами к сторонним сервисам, права ключа определяют доступ агента.
- Действие `execute` может менять данные сервиса, если коннектор и ключ это допускают.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/airbyte-agent-sdkОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Коннекторы работают с вашими ключами к сторонним сервисам, права ключа определяют доступ агента.
- Действие `execute` может менять данные сервиса, если коннектор и ключ это допускают.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий содержит Python-пакет с типизированными коннекторами к сторонним API и набор скиллов, которые ведут агента через работу с ним. Скилл `discovering-connectors` показывает доступные коннекторы, их сущности и схемы. `bootstrapping-agent` настраивает авторизацию, инициализацию и готовые инструменты для PydanticAI или Claude SDK. `building-multi-connector-agent` собирает агента с несколькими коннекторами, а `airbyte-sdk-reference` дает справочник по API. Коннекторы запускаются локально с вашими учетными данными и обращаются к API сервиса напрямую. Функция `build_connector_tools` выдает три инструмента: `inspect_connector`, `read_skill_docs` и `execute`.
Для кого. Разработчикам агентов на PydanticAI или Claude SDK, которым нужны готовые типизированные инструменты для CRM, трекеров и платежных API.
Подходит, если
- Агенту надо читать сделки из HubSpot или Salesforce, а писать собственный клиент не хочется.
- Перед работой нужно выяснить, какие сущности и действия есть у коннектора Stripe.
- Агент использует Jira и GitHub одновременно, и имена инструментов не должны конфликтовать.
- Проекту на PydanticAI нужны инструменты с понятными ошибками и ограничением размера ответа.
Не подходит, если
- Нужен быстрый поиск по данным и запросы к контекстному слою: они есть только в Airbyte Cloud через Airbyte MCP.
- Ключи сервисов нельзя выдавать агенту ни в каком виде.
- Проект написан не на Python: SDK поставляется как Python-пакет.
Пример запроса к агенту
Подключи коннектор Stripe к агенту на PydanticAI, возьми ключ из переменной `STRIPE_API_KEY` и покажи, какие сущности и действия доступны.Ограничения
SDK ставится отдельно командой `uv pip install airbyte-agent-sdk`: скиллы только описывают работу с ним. Коннекторы используют ваши учетные данные и ходят в API сервисов напрямую, поэтому права ключа определяют, что сможет агент. Действия `context_store_search` и `context_store_sql_query` локально завершаются ошибкой `NotImplementedError`. Один набор из `build_connector_tools` обслуживает один коннектор, для нескольких нужен `agent_tool`. Метод `tool_utils` устарел. Лицензия в манифесте плагина указана Elastic-2.0.
Как отключить. Удалите плагин через `/plugin` в Claude Code. Скиллы, поставленные через `npx skills`, и ссылки Codex удалите вручную. Пакет `airbyte-agent-sdk` удаляется отдельно.
Частые вопросы
Как поставить скиллы в Claude Code?
Выполните `/plugin marketplace add airbytehq/airbyte-agent-sdk`, затем `/plugin install airbyte-agent-sdk@airbyte-agent-sdk`.
Как поставить скиллы в Codex?
Склонируйте репозиторий в `~/.codex/skills/airbyte-agent-sdk-src` и создайте ссылки на `connector-sdk/.claude/skills/*` в каталоге `~/.codex/skills/`.
Какие инструменты создает `build_connector_tools`?
Три: `inspect_connector`, `read_skill_docs` и `execute`. Имена фиксированы, поэтому набор подходит одному коннектору на агента.
Когда нужен `agent_tool`?
Для своих тел инструментов, фреймворков без встроенной поддержки и агентов с несколькими коннекторами. Поддерживаются PydanticAI, LangChain, OpenAI Agents и FastMCP.
Как скиллы получают данные сервисов?
Коннекторы запускаются у вас локально с вашими учетными данными и обращаются к API сервиса напрямую. Через Airbyte они не проходят.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныAI Agent Skills от sanjay3290
AI Agent Skills
Набор кроссплатформенных скиллов: запросы только на чтение к PostgreSQL, MySQL и MSSQL, Google Workspace, Jira, Telegram, озвучка и исследования
Официальный набор Pipefy для агентов: MCP-сервер, CLI и скиллы, которые работают с процессами Pipefy от лица вашей учетной записи.
Плагин со скиллом zapier-sdk: агент пишет код для более 9000 приложений Zapier, а ключи действий берет из живого каталога
CLI-диспетчер для агентов: задача идет в фоне, агент засыпает на вопросе и просыпается после вашего ответа из мессенджера.
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Скилл и движок на SQLite следят за тысячами источников по расписанию, находят изменения по хешу и ведут журнал записей.
Коротко о README
Документ охватывает более 50 коннекторов, выбор между `build_connector_tools`, `agent_tool` и устаревшим `tool_utils`, а также три способа поставить скиллы. Отдельный раздел объясняет, что поиск по данным остается в Airbyte Cloud.