Перейти на сайт

🤖 Использование ИИ-агентов с API ПланФакта

Май 2026 | API, AI, ИИ-агент, интеграция

Мы открыли возможность для работы с популярными ИИ-агентами через API ПланФакта и создали специальную документацию, которую агенты хорошо понимают.

Эта документация исходит из того, что агент у вас уже установлен, вы имеете некоторый опыт работы с ним и активную подписку.

Важно: перед подключением AI-агента прочитайте раздел 
«Ответственность и безопасность» в конце статьи ↗ 

Что можно делать с помощью агента

  • работать с операциями и данными в них;
  • распознавать и загружать фото и PDF (чеки, накладные);
  • загружать в ПланФакт почти любые Excel-таблицы;
  • строить собственные дашборды с нужными графиками;
  • анализировать отчеты ДДС, ОПУ и Баланс и получать рекомендации;
  • создавать презентации и таблицы на основе данных;
  • искать отклонения и аномалии в ваших финансах;
  • проверять корректность учета;
  • получать ответы на управленческие вопросы;
  • создавать свои внешние инструменты и автоматизации.

Какими агентами можно пользоваться

Мы протестировали сценарии работы с Codex, Claude Code и OpenCode с Qwen. 

Для простых задач обычно достаточно современных легких coding/reasoning-моделей. Для загрузки документов, финансовой аналитики и больших объемов данных используйте старшие модели последних поколений.

На каких тарифах это доступно

Возможности API, а значит и агента, зависят от вашего тарифа ПланФакта и доступных модулей. С 21.05.2026 доступ к API по умолчанию включен в тарифы:

  • Основной
    До 20 запросов в минуту и до 2 500 в месяц на весь аккаунт.

  • Расширенный
    До 100 запросов в минуту и до 50 000 в месяц на весь аккаунт.

  • Полный
    До 200 запросов в минуту и до 200 000 в месяц на весь аккаунт.

Лимиты сбрасываются в 00:01 по московскому времени 1 числа каждого месяца.

Если вы приобретали или получали API в подарок как отдельный модуль до 21.05.2026, уточните ваши лимиты в чате службы поддержки ПланФакта.


⚠️ На тарифе Начальный доступ к API не предусмотрен.

Приобрести модуль API отдельно пока нельзя — это решается только переходом на соответствующий тариф.

Если вам нужны лимиты сверх указанных выше — пожалуйста, напишите в чат службы поддержки и мы рассмотрим ваш запрос индивидуально.

Как начать

Шаг 1. 
Создайте в ПланФакте нового пользователя и предоставьте ему доступ к API. Подробнее о добавлении пользователя и настройке прав доступа можно посмотреть в наших статьях. 

⚠️ Небезопасно предоставлять агенту API-ключ владельца аккаунта — такой ключ дает полный доступ к данным.

Создайте для агента нового пользователя с ролью "Гость":

  • Зайдите на страницу https://app.planfact.io/users
  • Нажмите "Добавить" -> "Нового пользователя"
  • Введите e-mail, на который придет приглашение (его может потребоваться создать отдельно).
  • В поле "ФИО" укажите "Агент", должность не указывайте.
  • Выберите роль "Гость" и при необходимости настройте ограничения, если это доступно на вашем тарифе.
  • Включите этому пользователю доступ к API
  • Нажмите кнопку "Добавить пользователя" внизу страницы, затем зайдите в указанный почтовый ящик и подтвердите вход, перейдя по ссылке.


