Загрузчики документов
Figma Document Loader
Загружает данные из файла Figma для дальнейшей обработки.
Figma — это совместное веб-приложение для дизайн-интерфейсов. Этот модуль обеспечивает возможность загружать и обрабатывать содержимое из файлов Figma, включая текст, компоненты и метаданные.
Этот модуль предоставляет продвинутый загрузчик документов Figma, который может:
- Загружать содержимое из конкретных файлов Figma
- Извлекать текст из выбранных узлов
- Обрабатывать содержимое рекурсивно
- Обеспечивать аутентификацию с API Figma
- Обрабатывать содержимое с помощью разделителей текста
- Настраивать извлечение метаданных
Входные параметры
Обязательные параметры:
- File Key: уникальный идентификатор файла Figma (из URL файла)
- Node IDs: список идентификаторов узлов для извлечения, разделённых запятыми
- Connect Credential: учётные данные API Figma (токен доступа)
Опциональные параметры:
- Recursive: нужно ли обрабатывать узлы рекурсивно
- Text Splitter: разделитель текста для обработки извлечённого содержимого
- Additional Metadata: JSON-объект с дополнительными метаданными
- Omit Metadata Keys: список ключей метаданных, которые нужно исключить, разделённый запятыми
Выходные данные
- Document: массив объектов документов с метаданными и содержимым страницы (pageContent)
- Text: объединённая строка из pageContent документов
Функции
- Извлечение содержимого через API
- Выбор содержимого на уровне узлов
- Рекурсная обработка
- Поддержка разделителей текста
- Настройка метаданных
- Обработка ошибок
- Управление аутентификацией
Формат файла
Ключ файла можно найти в URL файла Figma:
https://www.figma.com/file/:key/:title
Пример: в URL https://www.figma.com/file/12345/Website, ключ файла — 12345
Идентификаторы узлов (Node IDs)
Чтобы получить Node IDs:
- Установите плагин Node Inspector в Figma
- Выберите нужные элементы
- Скопируйте Node IDs из инспектора
- Используйте формат с запятыми: "0,1,2"
Примечания
- Требуется действительный токен доступа к Figma
- Node IDs должны быть действительными для файла
- Поддерживается рекурсивная обработка содержимого
- Может обрабатывать сразу несколько узлов
- Обрабатывает ограничения API и ошибки
- Сохраняет структуру узлов в метаданных
- Поддерживает добавление пользовательских метаданных