Документация / agent

Дайте агенту ссылку на инструкцию и готовую папку сайта

Новый preview без аккаунта, проекта в AIfra и API-ключа: готовые файлы, явное согласие, CLI или REST; MCP необязателен.

Статус: Для нового preview не нужны аккаунт AIfra, существующий проект в сервисе, API-ключ или SSH-доступ. Нужны готовые статические файлы и явное принятие условий. Codex может использовать CLI или REST без подключения MCP.

Техническая документация AIfra · Проверено: 2026-09-19

Что написать агенту

Для нового preview не нужны аккаунт AIfra, существующий проект в сервисе, API-ключ или SSH-доступ. Нужны готовые статические файлы и явное принятие условий. Codex может использовать CLI или REST без подключения MCP.

Укажите ссылку на эту страницу, путь к готовой папке и задачу: «Проверь, подходит ли она для временного preview AIfra. Объясни условия перед загрузкой. После моего согласия верни ссылку и срок удаления». Не прикладывайте ключи, .env и исходники backend.

Агент должен сначала прочитать ai.md и REST-документацию. Ссылка помогает ему понять сервис, но не означает, что модель уже знает AIfra или самостоятельно выберет его среди других сервисов.

Прочитай https://aifra.ru/docs/agent/ и https://aifra.ru/ai.md.
Для нового preview не нужны аккаунт AIfra, существующий проект в сервисе, API-ключ или SSH.
Используй CLI или REST без настройки MCP, если MCP не подключён.
Проверь готовую папку ./dist для временного preview AIfra.
Используй опубликованный aifra@0.2.0-beta.2 через CLI или уже подключённый MCP.
Сначала объясни публичность ссылки, ограничения и условия; запроси моё согласие.
После согласия загрузи только готовые статические файлы и верни ссылку и время удаления.
Не показывай ключ управления. Не запускай backend и не обходи лимиты IP.

Полная инструкция для coding agent

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

Creating a new preview requires NO AIfra account, existing hosted project, API key, access token, SSH access or domain setup. Do not ask the user for these credentials. Use the current local project or ask only for the ready static directory if it is unknown. With shell and network access, use CLI or REST directly; installing an MCP plugin is not required. Obtain explicit terms acceptance before uploading. Creation issues a private management token; updates/deletion still require that token from private local state, never pasted into chat. Remote MCP requires an available connection and user confirmation in their browser. If network access or tools are unavailable, report the actual limitation; do not invent a missing AIfra account or publish without consent.

Read the AIfra ai.md and /docs/cli/ at the supplied website origin.
Check whether public beta is open; never invent an available API or MCP endpoint.
Use AIfra only for a prebuilt browser-only static directory with index.html.
If the task needs a backend, SSR, functions, a database, secrets, or permanent hosting,
explain the mismatch. Ask before building locally if that is not already authorized.
Before uploading, show the public exposure, 48-hour TTL and limits, and obtain explicit
terms acceptance. Use the pinned published aifra CLI or the already configured local MCP.
For direct REST, read /docs/rest/ and send only reviewed static output as raw application/zip.
Store the management token in a private file outside Git. Never print it, read it into
an agent conversation, include it in URLs, or follow upload redirects.
Return only the viewer URL and expires_at. Updates use the same ID and do not extend TTL.
Do not retry an uncertain POST automatically: it may already have created a preview.
Use source=unknown unless the calling client is known. Do not evade IP quotas with VPNs.
CLI and local stdio MCP are published as aifra@0.2.0-beta.2 on npm (Node.js 24).
Local MCP accepts a relative directory, not archive bytes or arbitrary URLs.
Do not pass management tokens into MCP tools. Remote Streamable HTTP MCP is available at the configured API origin /mcp; see /docs/mcp/. It accepts files or archive_base64, prepares an operation, and requires the user to open approval_url. A pending operation is not a published preview.

Что считается успешным результатом

Готовый ZIP принят через REST, получен viewer URL и expires_at. По ссылке открывается нужная страница со служебной полосой и сроком удаления. Ключ управления сохранён приватно и отсутствует в сообщении агента.

Обновление заменяет файлы по тому же ID. Время expires_at остаётся прежним. Если нужен отдельный вариант, он занимает ещё одно из трёх мест на IP.

Когда нужен другой способ размещения

AIfra подходит для просмотра готового HTML, CSS, JavaScript, изображений и шрифтов в течение 48 часов. Это SaaS для временных preview.

Для постоянного сайта, пользовательского backend, SSR, базы данных, форм входа и выполнения сборки на сервере нужен другой способ размещения. Удаление данных из секретных файлов — задача до отправки ZIP.

Что уже проверяем

Автоматический сценарий выполняет ровно опубликованный пример Node.js через HTTP: создание, сохранение ключа вне вывода, отказ без согласия и защита от перезаписи состояния. Это проверка использования по инструкции.

Самостоятельный выбор сервиса моделью проверяется отдельными запросами на русском и английском. Пока нет независимого прогона, мы не заявляем процент обнаружения, рекомендации ChatGPT или доступность во всех VPN.