Сервис ПланФакт
для финучета
с ИИ-агентами

Я — пользователь сервиса ПланФакт. В ПланФакте я веду финансово-управленческий учет своей компании. Ты находишься в рабочей папке проекта, где мы будем безопасно работать с API ПланФакта.
Твоя задача — подготовить эту папку к работе с API, проверить подключение и помочь мне увидеть первые полезные сценарии для моего бизнеса. Основные принципы работы сохрани в AGENTS.md в корне папки.
Важные правила безопасности:
1. Никогда не показывай API-ключ в чате, логах, командах, ошибках, файлах отчетов или примерах.
2. API-ключ нужно брать только из файла .env в текущей рабочей папке.
3. Если файла .env нет или в нем нет переменной PLANFACT_API_KEY, остановись и попроси меня создать файл .env со строкой:
PLANFACT_API_KEY=мой_ключ
4. Не проси меня прислать API-ключ в чат.
5. Если в папке есть или будет git-репозиторий, убедись, что .env добавлен в .gitignore. Если .gitignore нет — создай его и добавь туда .env.
6. До моего явного подтверждения не создавай, не изменяй и не удаляй данные в ПланФакте. Сначала показывай план изменений и список объектов, которых это коснется.
7. В этом первом запуске выполняй только безопасные действия: подготовка документации, проверка подключения, чтение доступных лимитов и анализ возможностей.
Что нужно сделать:
1. Подготовь документацию
- Скачай или обнови документацию для ИИ-агентов из публичного репозитория:
https://github.com/planfact/planfact-agent-kit
- Размести ее в папке docs внутри текущего проекта. Сделай это так, чтобы в будущем документацию можно было обновить без ручного копирования с нуля. Если выбираешь git clone, сохрани репозиторий внутри docs/planfact-agent-kit. Если выбираешь другой способ, кратко объясни, как потом обновлять документацию.
2. Проверь рабочую папку. Убедись, что в проекте есть:
- docs с документацией ПланФакта;
- файл .env с переменной PLANFACT_API_KEY;
- файл .gitignore, где указан .env;
Если чего-то не хватает, исправь то, что можно исправить без API-ключа. Если нужен мой ввод — задай только один конкретный вопрос.
3. Проверь API-ключ.
Используя документацию из docs, проверь, что API-ключ работает. В ответе сообщи только безопасную информацию:
- подключение работает или нет;
- к какому аккаунту или пользователю относится ключ, если API это безопасно возвращает;
- какие лимиты API доступны на текущем тарифе, если API это возвращает;
- сколько запросов осталось, если API это возвращает;
- какие модули или разделы API доступны, если это можно определить безопасным чтением.
Не показывай сам ключ и не выводи его часть.
Если проверка не удалась, объясни причину человеческим языком: не найден .env, неверный ключ, нет доступа к API, превышен лимит, ошибка сети, ошибка документации или другая причина.
4. Запроси описание бизнеса.
После успешной проверки подключения попроси меня описать бизнес. Спроси коротко и по делу. Попроси указать:
- чем занимается компания;
- основные источники выручки;
- кто пользуется управленческой отчетностью;
- какие финансовые вопросы сейчас самые важные;
- какие документы или таблицы часто приходится загружать вручную.
Когда я отвечу, сохрани описание в файл BUSINESS_CONTEXT.md.
Если файл BUSINESS_CONTEXT.md уже существует, не перезаписывай его молча. Сначала спроси: дополнить, обновить или оставить как есть.
5. Изучи возможности API с точки зрения бизнеса
Изучи базовый слой документации ПланФакта в docs не как программист, а как финансовый аналитик и операционный помощник собственника.
Определи, какие бизнес-сценарии можно делать через API с учетом доступных методов, ограничений тарифа и типичных задач управленческого учета.
Обращай внимание на сценарии, связанные с:
- операциями и платежами;
- статьями ДДС, ОПУ и баланса;
- контрагентами;
- проектами и направлениями;
- загрузкой документов и таблиц;
- сверкой данных;
- поиском ошибок и аномалий;
- подготовкой отчетов, таблиц, графиков и презентаций;
- регулярными проверками финансовой дисциплины.
6. Дай мне первый полезный результат
После изучения документации напиши краткий, но содержательный итог:
- Работает ли подключение к API.
- Какие лимиты и ограничения ты видишь.
- Какие разделы данных доступны для работы.
- Какие задачи лучше делать через API, а какие лучше не автоматизировать без участия человека.
- Список из 10 конкретных возможностей для моей компании.
Список возможностей должен быть не общим, а прикладным. Не пиши абстрактно “анализировать финансы”. Пиши конкретно, например:
- найти операции без статьи или проекта;
- собрать список платежей с подозрительно крупными суммами;
- сравнить план и факт по ключевым статьям;
- подготовить отчет для собственника за месяц;
- собрать дашборд по кассовым разрывам;
- проверить задвоенные операции.
7. Предложи первые впечатляющие сценарии
В конце предложи 2-3 первых сценария, которые стоит сделать сразу. Для каждого сценария укажи:
- какую бизнес-проблему он решает;
- какие данные понадобятся;
- что я получу на выходе;
- сколько примерно шагов потребуется;
- будет ли сценарий только читать данные или потребует изменений в ПланФакте.
Выбирай сценарии, которые дают быстрый и заметный эффект, но не требуют опасных изменений данных на первом запуске.
Стиль работы:
- Действуй последовательно.
- Сначала проверяй факты по документации, потом делай выводы.
- Не выдумывай возможности API, если они не подтверждены документацией.
- Если не уверен, так и пиши: “не нашел подтверждения в документации”.
- Не делай длинных технических отчетов без необходимости.
- Формулируй коротко и емко.
- Пиши на русском языке, ясно и по делу.
- Когда задача требует моего решения, останавливайся и задавай один конкретный вопрос.