Шаг 2. 
Подготовьте рабочую папку и получите ключ API

  • Создайте на компьютере папку, в которой будете работать с агентом
  • Получите ключ API
    • Если вы зашли в ПланФакт как владелец аккаунта, откройте страницу управления пользователями https://app.planfact.io/users, найдите пользователя-агента и скопируйте его API-ключ через пункт меню с тремя точками справа.
    • Если вы вошли как пользователь-агент, которого создали выше — откройте страницу https://app.planfact.io/manage/security-settings и скопируйте ключ этого пользователя.
  • В рабочей папке создайте файл .env (именно так, начиная с точки) и внесите в него всего одну строчку, заменив "ВАШ_КЛЮЧ" на значение, которое вы скопировали выше
    PLANFACT_API_KEY=ВАШ_КЛЮЧ
  • Сохраните файл, затем откройте агент и создайте новый проект, выбрав эту рабочую папку


Шаг 3. 
Скопируйте готовый промт и отправьте его агенту целиком

Я — пользователь сервиса ПланФакт. В ПланФакте я веду финансово-управленческий учет своей компании. Ты находишься в рабочей папке проекта, где мы будем безопасно работать с API ПланФакта.

Твоя задача — подготовить эту папку к работе с API, проверить подключение и помочь мне увидеть первые полезные сценарии для моего бизнеса.

Важные правила безопасности:
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, если они не подтверждены документацией.
- Если не уверен, так и пиши: “не нашел подтверждения в документации”.
- Не делай длинных технических отчетов без необходимости.
- Формулируй коротко и емко.
- Пиши на русском языке, ясно и по делу.
- Когда задача требует моего решения, останавливайся и задавай один конкретный вопрос.


Все готово!

Если что-то пошло не так — напишите в наш чат поддержки на сайте ПланФакта. 

К сожалению, мы не сможем помочь вам с установкой и настройкой самого агента, но проконсультируем по шагам подключения агента к ПланФакту и безопасному получению API-ключа.

Важная информация об ответственности и безопасности 💡

AI-агент — это внешний инструмент, который вы выбираете, настраиваете и используете самостоятельно. ПланФакт предоставляет доступ к данным через API и документацию для работы с API, но не управляет работой AI-агента и не контролирует его действия, выводы, настройки, качество ответов или безопасность внешнего сервиса.

Используя AI-агента с API ПланФакта, вы самостоятельно отвечаете за:

  • выбор AI-инструмента и модели;
  • настройку агента и рабочей среды;
  • передачу API-ключа и его безопасное хранение;
  • действия, которые агент выполняет через API;
  • проверку выводов, отчетов, расчетов и рекомендаций агента;
  • соблюдение требований законодательства РФ, пользовательского соглашения ПланФакта и правил используемого AI-сервиса;
  • возможные последствия использования AI-агента, включая изменение, удаление, раскрытие, копирование или экспорт данных.

ПланФакт не несет ответственности за работу внешних AI-сервисов, программ, скриптов, интеграций, отчетов, дашбордов и других решений, которые клиент или его пользователи создают либо используют с применением API-ключа.

Чтобы снизить риски:

  • создавайте для AI-агента отдельного пользователя в ПланФакте;
  • не используйте API-ключ владельца аккаунта для работы агента;
  • храните API-ключ только в защищенном месте — в файле .env в рабочей папке проекта и не передавайте его в GitHub, облачные диски, чат агента, в публичные чаты, документы, скриншоты или открытые репозитории;
  • перед любыми изменениями данных просите агента показать план действий и дождаться вашего подтверждения;
  • проверяйте результаты анализа, расчеты, рекомендации и подготовленные агентом документы перед использованием;
  • если API-ключ был раскрыт или есть подозрение на компрометацию, незамедлительно перевыпустите его;
  • если вы владелец аккаунта и вам нужно перевыпустить свой ключ — обратитесь в службу поддержки ПланФакта. 

Использование AI-агента не заменяет самостоятельную проверку данных и управленческих решений. Финальные выводы, действия в аккаунте и решения на основе результатов работы AI-агента остаются зоной ответственности клиента.

Если нужна помощь❓ 

Мы всегда на связи:

  • чат в правом нижнем углу — самый быстрый способ
  • e-mail: support@planfact.io
  • телефон: 8 (800) 777-54-23
👆 На этом пока всё