Прямые ссылки (deep links)

Схема URL craftagents:// позволяет запускать AIKraft Agents напрямую из браузеров, скриптов, документации или других приложений.

Новый диалог

Создайте новую сессию диалога, при необходимости с предзаполненным вводом:

craftagents://action/new-chat
craftagents://action/new-chat?input=Hello%20world
craftagents://action/new-chat?input=Hello%20world&send=true
craftagents://action/new-chat?input=Hello%20world&name=My%20Chat

Параметры:

Направление на конкретное workspace

Укажите конкретное workspace, добавив идентификатор workspace в путь:

craftagents://workspace/{workspaceId}/action/new-chat
craftagents://workspace/{workspaceId}/action/new-chat?input=Hello&send=true
craftagents://workspace/{workspaceId}/allSessions

Без указания workspace глубокие ссылки используют окно, в данный момент находящееся в фокусе.

Маршруты просмотра

Переходите непосредственно к определённым представлениям:

Сессии:

craftagents://allSessions
craftagents://allSessions/session/{sessionId}
craftagents://flagged
craftagents://flagged/session/{sessionId}
craftagents://state/{statusId}
craftagents://state/{statusId}/session/{sessionId}

Источники:

craftagents://sources
craftagents://sources/source/{sourceSlug}

Скиллы:

craftagents://skills
craftagents://skills/skill/{skillSlug}

Настройки:

craftagents://settings
craftagents://settings/workspace
craftagents://settings/permissions
craftagents://settings/shortcuts
craftagents://settings/preferences

Действия с сессиями

Управляйте сессиями с помощью глубоких ссылок:

craftagents://action/flag-session/{sessionId}
craftagents://action/unflag-session/{sessionId}
craftagents://action/delete-session/{sessionId}
craftagents://action/rename-session/{sessionId}?name=New%20Name

Режимы окон

Открывайте ссылки в новом окне вместо текущего:

craftagents://action/new-chat?window=focused
craftagents://allSessions?window=full

Примеры использования

Закладки браузера

Создавайте закладки, которые запускают определённые рабочие процессы:

• Утренний обзор: craftagents://action/new-chat?input=Give%20me%20my%20morning%20briefing&send=true
• Проверка задач: craftagents://action/new-chat?input=What%20are%20my%20top%203%20priorities%3F&send=true

Ссылки в документации

Добавляйте ссылки в документацию команды, которые открывают диалоги с агентом:

[Ask the assistant](craftagents://action/new-chat?input=How%20does%20the%20auth%20system%20work%3F)

Алиасы в оболочке

Создавайте алиасы в оболочке для распространённых задач:

alias morning="open 'craftagents://action/new-chat?input=Morning%20briefing&send=true'"
alias standup="open 'craftagents://action/new-chat?input=Prepare%20my%20standup%20notes&send=true'"

Ярлыки Raycast / Alfred

Настраивайте приложения-запускачи для запуска рабочих процессов с помощью клавиатурных сокращений с использованием URL-адресов глубоких ссылок.

Ярлыки iOS

На iOS создавайте Ярлыки, которые открывают глубокие ссылки:

1. Создайте новый Ярлык
2. Добавьте действие «Открыть URL»
3. Введите вашу глубокую ссылку craftagents://
4. Запускайте из виджета Ярлыков или Siri

Советы

Кодирование URL-ввода

При создании глубоких ссылок с текстовым вводом кодируйте специальные символы:

• Пробел → %20
• Вопросительный знак → %3F
• Амперсанд → %26
• Новая строка → %0A

Тестирование глубоких ссылок в терминале

Тестируйте глубокие ссылки перед отправкой:

open "craftagents://action/new-chat?input=Hello%20world"

Автоматическая отправка для быстрых рабочих процессов

Добавьте &send=true, чтобы немедленно выполнить запрос без ручного подтверждения — идеально для автоматизированных рабочих процессов.