Agentled/mcp-server

Активирует агента, переводя его статус из «черновик» или «приостановлен» в «активный». Активные агенты отвечают на сообщения в чате; активные агенты с расписанием запускают свои сценарии по расписанию. Требует доступа на запись при подключении через OAuth.

Добавляет новый шаг в рабочий процесс. Это рекомендуемый путь для рабочих процессов, созданных агентом — сначала вызовите create_workflow({ name, goal }), затем add_step по одному шагу, затем validate_workflow + publish_workflow. Каждый вызов немедленно возвращает ошибки валидации для каждого шага, так что неправильный тип шага, шаблон промпта или отсутствие обязательного поля обнаруживается до того, как поверх него будет построен следующий шаг. ## KG-First — прежде чем записывать содержимое промпта в шаг Прежде чем писать промпт для AI-шага, содержащий специфичный для рабочего пространства контент (тезис, критерии ICP, оценочную рубрику, список секторов, географический фокус, голос бренда, списки сидов), проверьте, существует ли этот контент уже в workspace KG: вызовите list_memories / list_knowledge_lists / get_knowledge_text. Если его ещё нет, сначала добавьте его (store_memory / upsert_knowledge_text) перед добавлением этого шага. Затем ссылайтесь на него во время выполнения в шаблоне промпта через {{steps.read-kg.content}}, а не вставляйте текст напрямую. Граница: стратегия → KG; связывание выполнения → контекст рабочего процесса; структура рабочего процесса → рабочий процесс. ## Обязательные поля step (все типы) - id: стабильная строка, уникальная в пределах рабочего процесса. - type: одно из значений закрытого списка — trigger, appAction, aiAction, aiActionWithTools, toolAction, code, knowledgeSync, return, milestone, share, wait, branch, parallel, loop, end_if, agentOrchestrator. Любая другая строка молча удаляется средой выполнения. - name: читаемое человеком название. Нетерминальные шаги также требуют next: { stepId }, указывающего на следующий шаг. Терминальные шаги (milestone, return) опускают next. ## Минимальная форма по типу json // trigger (ручной) { "id": "start", "type": "trigger", "name": "Manual Start", "pipelineStepStartConditions": { "trigger": { "type": "manual" } }, "next": { "stepId": "next-step" } } // aiAction — LLM промпт → структурированный JSON { "id": "analyze", "type": "aiAction", "name": "Analyze", "pipelineStepPrompt": { "template": "Analyze…" }

Добавление активности только для сборщика. Используйте это, когда аутентифицированный внешний сборщик сообщает о ходе выполнения, ссылках, заметках к тестам или вопросах; сервер записывает идентификатор зарегистрированного сборщика. Требует права на запись при подключении через OAuth.

Добавление активности, доступное только бизнес-агенту. Используйте это для последующих действий, проверки или заметок о маршрутизации исходного агента; разработчикам следует использовать append_builder_work_activity вместо этого. Требует права на запись при подключении через OAuth.

Добавляет один элемент в путь массива шагов, не заменяя случайно весь массив одноэлементным списком. Рекомендуется для массивов tools, integrations и подобных. Внутренне: get_step → добавление → безопасная замена через update_step. Возвращает ту же структуру, что и update_step. Требует права на запись при подключении через OAuth.

Применяет одну точную просмотренную предварительную версию пакета рабочего пространства. Требует workspace:packages:apply и права владельца рабочего пространства или ADMIN. Установка создаёт только приостановленные/черновики активы рабочего пространства. Она никогда не запускает рабочие процессы, не активирует процедуры или SignalKit, не вызывает поставщиков, не тратит кредиты, не отправляет, не записывает CRM/календарь/интеграции и не импортирует данные клиентов. Требует права на запись при подключении через OAuth.

Архивирует запись продукта WorkspaceUseCase без удаления связанных рабочих процессов, агентов, рутины, AgentFiles или знаний. Требует права на запись при подключении через OAuth.

Архивирует навык, созданный в рабочем пространстве, без удаления содержимого его базового AgentFile. Требует права на запись при подключении через OAuth.

Архивирует манифест WorkspaceView без удаления связанных строк KG, рабочих процессов, исполнений, утверждений, агентов, процедур или внешних данных. Требует права на запись при подключении через OAuth.

Добавляет один типизированный указатель live-контроля к требованию утверждения цели онбординга. Это обновляет только привязку требования. Оно не меняет связанные workflow, агента, канал или процедуру; не запускает провайдеров; не тратит кредиты; не принимает решения об утверждении; не выполняет внешние записи. Удаление пути из защиты отправки, записи или удаления требует confirm=true. Сервер переиспользует UI-валидатор и пишет строку аудита с указанием субъекта. Требует права на запись при подключении через OAuth.

Привязывает одну ссылку на навык к связанному агенту сценария использования и бизнес-роли. Это изменяет только конфигурацию целей. Не назначает навык агенту, не предоставляет разрешения на инструменты или приложения, не запускает провайдеров, не расходует кредиты и не выполняет внешних записей. Сервер повторно использует UI-валидатор и записывает строку аудита с указанием актора. Требует права на запись при подключении через OAuth.

Отправляет сообщение агенту AgentLed и получает ответ. Агент рассуждает, планирует и строит рабочие процессы через диалог на естественном языке — не нужно вручную собирать JSON-пайплайн. Используйте этот инструмент, когда хотите: - Создать рабочий процесс по описанию высокого уровня («Создай воркфлоу для обогащения лидов в SaaS-компаниях») - Получить рекомендации по структуре рабочего процесса - Задать вопросы о доступных интеграциях или возможностях - Дорабатывать дизайн рабочего процесса через диалог Агент использует те же инструменты планирования, конструктор рабочих процессов и контекст рабочего пространства, что и встроенный чат. Для многошаговых диалогов передавайте session_id из первого сообщения, чтобы сохранить контекст между сообщениями. Пример: chat("Build me a workflow that takes a LinkedIn company URL, enriches the data, and scores it by ICP fit") Требует права на запись при подключении через OAuth.

Отправляет сообщение агенту. По умолчанию использует активного рабочего ассистента (assistant@...), если не указаны id или agent_slug. Сначала вызовите list_agents, если хотите выбрать другого агента. Инструкции агента используются в качестве системного промпта. Поддерживает многошаговые беседы через session_id. Требует права на запись при подключении через OAuth.

Забирает поставленное в очередь или требующее изменений задание сборки для этого аутентифицированного сборщика и добавляет активность.Требует доступа на запись при подключении через OAuth.

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

Обновляет конфигурацию несекретных каналов — включает/отключает, назначает агента по умолчанию, управляет отправителями, политикой исходящих сообщений и т.д. Допустимые поля для каждого канала: - email: enabled, allowedSenders (string[]), inboundAddress, allowOutboundEmail, allowedOutboundRecipients, requireOutboundApproval. Поле defaultAgentId считается устаревшим и игнорируется при маршрутизации email. - slack: enabled, defaultAgentId, defaultChannelId (ID Slack-канала, используемый для маршрутизации входящих упоминаний, если одна Slack-команда используется совместно) - whatsapp: enabled, defaultAgentId - signal: enabled, defaultAgentId - telegram: enabled, defaultAgentId, botUsername, allowedChatIds Секретные поля (botToken, signingSecret, accessToken, webhookSecret) ОТВЕРГАЮТСЯ внешним API — подключайте их через интерфейс Settings → Channels (потоки OAuth шифруют данные в покое). Требует права на запись при подключении через OAuth.

Настраивает только отображаемую вкладку Recent внутри существующей области вкладки/таблицы Home и выбирает, какая вкладка Home открывается по умолчанию.Установите config.defaultTabId в "recent" или в идентификатор вкладки для конкретного сценария использования, указанный в inspect_home_recent_tab, чтобы изменить вкладку по умолчанию; опустите этот параметр, чтобы сохранить прежнее поведение defaultSelected.Требует точную ревизию рабочей области, возвращённую inspect_home_recent_tab, и полный объект config, или null для сброса настроек по умолчанию. Это изменяет только навигацию и представление Home: не запускает рабочие процессы, не вызывает провайдеров, не тратит кредиты, не меняет утверждения и не изменяет записи рабочих процессов/клиентов. Требует права на запись при подключении через OAuth.

Создаёт нового агента с именем, инструкциями, инструментами, рабочими процессами и опциональными конфигурационными файлами. Ответ содержит каналы для достижимых входящих каналов. Email назначается автоматически каждому агенту, если включён канал email рабочего пространства. Используйте возвращённый адрес email-канала, а не назначайте defaultAgentId для email. Агенты всегда работают в режиме «только чат» (разговорном). Для запланированной или автономной работы сначала создайте агента, затем прикрепите к нему процедуры через create_routine (например, ежедневный поиск сделок, еженедельный дайджест). Ключевые поля: - name: Отображаемое имя агента. - agentType: Шаблон-заготовка — 'personal-assistant', 'competitive-researcher', 'social-media-marketer', 'customer-support', 'content-marketer', 'lead-qualifier', 'deal-sourcer', 'custom' (по умолчанию). - instructions: Системный промпт / основное содержимое AGENTS.md. - enabledApps: Идентификаторы приложений, которые может использовать этот агент. Получите ID из list_apps (например, ['web-scraping', 'kg', 'gmail']). - appPermissions: Опциональные права доступа к приложениям, сгруппированные по ID приложения. Используйте { access: 'read' } для чтения или { access: 'write', writeApprovalRequired: true } для мутирующего доступа с подтверждением. Для переопределений по действиям добавьте actionApprovals с каноническими ключами действий, например { linkedin: { access: 'write', writeApprovalRequired: true, actionApprovals: { 'linkedin.create-comment': false } } }. Доступ на чтение подразумевается и никогда не требует подтверждения. Внутреннее приложение 'agentled' здесь не настраивается. - skillIds: Идентификаторы навыков из list_agent_skills. Внутренне хранятся как enabledSkills; для пользователя отображаются как Навыки. Используйте list_agent_skills({ includeRuntime: true }) только при настройке продвинутых runtime-наборов вроде workflow-operator, template-runner или inline-execution. - assignedWorkflowIds: Идентификаторы рабочих процессов, которые может запускать этот агент. Получите ID из list_workflows. - goals: Описание на естественном языке того, чего должен достичь агент. - configFiles: Переопределяет сгенерированные конфигурационные файлы — ключи: 'SOUL.md' (персона) и 'TOOLS.md' (маршрутизация инструментов). Если опущены, файлы генерируются автоматически из…

Создает устойчивую передачу работы от бизнес-агента внешнему AI-строителю. Использует sourceAgentEntityId для сохранения владельца бизнес-агента для проверки/email/UI. Требует доступ на запись при подключении через OAuth.

Создаёт новый список знаний с типизированной схемой. Идемпотентен при коллизии ключа — возвращает существующий список с предупреждением вместо ошибки, чтобы ИИ-агенты могли безопасно повторять шаги настройки. Используйте перед добавлением строк, чтобы убедиться, что схема списка существует. Возвращает: { listKey, fieldCount, kgSyncEnabled, alreadyExisted? }. При подключении через OAuth требует доступ на запись.

Создаёт и включает публичную ссылку на форму для рабочего процесса, чтобы любой мог отправить форму ввода рабочего процесса без учётной записи. Требует доступ на запись при подключении через OAuth.

Создаёт новую рутину для агента. Рутины - это платные автономные функции; рабочие пространства бесплатного тарифа не могут создавать или возобновлять их. Значения интервала: По расписанию: weekday-morning (Пн–Пт 08:00 UTC), weekday-evening (Пн–Пт 18:00 UTC), weekly-monday (Пн 08:00 UTC), weekly-tuesday-evening (Вт 18:00 UTC), weekly-friday-evening (Пт 18:00 UTC), daily (каждый день 08:00 UTC), monthly (1-е число месяца 08:00 UTC) По интервалу: 6 часов, 48 часов Формат модели: "provider:modelId", например "openai:gpt-5.4-mini" (по умолчанию). Используйте идентификаторы навыков из list_agent_skills для переопределения навыков на уровне рутины. Используйте list_agent_skills({ includeRuntime: true }) для продвинутых пакетов среды выполнения рутины, таких как routine-core. Требует права на запись при подключении через OAuth.

Создаёт ручной конфигурационный снимок текущего состояния рабочего процесса. Используйте это для сохранения контрольной точки перед внесением изменений, чтобы потом при необходимости можно было восстановить состояние.Применяет ограничения по тарифному плану (Pro=2, Teams=10, Custom=50). Возвращает ошибку с информацией о лимите, если достигнут лимит снимков — сначала удалите старые снимки, чтобы освободить место. Требует права на запись при подключении через OAuth.

Создаёт запись продукта WorkspaceUseCase для бизнес-цели с несколькими рабочими процессами. Используется перед созданием или присоединением рабочих процессов для таких вариантов использования, как поиск поставщиков, приём, ресепшн или бизнес-интро. Для config.useCasePage.body.columns произвольные бейджи могут использовать регистронезависимые valueRoles, а числовые оценки — упорядоченные минимальные пороги. Разрешённые семантические роли: neutral, accent, warning, success и danger; никогда не храните CSS-классы в config. Это создаёт только объект уровня продукта и связанные ссылки; не создаёт рабочие процессы, не записывает строки KG, не запускает провайдеров, не расходует кредиты, не запускает процедуры и не отправляет сообщения. После создания создайте или обновите рабочие процессы с полученным workflowGraphId и поддерживайте связанные ссылки на вариант использования актуальными. Требует права на запись при подключении через OAuth.

Создайте новый рабочий процесс. ## KG-First — перед тем как писать содержимое промптов Если создаваемый workflow содержит специфичный для рабочего пространства контент (инвестиционный тезис, критерии ICP, оценочные рубрики, целевые сектора, голос бренда, географический фокус, посевные списки), выполните эту предварительную проверку перед генерацией строк промптов для AI-шагов: 1. Проверка — вызовите list_memories, list_knowledge_lists, get_knowledge_text, чтобы увидеть, что уже есть в KG рабочего пространства. 2. Заполнение — если контента ещё нет в KG, сначала запишите его туда (store_memory, upsert_knowledge_text, upsert_knowledge_rows). Подтвердите с пользователем перед добавлением нового контента. 3. Ссылка — получайте содержимое KG во время выполнения шага (kg.read-text, kg.read-list, recall_memory). Никогда не вставляйте абзацы, специфичные для рабочего пространства, в строки шаблонов промптов. Граница: стратегия → KG; соединения выполнения → контекст workflow; структура workflow → workflow. ## Рекомендуемая последовательность для workflow, создаваемых агентом create_workflow({ name, goal }) → add_step на каждый шаг → validate_workflow → publish_workflow. Вызывайте этот инструмент только с name + goal — оставьте steps пустыми. Затем добавляйте add_step по одному шагу за раз. Пошаговый подход сразу ловит ошибки и показывает привязки {{input.X}} / {{steps.Y.Z}} для каждого шага. Внутреннее тестирование: 0 ошибок при пошаговом подходе против 13 при массовом. pipeline.steps поддерживается только для импортов/шаблонов/циклов. Агентам, создающим с нуля, не следует его использовать. ## Поля объекта Pipeline - name (обязательно), goal, description, context, metadata, style - steps: закрытые значения type (остальные игнорируются): trigger, appAction, aiAction, aiActionWithTools, toolAction, code, knowledgeSync, return, milestone, share, wait, branch, parallel, loop, end_if, agentOrchestrator. Отдавайте предпочтение триггерам schedule для приёма email и не-real-time использования — идемпотентно, без вебхук-инфраструктуры. Используйте app_event/webhook только для требований «как можно скорее» / «в реальном времени». Для дочерних /…

Создаёт рабочее пространство только при наличии у вызывающей стороны разрешения operator workspace-create; в противном случае запрос отклоняется без изменений. Сначала вызывает resolve_workspace. Этот примитив настройки не подготавливает наборы сценариев использования, не запускает рабочие процессы, не вставляет строки кандидатов, не отправляет сообщения клиентам, не записывает данные в CRM/календарь, не вызывает SignalKit receive, не запускает процедуры и не расходует кредиты провайдера. Требует доступ на запись при подключении через OAuth.

Создаёт черновик навыка рабочего пространства на основе существующего AgentFile. Содержимое AgentFile должно содержать инструкции/тело навыка. Запись WorkspaceSkill хранит метаданные жизненного цикла, риска, релевантности, рекомендуемых приложений/действий и утверждения. Поля allowedApps/allowedActions — это рекомендации для исполнения; фактическая доступность по-прежнему определяется назначенной областью приложения/действия агента, пакетами времени выполнения, подключениями рабочего пространства и шлюзами утверждения. Отдавайте предпочтение import_workspace_skill для импорта Markdown/SKILL.md/JSON; используйте этот низкоуровневый инструмент, когда у вас уже есть проверенный идентификатор AgentFile. Требует права на запись при подключении через OAuth.

Создаёт сохранённый манифест WorkspaceView на основе данных активного рабочего пространства. Workspace Views — это общие рабочие поверхности, а не отчёты, ограниченные KG. Источниками данных могут быть списки/текст KG, выполнения рабочих процессов/страницы результатов/временные шкалы, ожидающие утверждения, утверждения агентов, очереди действий, запуски рутин, внешние API и пользовательские источники. Создание представления записывает только манифест; оно не читает источники, не запускает рабочие процессы, не вставляет строки KG, не отправляет сообщения, не вызывает провайдеров, не принимает решения об утверждении и не расходует кредиты. Требует доступ на запись при подключении через OAuth.

Навсегда удаляет агента и все его файлы. Прикреплённые процедуры также удаляются API. Требует права на запись при подключении через OAuth.

Окончательно удаляет файл, прикрепленный к агенту. Требует права на запись при подключении через OAuth.

Удаляет остановленное выполнение workflow и связанные с ним записи timeline/chat. ТОЛЬКО ДЛЯ ИСКЛЮЧИТЕЛЬНЫХ СЛУЧАЕВ инструмент обслуживания администратора. Требует API-ключ с областью admin:patch. Необходимый порядок действий оператора: 1. Вызовите stop_execution с понятным человеку описанием причины. 2. Дождитесь, пока get_execution покажет статус "stopped". 3. Вызовите delete_execution с указанием причины и confirmExecutionId, точно совпадающим с executionId. API отклоняет выполнения, которые не остановлены, и несовпадающие подтверждения. Это деструктивная операция, и её следует использовать только для остановленных тестовых запусков или очистки после инцидентов. Требует права на запись при подключении через OAuth.

Навсегда удаляет список знаний и ВСЕ его строки. Это действие необратимо. Передаёт listKey удаляемого списка. API требует confirm: true — этот инструмент отправляет его автоматически. Возвращает: { success, listKey }. Требует права на запись при подключении через OAuth.

Удаляет конкретные строки из списка знаний по их ID. Это действие необратимо. Для более чем 10 строк API требует confirm: true — этот инструмент отправляет его автоматически. Возвращает: { deleted, errors[] }, где каждая ошибка содержит структурированное поле code: - foreign_key_constraint: строка используется в рёбрах графа знаний (прогнозы оценок, результаты, связи) и не может быть жёстко удалена - not_found: ID строки не существует - permission_denied: недостаточно прав в рабочем пространстве - delete_failed: неклассифицированная ошибка ВАЖНО: Строки, используемые в рёбрах графа знаний, нельзя жёстко удалить. Если вы получили ошибки foreign_key_constraint, используйте мягкое удаление: вызовите upsert_knowledge_rows с mergeStrategy "merge" и rowData { _dropped: true, _dropReason: "..." }. Обработчики потоков обычно фильтруют по _dropped или status != "noise", поэтому мягко удалённые строки исключаются из последующих чтений. Требует права на запись при подключении через OAuth.

Удаляет текстовую запись базы знаний по ключу. Это действие необратимо. Возвращает: { success, key }. Требует права на запись при подключении через OAuth.

Удаляет конкретную память по ключу. Требуется доступ на запись при подключении через OAuth.

Удаляет публичную ссылку на форму по токену/идентификатору. Сейчас не поддерживается внешним API (возвращает 501). Требует права на запись при подключении через OAuth.

Окончательно удаляет процедуру. Это действие нельзя отменить. Требует права на запись при подключении через OAuth.

Удаляет конкретный снимок конфигурации. Используйте list_snapshots для поиска ID снимков. Полезно для освобождения места при достижении лимита снимков. Требует доступ на запись при подключении через OAuth.

Навсегда удаляет workflow по ID. Это действие необратимо. Двухфазный процесс (обязательно): 1. Вызовите с одним workflowId, чтобы получить предварительный просмотр удаления. Ответ: { pendingDelete: true, id, name, status, relatedEntities: { executions, leads, timelines }, relatedEntitiesTruncated, confirmToken, expiresIn: 300, expiresAt, message } На фазе 1 ничего не удаляется. Токен действителен 5 минут. 2. Вызовите снова, указав и workflowId, и confirmToken, чтобы выполнить каскадное удаление. Ответ: { deleted: true, id }. Ответы об ошибках сервера (всегда структурированный JSON): - 404 { error: "Workflow not found" } - неправильный ID или неверное рабочее пространство. - 403 { error: "Invalid or expired confirmation token. Request a new deletion preview first." } - опечатка в токене, истек срок действия или несоответствие workspace/workflow. - 500 { error: "Failed to delete workflow" } - ошибка каскадного удаления (редко; можно безопасно повторить фазу 2 с новым токеном). Если вы видите просто "Denied." без подробностей, это ваш MCP-хост (Claude Desktop, Cursor и т.д.) блокирует деструктивный вызов на уровне политики одобрения, а не этот сервер. Agentled никогда не возвращает "Denied." - каждая ошибка от этого инструмента содержит JSON-тело. Проверьте настройки разрешений инструментов хоста и повторно одобрите, затем повторите попытку. Требует права на запись при подключении через OAuth.

Отменяет черновой снимок для рабочего процесса в реальном времени. Конфигурация пайплайна в реальном времени остаётся без изменений. Отменяет черновые изменения и возвращает к текущей версии в реальном времени. Требует права на запись при подключении через OAuth.

Semantic intent router — описывает, что вы хотите сделать, простым английским языком, и Agentled находит наиболее подходящий активный рабочий процесс в вашем рабочем пространстве. Опционально автоматически выполняет найденный рабочий процесс. Примеры: - "найти email CEO для stripe.com" - "исследовать acme corp и оценить их по нашему ICP" - "спарсить https://example.com и составить краткое изложение" Возвращает наилучшее совпадение с оценкой уверенности, извлеченные входные данные и альтернативы. Установите execute=true, чтобы также немедленно запустить найденный рабочий процесс. Требует права на запись при подключении через OAuth.

Экспортирует рабочий процесс в портативный JSON для переноса между средами. Возвращает самодостаточный объект WorkflowExport со всеми шагами, контекстом, метаданными и страницами. Идентификаторы, привязанные к рабочему пространству (workspaceId, agentIds), удаляются, поэтому экспорт можно импортировать в любое рабочее пространство. Используйте вместе с import_workflow для перемещения рабочих процессов между средами (например, sandbox → prod).

Получает полные сведения об агенте, включая его конфигурацию, файлы, прикреплённые процедуры и назначенные входящие каналы.

Получает содержимое конкретного файла, прикреплённого к агенту.

Получает подробные схемы действий для конкретного приложения. Возвращает входные параметры, выходные поля и стоимость в кредитах. Используйте это, чтобы точно понять, какие входные данные требуются действию при создании шагов рабочего процесса.

Получает конфигурацию брендинга whitelabel рабочего пространства. Возвращает текущие настройки брендинга: displayName, logoUrl, tagline, primaryColor, primaryColorDark, faviconUrl и hideBadge. Используйте это, чтобы проверить текущий брендинг клиентского портала перед внесением изменений.

Получает полный контекст элемента работы сборщика, результаты, активность, метаданные и состояние проверки.

Получает статус или конечный результат для устойчивого внешнего оборота чата, возвращённого chat или chat_with_agent. Используйте этот инструмент после того, как ответ инструмента чата возвращает статус "running" и turn_id. Проверка этого инструмента идемпотентна и не запускает заново исходный промпт, вызов модели, действия приложения, утверждения, кредиты или внешние отправки.

Получает снимок черновика для активного рабочего процесса. Когда вы обновляете активный рабочий процесс, изменения сохраняются в черновик, а не меняют сам активный пайплайн. Используйте этот инструмент, чтобы просмотреть текущее состояние черновика. Возвращает hasDraft: true/false и конфигурацию черновика, если она существует.

Получает полные детали выполнения, включая результаты каждого завершённого шага. Поле executionContent сопоставляет stepId с выходными данными шага. Используйте его, чтобы посмотреть, что выдал рабочий процесс, отладить ошибки или проверить промежуточные результаты. executionId должен быть идентификатором PipelineExecution, а не executionInputId. Если start_workflow вернул только executionInputId, сначала вызовите list_executions и сопоставьте pipelineExecutionInputId, чтобы найти идентификатор выполнения. Когда отправляете человеку ссылку на запуск конкретного шага, используйте /runs?runId=<executionId>&step=<workflowStepId>. Не отправляйте URL только на запуск и не просите человека вручную открывать шаг утверждения/вывода/ошибки/текущий шаг.

Получает строки из списка знаний (постранично, до 200 за один вызов). Используйте для просмотра актуальных данных или последовательного сканирования небольшого списка. Возвращает строки с полными rowData, count, totalCount для чтения нефильтрованного списка и nextToken. Передайте nextToken из предыдущего ответа, чтобы получить следующую страницу. nextToken равен null, когда строк больше нет. Когда вы упоминаете этот список человеку, включайте читаемое имя списка и стабильный ключ списка, если они известны, а не только ключ. Для целевого поиска по ID используйте get_knowledge_rows_by_ids - он получает конкретные строки за один вызов (макс. 200) без сканирования всего списка. Для запросов связей сущностей (например, «все сделки, оценённые этим инвестором») начните с query_kg_edges, затем передайте полученные ID узлов в get_knowledge_rows_by_ids.

Извлекает конкретные строки знаний по их ID. Возвращает полные данные строки для каждого запрошенного ID (максимум 200 за вызов). Используйте этот инструмент после query_kg_edges, чтобы загрузить полные данные строки для ID узлов, возвращённых Knowledge Graph. Каноническая последовательность для запросов в рамках сущности (например, «лучшие сделки для Teresa Abecasis»): 1. query_kg_edges({ entityName: "Teresa Abecasis", relationshipType: "SCORED" }) 2. get_knowledge_rows_by_ids({ rowIds: <targetNodeIds из шага 1> }) Сложность: O(edges for that entity) — не зависит от общего размера списка — и масштабируется до 10k+ строк без пагинации. Примечание: значения source_node_id и target_node_id из query_kg_edges напрямую соответствуют идентификаторам строк знаний для узлов сущностей инвестора/сделки. Строки, не принадлежащие рабочему пространству, молча исключаются из результатов.

Извлеки запись знаний текстового типа по ключу. Используй это для доступа к текстовым знаниям, таким как файлы обратной связи, заметки или конфигурационный текст, хранящийся в рабочем пространстве. Когда ты упоминаешь эту текстовую запись человеку, включи читаемое название/имя и постоянный текстовый ключ. Если сохранённое название отсутствует, создай короткое читаемое название на основе ключа и всё равно включи ключ. KG-First: Вызови это ДО того, как сгенерируешь какой-либо промпт шага AI, который ссылается на специфический контент рабочего пространства (инвестиционный тезис, голос бренда, описание ICP, рубрику оценки и т.д.), чтобы проверить, существует ли он уже. Если найден, передай его через шаг чтения во время выполнения, а не встраивай текст непосредственно в шаблон промпта.

Получает одну публичную ссылку на форму по токену/ID.

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

Получает глобальную историю оценивания сущностей из Knowledge Graph. Возвращает предыдущие решения об оценивании (PROCEED_TO_IC, HOLD_FOR_REVIEW, REPOSITION, SCORED) с оценками DMF и датами. Используйте это для ручного исследования и калибровки устаревших данных. Для запросов на оценивание в рабочих процессах следует предпочитать поля scoring_profile на уровне строк или действие приложения kg.retrieve-scoring-memory, когда доступны ограниченные идентификаторы целей. Возвращает как структурированные записи, так и компактный текстовый формат для внедрения в промпты.

Получает метаданные шэра по его идентификатору.

Читает полное содержимое снимка конфигурации БЕЗ его восстановления. Возвращает захваченные steps, context, name, description, goal, style и analyticsConfig в поле config, а также метаданные снимка (createdAt, source, label, updatedFields). Используйте это для проверки или сравнения старого снимка с текущим рабочим процессом без деструктивного танца create + restore + restore. Не расходует квоту.

Читает один шаг из рабочего процесса по идентификатору шага. Экономичная альтернатива get_workflow (обычно ~1 КБ против 50-200 КБ для полного рабочего процесса). Возвращает только определение настроенного шага. Чтобы отладить фактический промпт, использованный в конкретном выполнении, используйте list_timelines, затем get_timeline для этого вызова шага и проверьте metadata.computedPrompt. Используйте это перед редактированием полей в виде словаря (stepInputData.fieldUpdates, responseStructure, knowledgeSync.fieldMapping, agent.workers), когда нужно получить текущее значение для сложного локального редактирования. Для простых слияний однословарных полей и установки вложенных путей предпочитайте replace_step_dictionary / replace_step_path вместо ручного update_step + replace[]. ## Разрешение источника - source: "auto" (по умолчанию) — возвращает черновой шаг, если черновик существует, иначе рабочий. Соответствует маршрутизации update_step для рабочих процессов. - source: "live" — всегда читает из рабочего конвейера, игнорируя любой черновик. - source: "draft" — возвращает черновой шаг или 404, если черновика нет. Никогда не создаёт черновик. Ответ включает разрешённый source: "live" | "draft", чтобы вы знали, какой получили. ## Формат ответа { workflowId, stepId, source, step: <PipelineStep>, contextRefs: { inputPagesUsed: ["company_url", ...], // ссылки на {{input.X}}, найденные в шаге stepRefs: ["fetch", "analyze", ...] // ссылки на {{steps.X.*}}, найденные в шаге }, draft?: { // присутствует, когда существует снимок черновика exists: true, draftCreatedAt, liveUpdatedAt, stale: boolean, // рабочий процесс продвинулся дальше draft.createdAt modifiedStepIds: [...], // идентификаторы шагов, различающиеся между черновиком и рабочим modifiedFields: ["steps", "context", ...] // ключи верхнего уровня, различающиеся } } contextRefs сообщает, от каких вышестоящих полей зависит шаг — полезно, когда вы собираетесь разорвать нисходящую цепочку, редактируя входные данные. draft.stale === true…

Получает допустимые поля и минимальные JSON-примеры для шагов пайплайна. Неизвестные поля автоматически удаляются при сохранении — сохраняются только перечисленные здесь поля. ## Параметры - stepType (опционально): отфильтровать по одному из trigger, aiAction, aiActionWithTools, appAction, agentOrchestrator, code, knowledgeSync, share, return, milestone и т.д. Опустите для полной схемы. - shape (опционально): минимальный JSON-пример для конкретной формы. Требует stepType. Примеры: - Формы aiAction: standard, report (с Config renderer), email (сформированное письмо с утверждением). - Формы aiActionWithTools: standard, agentic-search (web_search + workspace_memory). - Формы agentOrchestrator: supervisor (пресет Agent Team). - Формы share: public (публичный URL для шага отчёта). - Формы knowledgeSync: standard (детерминированное сопоставление полей KG). - Формы outputPage: standard — схема выходной страницы на уровне воркфлоу для context.outputPages (НЕ шаг пайплайна; редактируется через update_workflow_context). - Формы inputPage: standard — схема входной страницы конфигурации на уровне воркфлоу для context.inputPages. ## Формат ответа { "description": "...", // описание схемы "fieldCount": <number>, // всего полей (ограничено stepType, если указан) "groups": [<field groups>], // группы схемы (ограничено stepType, если указан) "shapes": [<shape examples>] // только когда указан stepType } Ключи верхнего уровня обратно совместимы с вызывающим кодом до v0.11, который читает description/groups напрямую. ## Когда вызывать - Перед добавлением шага отчёта: get_step_schema({ stepType: "aiAction", shape: "report" }). - Перед добавлением шага сформированного письма: get_step_schema({ stepType: "aiAction", shape: "email" }) — не забудьте также добавить входную страницу outreachProfile. - Перед добавлением Agent Team: get_step_schema({ stepType: "agentOrchestrator", shape: "supervisor" }). - **Перед добавлением…

Получает одну временную шкалу (запись выполнения шага) по идентификатору. Возвращает полную временную шкалу, включая eventContent (вывод шага), статус, метаданные и контекст. Используйте это, чтобы детально изучить результат конкретного шага. Чтобы отладить фактический промпт, использованный для данного вызова шага, проверьте metadata.computedPrompt. get_step показывает только настроенный шаблон промпта, а не разрешенный промпт выполнения.

Получает один вариант использования рабочего пространства по сохраненному ID, ключу или workflowGraphId. Используйте это как первый шаг проверки для конкретной бизнес-цели, например business-intro или front-desk. Читайте operatingGuides перед тем, как отвечать на вопросы, связанные с конкретным workflow, или изменять связанные workflow. Поле normalized onboardingGoal: только стабильная желаемая конфигурация; никогда не выводите из него активное согласование. Если agentGuidance.warnings включает MISSING_USE_CASE_OPERATING_GUIDE, сообщите, что отсутствует operating README, и создайте/обновите связанный текст знаний, прежде чем считать контекст завершенным. Этот инструмент только для чтения; операции create/update/provisioning намеренно остаются отдельными до появления атомарного жизненного цикла набора вариантов использования.

Получает нормализованный контракт onboarding-goal и свежеразрешённое принудительное одобрение для одного WorkspaceUseCase. Используйте этот инструмент вместо чтения сырой конфигурации при принятии решения — является ли операция автоматической, требующей одобрения, отключённой, несогласованной или неразрешённой. Инструмент доступен только для чтения, не запускает рабочие процессы, не активирует подпрограммы, не вызывает провайдеров, не тратит кредиты, не принимает решения об одобрении и не выполняет внешние записи.

Получает текущую оценку соответствия для одной записи в варианте использования рабочей области. Ответ хранит оценку соответствия отдельно от sourceOperationalStatus и явно сообщает о нулевых побочных эффектах workflow, routine, provider, approval, CRM и credit. Этот инструмент только для чтения.

Получает полные сведения о workflow, включая все шаги, контекст, метаданные и конфигурацию. Также возвращает hasDraftSnapshot (boolean) и краткое описание draftSnapshot, если для живого workflow существует черновик. Когда доступен, useCaseContext связывает workflow с его WorkspaceUseCase и командами operating-guide README. Прочитайте связанный use case и руководство, прежде чем делать утверждения или изменения, специфичные для workflow; предупреждения об отсутствии руководства означают, что контекст неполон.

Получает агрегированную аналитику рабочих процессов из сохранённых снимков. Используйте type="business" для получения бизнес-метрик, настроенных в analyticsConfig, включая метрики trackingEvent, такие как opened/clicked, если они настроены. Используйте period="lifetime" для общих сумм за всё время или period="daily" для временного ряда.

Получает расходы кредитов для одного workflow, полученные из ledger и помеченные периодом. По умолчанию период равен rolling-30-days. Устанавливает includeCostDrivers=true для ограниченных драйверов стоимости шагов/моделей/приложений. Всегда отображает возвращаемые period.label/display/start/end вместе с любым итогом кредитов. Намеренно использует all-time, так как может сканировать больше строк ledger.

Получает информацию о компании рабочего пространства, текущем аутентифицированном пользователе, видимости команды и обзор схемы знаний. Возвращает currentUser для владельца API-ключа, сведения о компании, активных участников команды (если есть), ожидающие приглашения в команду (если есть), а также сводку всех списков знаний с их определениями полей и количеством строк. Используйте этот вызов первым, чтобы понять, какие данные есть в рабочем пространстве.

Получает профиль компании рабочего пространства и текст знаний компании. Возвращает запись компании, используемую для настройки рабочего пространства, а также markdown из ключей знаний company.profile и company.products. Используйте это, когда вам нужен редактируемый профиль компании, а не более широкий контекст рабочего пространства.

Получает краткий отчёт о факторах стоимости кредитов рабочего пространства, полученный из ledger. По умолчанию установлены period=rolling-30-days и includeCostDrivers=true. Возвращаемые итоги помечены периодом; всегда показывайте period.label/display/start/end вместе с итогами по кредитам. Факторы затрат включают ограниченные топ-процессы, шаги, модели и приложения. Используйте all-time осознанно, так как он позволяет сканировать больше строк ledger.

Возвращает канонический creditSnapshot рабочего пространства плюс опциональную статистику использования с метками периодов. Возвращает: - creditSnapshot: баланс на определённый момент времени с версионированием схемы (плановая квота, месячный остаток, купленные сохранённые/доступные/недоступные, даты обновления/продления, неподдерживаемые резервы = 0, доступные кредиты). Используйте эти поля как приоритетные. - currentBalance / monthlyCredits / purchasedCredits / nextCreditResetAt: устаревшие плоские псевдонимы в процессе миграции (monthlyCredits обозначает остаток по месячным кредитам, а не плановую квоту). - period: точная именованная временная рамка для каждой суммы использования (название, отображение, начало, конец). - periodDays: окно обратного просмотра для статистики использования, если применимо. - usedThisPeriod: всего кредитов израсходовано за указанный период. - totalExecutions: количество уникальных выполнений рабочих процессов за период. - averageCreditsPerExecution: средняя стоимость одного запуска. - recentUsage: последние 20 списаний кредитов с контекстом выполнения/шага, если только includeRecentUsage=false. - costDrivers: опциональный список основных рабочих процессов, шагов, моделей и приложений, ограниченный по количеству, при includeCostDrivers=true. Идентификация рабочего пространства берётся только из API-ключа. Каждая сумма использования выводится из учётной книги и должна отображаться с меткой периода. Используйте creditSnapshot для точного баланса доступных к списанию кредитов; формируйте отчёт по использованию отдельно.

Читает основные привязки жизненного цикла и установки для зарегистрированного пакета рабочего пространства. Только для чтения, не активирует и не запускает установленные активы.

Получает навык, созданный в рабочем пространстве, по ID.

Получает одно сохранённое WorkspaceView по сохранённому id или ключу. Читает agentGuidance перед рендерингом или действием из представления. Чтения представления безопасны; выполнение действий по-прежнему должно использовать обычные политики одобрения и побочных эффектов.

Создаёт новый workflow Agentled из импорта n8n JSON. Поведение: - запускает детерминированный предварительный просмотр импорта - создаёт workflow в режиме черновика preflight - сохраняет импортированный контракт для проверки/утверждения - НЕ применяет scaffold автоматически Требует права на запись при подключении через OAuth.

Импортирует рабочий процесс из экспортированного JSON в это рабочее пространство. Принимает полный объект WorkflowExport (из export_workflow) и создаёт новый рабочий процесс с новыми идентификаторами. Связанные страницы воссоздаются. Происхождение импорта записывается в метаданные рабочего процесса. Используйте вместе с export_workflow для перемещения рабочих процессов между средами. Совет: зарегистрируйте отдельные серверы MCP для песочницы и прода, экспортируйте из одного, импортируйте в другой. Требует права на запись при подключении через OAuth.

Импортирует файл навыка в формате Markdown, SKILL.md или JSON в черновик навыка рабочей области. При этом создаётся один вспомогательный AgentFile рабочей области, а затем один черновик WorkspaceSkill. Импортированные allowedApps/allowedActions — это только рекомендуемые приложения/действия. Импорт не предоставляет эти инструменты, не публикует навык, не назначает его агенту, не запускает чат/рутины/рабочие процессы, не создаёт провайдеров, не отправляет сообщения, не обходит утверждения и не тратит кредиты. Используйте publish_workspace_skill и явное назначение агенту только после проверки черновика. Требует права на запись при подключении через OAuth.

Инспектирует конфигурацию вкладок Home и Recent в рабочем пространстве и возвращает текущую ревизию рабочего пространства. Возвращает "tabs": каждую вкладку Home в порядке отображения (вкладка Recent плюс одна вкладка на активный вариант использования) с её id, kind, label и флагом isDefault, а также "defaultTabId" для вкладки, которую Home открывает по умолчанию. Вкладка Recent, помеченная как "visibleWhenRunsExist", ещё не имеет сохранённой конфигурации, поэтому Home показывает её только после того, как в рабочем пространстве появятся запуски. Вызовите это перед configure_home_recent_tab. Конфигурация предназначена только для отображения, и её инспектирование не запускает рабочие процессы, не вызывает провайдеров, не расходует кредиты и не изменяет данные клиентов.

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

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

Перечисляет всех агентов в рабочем пространстве. Агенты — это идентификаторы в рабочем пространстве с инструкциями, файлами, назначенными рабочими процессами, чатом и опционально прикреплёнными процедурами для запланированной/автономной работы. Каждый агент содержит массив channels для текущих доступных входящих каналов: - email появляется для каждого агента, когда канал электронной почты рабочего пространства включён, с производным адресом для каждого агента - Slack, WhatsApp, Signal и Telegram появляются только у агента, назначенного как defaultAgentId этого канала

Перечислите поддерживаемые идентификаторы навыков агента для create_agent, update_agent, create_routine и update_routine. Используйте эти идентификаторы в skillIds. Внутри они хранятся как enabledSkills, но в пользовательском интерфейсе следует писать Skills. По умолчанию возвращает только публичные пользовательские навыки. Передавайте includeRuntime: true только для расширенной конфигурации пакета среды выполнения, такой как workflow-operator, template-runner, inline-execution, routine-core или channel-email. Навыки agent-manager и routine-manager — это инструменты управляющей плоскости для черновиков групп целей, агентов-владельцев, переиспользуемых ресурсов и приостановленных расписаний; активация или запланированная автономия по-прежнему требует явного одобрения и аудита.

Перечисляет доступные приложения и интеграции в Agentled. Возвращает названия приложений, описания и сводки действий. Используйте это, чтобы узнать, какие интеграции доступны перед созданием workflow. Часто используемые приложения: agentled (обогащение LinkedIn, поиск email), hunter (email), web-scraping, affinity-crm, specter, http-request. Передайте grep для фильтрации по ключевому слову - это намного дешевле, чем загружать полный каталог, если нужно проверить только одну платформу (например, grep: "producthunt" для ответа на вопрос «есть ли приложение ProductHunt?»). Ключевое слово сопоставляется (без учёта регистра) с идентификатором приложения, названием, описанием и идентификаторами/метками действий. Всегда запускайте это перед проектированием любого шага «найти / получить / обнаружить / получить источник» - откат к aiActionWithTools + web_search без проверки - это то, как агенты тратят 25 кредитов за страницу, когда существует нативный вызов за 1 кредит.

Выводит список рабочих элементов, подходящих для данного аутентифицированного сборщика. По умолчанию возвращает элементы со статусами queued и needs_changes, назначенные зарегистрированному сборщику или API-ключу, если таковые имеются.

Выводит список открытых, просроченных и отправленных рабочих элементов сборки для бизнес-агента по sourceAgentEntityId.

Перечисляет интеграции каналов рабочего пространства и их конфигурацию. Возвращает каждый настроенный канал (email, slack, whatsapp, signal, telegram) с: - enabled: активен ли канал - defaultAgentId: идентификатор агента, обрабатывающего входящие разговоры на каналах с маршрутизацией по умолчанию - inboundAddress (email): шаблон адреса рабочего пространства; каждый агент также предоставляет свой собственный email в list_agents/get_agent/create_agent - Другие несекретные настройки (названия команд, идентификаторы каналов, номера телефонов) Секретные учётные данные (токены ботов, токены доступа, секреты подписи) СКРЫТЫ в ответе. Используйте это, чтобы узнать, какие каналы существуют, прежде чем назначать агентов на каналы с маршрутизацией по умолчанию.

Перечисляет все подключенные интеграции для рабочего пространства. Возвращает единый список подключений из всех источников: - OAuth-подключения (через Composio) - Подключения по API-ключам (например, Hunter, Affinity CRM) с маскированным предпросмотром ключа - Нативные OAuth (социальные аккаунты) Каждое подключение показывает appId, статус, источник и для API-ключей: маскированный keyPreview (например, "c5a1...5532"). Позволяет проверить, какие приложения настроены, перед запуском рабочих процессов, зависящих от них.

Перечисляет последние выполнения для рабочего процесса. Возвращает execution id, pipelineExecutionInputId, статус, временные метки. Используйте pipelineExecutionInputId для сопоставления с executionInputId, возвращённым start_workflow, когда executionId ещё не был доступен.

Выводит все схемы списков знаний с определениями полей, количеством строк и метаданными. Возвращает подробную информацию о каждом списке, включая поля, тип источника, категорию, конфигурацию сущности и статус синхронизации с KG. Используйте это, чтобы узнать, какие списки существуют, и понять их структуру перед запросом строк. Когда вы упоминаете списки знаний или текстовые записи в ответе человеку, включайте как удобочитаемое название, так и стабильный ключ/идентификатор, а не только идентификатор. Пример: VC Contacts (gtm_vc_contacts). KG-First: Вызывайте это ДО генерации любого промпта шага ИИ, который ссылается на бизнес-специфичную персонализацию (критерии ICP, оценочные рубрики, отраслевые списки, исходные списки и т.д.), чтобы проверить, существует ли уже контент в рабочей области знаний. Если да, ссылайтесь на него во время выполнения через kg.read-list, а не жёстко прописывайте его в шаблоне промпта.

Перечисляет все воспоминания в заданной области. Возвращает воспоминания, отсортированные по уверенности.

Перечисляет все поддерживаемые AI модели для шагов рабочего процесса. Возвращает идентификатор модели, провайдера, отображаемое имя, уровень (mini/standard/max), стоимость в кредитах и категорию. Используйте идентификатор модели в step.agent.model и провайдера в step.agent.provider при настройке AI шагов. Пример: agent: { model: "claude-5-opus", provider: "anthropic" }

Перечислите выходные страницы, которые в данный момент закреплены на домашней/боковой панели рабочей области. Закреплённые выходные страницы - это ярлыки уровня рабочей области к страницам вывода рабочих процессов, хранящиеся в Workspace.metadata.pinnedOutputs. Используйте это перед изменением закреплённых страниц, чтобы не создать дубликат или не удалить не тот ярлык.

Перечисляет публичные ссылки на формы для рабочего процесса. Публичные URL используют /en/forms/{formLinkId}.

Перечисляет все рутины для агента. Рутины — это запланированные задачи, которые выполняются автоматически с фиксированным интервалом (например, ежедневно, по будням утром). Передайте slug агента (например, "dealflow") или ID в качестве agent_id.

Перечисляет снимки конфигурации для рабочего процесса с постраничной разбивкой по всем страницам (максимум 500). Снимки автоматически создаются перед каждым внешним обновлением API, что позволяет восстановить предыдущую конфигурацию. Включает как сохранённые версии, так и неопубликованные черновики. Используйте фильтр для сужения результатов: 'all' (по умолчанию, включает черновики), 'saved' (без черновиков) или 'draft' (только черновики). Возвращает идентификатор снимка, временную метку, источник и список изменённых полей.

Выводит список временных линий (записей выполнения шагов) для конкретного выполнения. Каждая временная линия отображает выполненный шаг — его статус, вывод и метаданные. Используйте это для проверки результатов отдельных шагов, отладки ошибок или просмотра потока выполнения. При передаче конкретной временной линии/одобрения/вывода/ошибки человеку используйте /runs?runId=<executionId>&step=<workflowStepId>; значение шага — это идентификатор шага рабочего процесса из этих записей, а не идентификатор временной линии. Чтобы отладить фактический prompt, использованный для шага в выполнении, найдите временную линию этого шага здесь, затем вызовите get_timeline и проверьте metadata.computedPrompt. get_step показывает только настроенный шаблон prompt, а не разрешённый prompt выполнения.

Перечисляет необработанные события отслеживания для рабочего процесса, например события отправки, открытия и кликов по email. Поддерживает фильтрацию по eventType, executionId, timelineId, channel и диапазону createdAt. Установите aggregate=true, чтобы включить простые подсчеты по типу события, каналу и URL для возвращаемой страницы.

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

Перечисляет варианты использования workspace и их руководства по эксплуатации, связанные рабочие процессы, агентов, рутины, AgentFiles, ссылки на знания, источники данных, конфигурацию, проверку и метаданные. Используйте это перед созданием или изменением бизнес-цели с несколькими рабочими процессами, чтобы можно было повторно использовать существующий WorkspaceUseCase вместо создания разрозненных рабочих процессов вручную. Сначала прочитайте operatingGuides/agentGuidance; отсутствующие предупреждения operating-guide означают, что контекст агента неполный. Этот инструмент доступен только для чтения и не запускает рабочие процессы, не расходует кредиты, не запускает рутины и не записывает данные в провайдеры.

Перечисляет все рабочие процессы в рабочем пространстве. Возвращает краткие сводки рабочих процессов и небольшие поля metadataSummary (analytics, workflowGraph, revision, imports, builder preflight state). Используйте get_workflow для получения полных шагов, контекста, сырых метаданных, полного предварительного просмотра контракта/компилятора builder и истории обновлений.

Перечисляет навыки, созданные в рабочей области. Это записи навыков в статусе черновика, опубликованные или архивные, основанные на содержимом AgentFile. Используйте import_workspace_skill для одноэтапного импорта Markdown/SKILL.md/JSON. Используйте create_workspace_skill только если у вас уже есть идентификатор базового AgentFile. Параметры allowedApps/allowedActions навыка рабочей области — это только рекомендуемые инструменты; они не предоставляют область действия приложения/действия, пакеты времени выполнения, подключения к рабочей области, доступ на запись или обход одобрения.

Перечисляет сохранённые представления рабочей области и их источник/руководство по действиям. Используйте это перед разработкой нового представления, чтобы повторно использовать или обновить существующую рабочую поверхность. Этот инструмент только для чтения и не запускает рабочие процессы, не читает данные провайдера, не изменяет строки KG, не принимает решения об одобрении и не тратит кредиты.

Добавляет, удаляет или заменяет рабочие процессы, назначенные агенту, без передачи полной конфигурации агента. - операция 'add': добавляет workflowIds в конец существующего списка (ничего не делает для уже присутствующих ID) - операция 'remove': удаляет указанные workflowIds из списка - операция 'set': заменяет весь список переданными workflowIds Используйте 'set' с пустым массивом, чтобы очистить все назначенные процессы. Требует права на запись при подключении через OAuth.

Перемещает шаг на новую позицию в массиве steps рабочего процесса. Укажите ровно одну цель: - insertAfter: поместить шаг сразу после указанного ID шага. - position: "first": поместить шаг на индекс 0. Используйте это, чтобы вернуть триггер на первую позицию после цикла remove + add (единственный способ восстановить порядок триггеров через MCP — add_step всегда добавляет в конец). - position: "last": поместить шаг в конец массива. Изменяется только порядок массива — НЕ модифицируются ни указатели next, ни конфигурация шага. Это чисто косметическая перестановка, которая исправляет предупреждение валидатора "orchestrator-issue", вызванное тем, что шаги хранятся в порядке, не соответствующем цепочке выполнения. Используйте это, когда валидатор сообщает: "Шаг X находится после шага Y, но выполняется перед ним. Переупорядочьте массив steps..." Работает как с действующими рабочими процессами (через черновик-снимок), так и с черновиками рабочих процессов. Требует права на запись при подключении через OAuth.

Хирургически редактирует метаданные PipelineExecution, currentStepId или статус без повторного запуска рабочего процесса. ИСКЛЮЧИТЕЛЬНЫЙ инструмент (EXCEPTION-ONLY). Основной вариант использования: переименовать stuck-, completed- или test-запуск так, чтобы он отличался в списке запусков, не тратя кредиты на повторный запуск. Другие варианты: - обновить metadata.debugNote во время расследования инцидента - обновить metadata.pendingReasonTag для аннотации в UI - продвинуть currentStepId для восстановления после зависания (только когда статус waiting или failed) - принудительно изменить статус: waiting/failed/credits_missing → running, или started → stopped/canceled НЕ ИСПОЛЬЗУЙТЕ для рутинной работы. Если вы ловите себя на том, что тянетесь к этому инструменту снова и снова, значит базовый рабочий процесс настроен неправильно, и правильное решение — обновить определение рабочего процесса или входные данные запуска. Обязательно: - API-ключ с областью admin:patch (этап 2) - reason, expectedUpdatedAt — как у patch_timeline_fields Разрешённые пути: - metadata.debugNote - metadata.pendingReasonTag - metadata.executionName (переименовывает запуск; оркестратор может пересчитать по executionNameTemplate) - currentStepId (только когда статус waiting или failed) - status (только waiting → running, failed → running, credits_missing → running, started → stopped/canceled) Исключение для завершающих запусков: - у completed/canceled/approved/stopped запусков можно патчить только metadata.executionName - запись в metadata.debugNote, metadata.pendingReasonTag, currentStepId, status или смешанные пакеты отклоняется Запрещено: - полная замена metadata (нужно использовать подпути) - аналитические итоги (totalCreditsUsed, creditsUsed, analyticsExtracted и т.д. — всё, что не в белом списке) - поля идентификации, executionContent, completedAt, запись терминального статуса вне исключения для metadata.executionName Аудит: каждый патч добавляет запись в metadata.adminPatchLog с { actor, apiKeyId, reason, diffs, timestamp }. Это место краткосрочного хранения по §8.1 — достаточно для…

Хирургически редактирует eventSummary, ожидающий утверждения eventContent или поля метаданных временной шкалы без повторного запуска вышестоящего шага. Терминальные перемаркировки только eventSummary не требуют confirmTimelineId; остальные терминальные исправления требуют подтверждения точного ID. Инструмент ТОЛЬКО ДЛЯ ИСКЛЮЧИТЕЛЬНЫХ СЛУЧАЕВ. Варианты использования: - Исправить повреждённую устаревшую/непредпросмотренную ожидающую временную шкалу, с которой не справляется обычный редактор утверждения. - Перемаркировать eventSummary терминальной временной шкалы, чтобы строка шкалы соответствовала подтверждённому результату, аналогично перемаркировкам metadata.executionName в исполнениях. - Обновить metadata.pendingReasonTag для аннотации в интерфейсе. - Восстановить завершившуюся сбоем временную шкалу обратно в ожидание (переход статуса: failed → pending). - Исправить повреждённый eventContent на завершённой/утверждённой/отклонённой терминальной временной шкале после инцидента, только когда повторный запуск/повтор привёл бы к дублированию побочных эффектов или потере канонического вывода. НЕ ИСПОЛЬЗУЙТЕ для обычных изменений ожидающих утверждения. Редактируйте здоровый черновик _previewApproval на месте через карточку утверждения или агента на стороне запуска; не перезапускайте его только ради изменения текста, получателей, дат, ссылок или медиа. Этот административный инструмент предназначен для реагирования на инциденты вне этого обычного контракта. Обязательно: - API-ключ с областью admin:patch (Этап 2 — без него возвращает 403 FORBIDDEN_SCOPE) - reason: непустая строка (≤500 символов), сохраняется в строке аудита - expectedUpdatedAt: timeline.updatedAt из свежего чтения — защита от состояний гонки при потерянных обновлениях - confirmTimelineId: требуется для терминальных записей, кроме перемаркировок только eventSummary; должен быть точным ID редактируемой временной шкалы Разрешённые пути (любой нетерминальный статус): - eventSummary - metadata.pendingReasonTag Разрешённые пути (status === 'pending'): - eventSummary - eventContent (полная замена; зарезервированные ключи _* отклоняются) - eventContent.email.subject | body | bodyType | to | cc | bcc - eventContent.<любой> (любое поле, сгенерированное AI, кроме зарезервированных ключей с префиксом _*) - metadata.pendingReasonTag - status (pending → completed) Разрешённые пути (failed…

Приостанавливает активного агента. Подпрограммы, прикреплённые к агенту, прекращают выполняться, пока агент не будет возобновлён с помощью activate_agent. Требует права на запись при подключении через OAuth.

Приостанавливает процедуру (статус → paused). Процедура не будет выполняться, пока не будет возобновлена. Требует доступ на запись при подключении через OAuth.

Предварительно просматривает детерминированный импорт n8n из JSON. Возвращает: - нормализованный хеш импорта и IR - отображенный граф шагов - неподдерживаемые узлы + рекомендации по исправлению - предупреждения/риски - черновой контракт сборки рабочего процесса и сводка готовности компилятора Это предварительный просмотр только для чтения и не создает никакой рабочий процесс.

Предварительно просматривает общий план приостановленного пакета для набора Source -> KG -> Process WorkspaceUseCase. Используйте это перед созданием нескольких связанных рабочих процессов для поиска, приёма, мониторинга, деловых знакомств или других общих сценариев использования. Сервер компилирует типизированный набор в локальный для рабочего пространства пакет совместимости и возвращает его точную подписанную предварительную версию. Просмотрите и сохраните эту предварительную версию для provision_use_case_kit. Это операция только для чтения: она не создаёт записи, рабочие процессы, строки KG, отправки, записи провайдеров, запуски процедур и не тратит кредиты.

Формирует точный подписанный неизменяемый план установки для зарегистрированного пакета рабочей области. Подходящие существующие ресурсы можно просмотреть с помощью разрешений на принятие или сохранение, привязанных к отпечатку. Принятие является аддитивным: существующая идентичность и настройки, принадлежащие рабочей области, сохраняются. Предварительный просмотр никогда не применяется и не изменяет рабочую область. Предварительный просмотр привязан к рабочей области, назначению, версии пакета, манифесту, авторитетному снимку, разрешениям, операциям и ссылке на утверждение. Проверьте его перед любым применением.

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

Служит устаревшим псевдонимом совместимости для применения ранее проверенного пакета Source -> KG -> Process WorkspaceUseCase. Сначала используйте preview_use_case_kit, просмотрите детерминированный план и верните его точный подписанный превью только после того, как пользователь одобрит эти записи. Сервер перекомпилирует типизированный kit и отклоняет любой изменённый payload, устаревший превью, коллизию или несовпадающую привязку. Это делегирует общему приостановленному жизненному циклу пакета; он не запускает рабочие процессы, не вставляет строки KG, не отправляет сообщения, не записывает во внешние провайдеры, не запускает процедуры, не принимает решения об одобрении и не расходует кредиты. Требует confirmToken точно "PROVISION_USE_CASE_KIT" и точный объект превью. Требует доступ на запись при подключении через OAuth.

Изменяет статус рабочего процесса (опубликовать, приостановить или архивировать). Допустимые переходы: created/draft → live, live → paused, paused → live, any → archived. Используйте «live», чтобы опубликовать черновик рабочего процесса и сделать его исполняемым. Требует права на запись при подключении через OAuth.

Публикует черновик навыка, созданного в рабочем пространстве. Требует права на запись при подключении через OAuth.

Обходит рёбра графа знаний по имени сущности и/или типу связи. Возвращает рёбра с идентификаторами исходного и целевого узлов, отношениями, оценками и метаданными. Используйте это для исследования связей сделок, связей инвестор-стартап и рёбер с оценками. Корректно возвращает пустой результат, если граф знаний не настроен. Значения source_node_id и target_node_id соответствуют идентификаторам строк знаний. Используйте get_knowledge_rows_by_ids как последующий вызов для получения полных данных строк по этим идентификаторам. Пример: query_kg_edges({ entityName: "Teresa Abecasis", relationshipType: "SCORED" }) → получите targetNodeIds → get_knowledge_rows_by_ids({ rowIds: targetNodeIds }).

Читает полный вывод из предыдущего шага рабочего процесса. Используйте этот инструмент, когда вывод шага был отложен как ссылка на инструмент в подсказке — вы увидите блок вида: [Tool Reference: stepName] Size: 24.3KB | Fields: name, emails, organizations, ... To read full data: call read_step_output(executionId="...", stepId="...") Передайте executionId и stepId, указанные в этом блоке. При желании сузьте ответ с помощью 'field' (путь в точечной нотации) или 'select' (список полей верхнего уровня для включения).

Извлекает конкретную запись по ключу. Возвращает сохранённое значение, если найдено. Используйте это для извлечения ранее сохранённых фактов, выводов, предпочтений или результатов. KG-First: Вызывайте это ДО генерации AI-step prompts, которые ссылаются на стратегию, специфичную для рабочего пространства (ICP, thesis, rubric). Если содержимое существует как запись в памяти, ссылайтесь на него во время выполнения через встроенный инструмент workspace_memory, а не вставляйте его в шаблон промпта.

Возобновляет только ожидающие ресурсы из незавершённой установки пакета, используя свежий точный подписанный предварительный просмотр и подтверждение. Восстановление использует тот же приостановленный жизненный цикл и требует workspace:packages:apply, а также права владельца рабочей области или ADMIN. Требует права на запись при подключении через OAuth.

Окончательно отклоняет одну ожидающую заявку на утверждение агента (AgentApprovalRequest) в текущей рабочей области. Требует точный идентификатор запроса на утверждение, непустой комментарий оператора и confirm=true. Это никогда не утверждает, не отправляет, не выполняет, не повторяет, не продолжает и не вызывает провайдера. Предыдущее окончательное решение сохраняется и не может быть перезаписано. Требует доступ на запись при подключении через OAuth.

Удаляет шаг из рабочего процесса с опциональным переключением указателя next. Когда rewireNext имеет значение true (по умолчанию): шаги, которые указывали на удалённый шаг, переключаются на целевой шаг удалённого шага. Критерии входного условия, ссылающиеся на удалённый шаг, также очищаются. Учитывает маршрутизацию чернового снимка для рабочих процессов в реальном времени. Требует доступ на запись при подключении через OAuth.

Удаляет один элемент из пути массива шагов по индексу index или точному значению match. Укажите ровно один из параметров: index или match. Используйте этот инструмент вместо создания сокращенного массива вручную через raw update_step, если нужно удалить только одну запись. Возвращает результат той же структуры, что и update_step. Требует права на запись при подключении через OAuth.

Предпочтителен для полей шагов в виде словаря, где ключи — пользовательские данные. Объединяет ключи переданного объекта с существующим словарём по пути path, не удаляя соседние ключи. Внутренняя логика: get_step → merge → update_step с безопасной заменой на верхнем уровне. Канонические пути: - stepInputData.fieldUpdates - pipelineStepPrompt.responseStructure - knowledgeSync.fieldMapping Используйте сырой update_step только если вам намеренно нужно полностью переписать словарь или выполнить пакетное изменение нескольких путей. Возвращает ту же структуру, что и update_step (объединённый шаг, diff, предупреждения, валидация, метаданные черновика). Требует права на запись при подключении через OAuth.

Устанавливает значение value по одному вложенному пути шага, сохраняя соседние поля. Предпочтителен для вложенных правок конфигурации, таких как renderer.config.layout, где наивный патч через update_step затрёт соседние ключи конфигурации. Внутренне считывает шаг, клонирует родительское поле верхнего уровня, применяет запись по пути, затем вызывает update_step с replace для этого поля верхнего уровня. Для слияния словарных ключей (fieldUpdates, responseStructure, fieldMapping) предпочтительнее использовать replace_step_dictionary. Возвращает ту же структуру, что и update_step. Требует доступ на запись при подключении через OAuth.

Перезапускает или повторяет любой шаг в выполнении рабочего процесса. Передаёт timelineId — серверная часть автоматически получает всё остальное (workflowId, executionId, stepId) из записи timeline. Работает как для повторения неудачных шагов, так и для перезапуска любого шага независимо от статуса. По умолчанию обходит кэш (forceWithoutCache: true). Чтобы найти timelineId: используйте list_timelines для просмотра записей выполнения шагов для какого-либо выполнения, или get_execution, который включает последние идентификаторы timeline. Требует права на запись при подключении через OAuth.

[Устарело — используйте rerun вместо] Повторно запускает определённый шаг в выполнении рабочего процесса, независимо от статуса шага (ожидание, завершён, не удался, пропущен). Работает с любым шагом и использует текущую активную конфигурацию конвейера. По умолчанию обходит кэш (forceWithoutCache: true). Если timelineId не указан, последняя временная линия для этого шага автоматически определяется и повторно запускается. Требует права на запись при подключении через OAuth.

Проверяет, существует ли уже рабочее пространство для фирмы, слага, домена, email владельца или ключа идемпотентности. Это только для чтения. Агентам следует вызывать этот инструмент перед create_workspace, чтобы повторно использовать существующие рабочие пространства фирмы вместо случайного создания дубликатов.

Восстанавливает строки из снимка в список Knowledge Data без затирания вычисляемых полей. Режимы (вычисляемые поля вроде оценок и обогащений всегда сохраняются): - "merge-restore" (по умолчанию) — для строк, которые уже существуют: поверхностно сливает поля снимка обратно (существующие вычисляемые поля выживают; поля снимка побеждают при конфликте). Новые строки вставляются. Используйте этот режим как путь отката — он отменяет неудачную миграцию, не уничтожая последующую работу. - "append" — вставляет только те строки, которых ещё нет; никогда не трогает существующие строки. Используйте этот режим при восстановлении в новый список или когда нужно добавить недостающие строки без изменений. Целевой listKey может отличаться от исходного listKey снимка — это позволяет клонировать между списками. Если целевой список не существует, он будет автоматически создан по схеме снимка. Возвращает: { restored (новые вставленные строки), merged (обновлённые строки), skipped, errors[] }. Требует права на запись при подключении через OAuth.

Восстанавливает рабочий процесс до предыдущего снимка конфигурации. Сначала используйте list_snapshots, чтобы найти идентификатор снимка. Это откатывает шаги, контекст, имя, описание, цель и стиль рабочего процесса к состоянию, захваченному в снимке. Требует доступа на запись при подключении через OAuth.

Возобновляет приостановленную рутину (статус → active). Рутины — платные автономные функции; бесплатные рабочие пространства не могут их возобновлять. nextRunAt сбрасывается на следующий момент выполнения интервала рутины от текущего момента. Требует права на запись при подключении через OAuth.

[Устарело — используйте rerun вместо этого] Повторяет неудачный шаг в выполнении рабочего процесса. Если timelineId не указан, последний неудачный timeline автоматически обнаруживается и повторяется. Это повторно запускает неудачный шаг и продолжает рабочий процесс с этой точки. Требует права на запись при подключении через OAuth.

Проверяет представленную работу строителя в качестве бизнес-агента; устанавливает статус accepted, needs_changes или closed и, опционально, прикрепляет сигнал качества thumbs-up/down. Требует права на запись при подключении через OAuth.

Отзывает/удаляет общий доступ по идентификатору общего доступа. Требует права на запись при подключении через OAuth.

Ищет воспоминания по запросу на естественном языке и/или категории. Возвращает подходящие воспоминания, отсортированные по степени уверенности. Используйте для поиска сохранённых знаний. KG-First: Вызывайте этот инструмент ДО генерации промтов AI-шагов с бизнес-специфичным содержимым, чтобы проверить, сохранена ли уже стратегия рабочего пространства (ICP, thesis, rubric). Ссылайтесь на найденные воспоминания во время выполнения, а не встраивайте их в строки промтов.

Назначает агента, который обрабатывает входящие разговоры на канале с маршрутизацией по умолчанию. Slack, WhatsApp, Signal и Telegram используют маршрутизацию defaultAgentId. Email не использует: email маршрутизируется по адресу каждого агента, и ответы агента включают производный адрес в свой массив channels. Используйте list_channels для просмотра текущих назначений и list_agents для поиска действительных ID агентов. Используйте configure_channel для более детальных обновлений (включение/отключение, allowedSenders, утверждение исходящей почты и т.д.). Требует доступ на запись при подключении через OAuth.

Обновляет общерабочие настройки каналов по умолчанию (ограничения скорости, тайм-ауты, режим инструментов). Эти настройки применяются ко всем включённым каналам: - maxSessionsPerDay: Лимит входящих чат-сессий в день (по умолчанию 100) - sessionTimeoutMinutes: Автоматическое закрытие сессий при бездействии (по умолчанию 60) - toolMode: 'all' (доступны все инструменты) или 'mcp' (только MCP-инструменты) Требует права на запись при подключении через OAuth.

Закрепляет или открепляет страницу вывода воркфлоу на домашней странице/боковой панели рабочего пространства. API проверяет, что воркфлоу принадлежит этому рабочему пространству и что путь страницы вывода существует в этом воркфлоу. Закрепляйте с осторожностью: используйте закрепление на уровне рабочего пространства только для повторяющихся отчётов, дашбордов, канонических списков результатов или других страниц, к которым пользователи должны обращаться напрямую с домашней страницы/боковой панели рабочего пространства. Требует права на запись при подключении через OAuth.

Устанавливает ключ Knowledge Text, который содержит краткую информацию о долговременной цели для одного сценария использования. Это изменяет только типизированный указатель. Он не редактирует содержимое Knowledge Text, не запускает рабочие процессы и процедуры, не вызывает провайдеров, не расходует кредиты, не принимает решения об утверждении и не выполняет внешние записи. Сервер повторно использует UI-валидатор и записывает строку аудита с указанием актора. Требует права на запись при подключении через OAuth.

Устанавливает финишную линию по умолчанию на одну веху, уже объявленную контрактом onboarding-goal. Это изменяет только конфигурацию желаемой цели. Он не может изменять свидетельства выполнения вехи во время выполнения или отмечать работу как завершённую, а также не запускает рабочие процессы, не запускает процедуры, не вызывает провайдеров, не тратит кредиты, не принимает решения об утверждении и не выполняет внешние записи. Требует права на запись при подключении через OAuth.

Устанавливает одну типизированную желаемую политику одобрения для существующего требования онбординга. Это изменяет только желаемую политику; не изменяет работающий workflow, агент, канал или принудительное выполнение рутинных действий и не утверждает и не выполняет никаких действий. Ослабление защиты на отправку, запись или удаление требует confirm=true. Сервер повторно использует UI-валидатор и записывает строку аудита с указанием исполнителя. Требует права на запись при подключении через OAuth.

Устанавливает основную CRM-ссылку, используемую одной целью онбординга. Это изменяет только типизированную CRM-ссылку. Не подключает приложение, не меняет учётные данные, не записывает данные CRM, не запускает рабочие процессы или процедуры, не вызывает провайдеров, не расходует кредиты и не принимает решения об утверждении. Сервер повторно использует валидатор пользовательского интерфейса и записывает строку аудита с указанием субъекта. Требует права на запись при подключении через OAuth.

Устанавливает оценку Good fit, Not a fit или Needs review только после явной инструкции пользователя. Он сохраняет структурированную память вариантов использования для конкретной записи. Он не запускает рабочие процессы, не инициирует процедуры, не вызывает ИИ/провайдеров, не утверждает и не отклоняет ожидающие работы, не записывает данные CRM, не изменяет исходную запись и не расходует кредиты. Свободные комментарии являются ненадёжным свидетельством и никогда не используются этим инструментом в подсказках или политике оценки. Требует права на запись при подключении через OAuth.

Создаёт или получает URL для общего доступа к выполнению. Требует права на запись при подключении через OAuth.

Создаёт полную резервную копию списка Knowledge Data на определённый момент времени. Возвращает все строки с их ID, rowData, status, createdAt и updatedAt в виде встроенного JSON. Также включает схему списка (fields, userKeyField), чтобы снимок был самодостаточным. Используйте перед любой рискованной миграцией, перестановкой канонических ключей или изменением схемы. Возвращаемый объект снимка можно передать непосредственно в restore_knowledge_list_snapshot для отката. Поддерживает списки до 5 000 строк (встроенный JSON). Более крупные списки пока не поддерживаются. Требует права на запись при подключении через OAuth.

Запускает выполнение workflow. Опционально предоставляет входные данные, которые сопоставляются с полями входной страницы workflow. Например, если workflow ожидает "company_url", передайте: { input: { company_url: "https://..." } } Возвращает executionInputId для переданной записи ввода/запуска. Также может вернуть executionId, если строка асинхронного PipelineExecution уже доступна. Используйте только executionId с get_execution/list_timelines/get_timeline. Если executionId отсутствует, вызовите list_executions и сопоставьте pipelineExecutionInputId с возвращённым executionInputId; id соответствующей строки — это executionId. Управление имитацией (mock): по умолчанию шаги, для которых настроены имитационные данные (step.mock.enabledByDefault), возвращают эти имитационные данные и не расходуют кредиты. Передайте useMocks: false, чтобы принудительно выполнить реальный запуск, игнорирующий имитацию для каждого шага. Передайте useMocks: true (или опустите), чтобы сохранить поведение workflow по умолчанию в отношении имитации. Требует права на запись при подключении через OAuth.

Останавливает активное выполнение workflow. Работает с выполнениями со статусом "running", "pending" или "started"; требуется указание понятной человеку причины, сохраняемой в метаданных выполнения. Требует права на запись при подключении через OAuth.

Сохраняет постоянную память. Память сохраняется между выполнениями рабочих процессов и может быть вызвана позже. Категории: fact (известный факт), insight (закономерность/вывод), preference (предпочтение пользователя), outcome (результат для отслеживания). KG-First: Используйте это для внедрения стратегического контента, специфичного для рабочей области (критерии ICP, определения оценочных рубрик, инвестиционное обоснование, голос бренда) ДО создания шагов рабочего процесса, которым он нужен. После сохранения шаг ИИ обращается к ней во время выполнения через встроенный инструмент workspace_memory, она никогда не прописывается жёстко в шаблоне промпта. Требует доступ на запись при подключении через OAuth.

Отправляет завершенные выходные ссылки сборщика и сводку. Рабочий элемент переходит в submitted для проверки бизнес-агентом. Требует права записи при подключении через OAuth.

Сообщите об ошибке, предложите улучшение, передайте проблему на рассмотрение или задайте вопрос команде Agentled. Используйте это, когда столкнулись с неработающей функцией, хотите предложить улучшение, нуждаетесь в помощи человека из команды Agentled или хотите передать проблему, которую не можете решить самостоятельно. Укажите понятный заголовок и подробное описание. Если требуется обратная связь, укажите email пользователя. Требует права на запись при подключении через OAuth.

Тестирует AI-запрос изолированно, без создания workflow или выполнения. Передаёт шаблон запроса с синтаксисом {{variable}} и значения переменных, чтобы запустить AI и увидеть ответ. Помогает настраивать запросы и структуры ответов перед добавлением AI-шага в workflow. Пример: test_ai_action("Analyze this company: {{company}}", { company: "Stripe" }, { score: "number 0-100", summary: "string" }) Требует доступ на запись при подключении через OAuth.

Тестирует действие приложения изолированно, без создания рабочего процесса или выполнения. Передаёт appId и actionId (из list_apps / get_app_actions) вместе с входными данными, чтобы запустить действие напрямую и сразу увидеть результаты. Полезно для проверки входных данных перед включением шага в рабочий процесс. Пример: test_app_action("web-scraping", "scrape", { url: "https://example.com" }) Требует права на запись при подключении через OAuth.

Тестирует шаг кода изолированно без создания рабочего процесса или выполнения. Передаёт JavaScript-код с опциональным синтаксисом шаблонов {{variable}} и значениями переменных для выполнения в том же изолированном контексте виртуальной машины, что и производственный оркестратор. Полезно для проверки логики кода и разрешения переменных шаблона перед добавлением шага кода в рабочий процесс. Не расходует кредиты. Пример: test_code_action("javascript", "const items = {{items}};\nreturn items.map(p => ({ name: p.fullName }));", { items: [{ fullName: "John" }, { fullName: "Jane" }] }) Требует доступ на запись при подключении через OAuth.

Запускает рутину немедленно, не изменяя её запланированную периодичность. Рабочие пространства бесплатного тарифа не могут запускать рутины. Используйте краткую причину, например "verify analytics monitor". Источник должен быть одним из: codex, claude, ui, api, mcp. Требует доступ на запись при подключении через OAuth.

Удаляет один типизированный указатель live-enforcement для требования утверждения онбординг-цели. Это изменяет только привязку требования. Не меняет связанный workflow, агента, канал или процедуру; не запускает провайдеров, не тратит кредиты, не принимает решения об утверждении и не выполняет внешние записи. Удаление пути из защиты отправки, записи или удаления требует confirm=true. Сервер повторно использует UI-валидатор и записывает строку аудита с указанием действующего лица. Требует права на запись при подключении через OAuth.

Удаляет одну точную ссылку на навык и агента из цели онбординга. Это изменяет только конфигурацию цели. Оно не удаляет навык из агента, не отзывает разрешения инструментов или приложений, не запускает провайдеров, не тратит кредиты и не выполняет внешние записи. Сервер повторно использует UI-валидатор и записывает строку аудита с указанием исполнителя. Требует права на запись при подключении через OAuth.

Удаляет один путь шага. Тонкая обёртка вокруг update_step({ unset: [path] }). Удаляет устаревший ввод, ключ конфигурации или оставшееся поле, специфичное для типа, после изменения формы. Путь должен существовать на шаге. Возвращает ту же форму, что и update_step. Требует доступ на запись при подключении через OAuth.

Точечное обновление одного агента. Предпочтительный способ изменения одного поля у существующего агента — затрагиваются только поля в updates / replace / unset, все остальные поля остаются без изменений. Та же модель слияния, что и в update_step. ## Семантика слияния update_agent принимает три независимые операции в одном вызове. Хотя бы одна из них должна быть непустой. - `updates` — частичный патч агента. Поля верхнего уровня (name, description, instructions, status, goals, chatModel, enabledApps и т.д.) заменяются поверхностно. Вложенные объекты (configFiles, avatar, appPermissions) глубоко сливаются НА ОДНОМ УРОВНЕ — ключи, которые вы не упоминаете, сохраняются. Массивы (enabledApps, enabledActions, assignedWorkflowIds, linkedFileIds) заменяются целиком. - `replace: string[]` — точечные пути, значения которых из updates назначаются ЦЕЛИКОМ, пропуская глубокое слияние. Используйте это, когда вы действительно хотите очистить словарь (например, replace: ["configFiles"] заменяет весь словарь configFiles целиком, а не сливает ключ за ключом). - `unset: string[]` — точечные пути для УДАЛЕНИЯ (например, ["goals"], ["configFiles.SOUL.md"]). Каждый из них должен существовать у агента на данный момент. - `null` в updates — сокращение для unset (например, updates: { goals: null }). ## Типовые рецепты редактирования | Цель | Вызов | |---|---| | Обновить один конфигурационный файл (сохранить остальные) | updates: { configFiles: { "SOUL.md": "new persona…" } } | | Заменить все инструкции | updates: { instructions: "new system prompt" } | | Переименовать slug/email адрес агента | updates: { slug: "pitchnight" } | | Назначить рабочие процессы (полная замена) | updates: { assignedWorkflowIds: ["wf-1", "wf-2"] } | | Добавить в назначенные рабочие процессы | получить через get_agent, изменить локально, отправить полный новый массив (или использовать manage_agent_workflows) | | Разрешить приложению запись с подтверждением | updates: { enabledApps: ["linkedin"], appPermissions: { linkedin: { access: "write", writeApprovalRequired: true } } } | | Переопределить подтверждение одного действия | updates: { enabledApps: ["linkedin"],… |

Обновляет файл, уже прикреплённый к агенту. Используйте это для долговременного контекста размышлений, такого как JOURNAL.md, OBJECTIVES.md и PEOPLE.md: сначала прочитайте текущий файл с помощью get_agent_file, затем отправьте полное обновлённое содержимое. Обновляйте только при наличии долговременного сигнала (решения, исправления, цели, контекст людей или полезные знания), а не для каждого хода чата. Файл уже должен быть привязан к агенту, поэтому этот инструмент не может случайно отредактировать не связанный с ним файл рабочей области. Требует права на запись при подключении через OAuth.

Обновляет конфигурацию whitelabel-брендинга рабочего пространства. Устанавливает любую комбинацию полей брендинга. Передайте null или пустую строку, чтобы очистить поле. Поля: - displayName: Название бренда, отображаемое клиентам (например, "Acme Corp") - logoUrl: URL изображения логотипа бренда - tagline: Короткий слоган под названием бренда - primaryColor: HEX-цвет для светлой темы (например, "#6366f1") - primaryColorDark: HEX-цвет для тёмной темы (например, "#818cf8") - faviconUrl: URL пользовательской иконки favicon - hideBadge: Boolean - скрывает бейдж "Built with Agentled" (требуется тариф teams/enterprise) Требует права записи при подключении через OAuth.

Добавляет или удаляет поля в схеме существующего списка знаний. Используйте это, чтобы развивать схему списка: добавлять новые столбцы или удалять неиспользуемые. Существующие строки не изменяются; новые поля будут отсутствовать в старых строках, пока не будут обновлены. Возвращает: { listKey, fieldCount }. Требует доступ на запись при подключении через OAuth.

Обновляет публичную ссылку на форму рабочего процесса, включая её включение/отключение, ограничения, автошаринг, срок действия и сообщение об успешной отправке. Требует права на запись при подключении через OAuth.

Обновляет поля процедуры. Изменяются только указанные поля. Если interval обновлён, nextRunAt автоматически пересчитывается. Требует прав на запись при подключении через OAuth.

Обновляет один шаг по идентификатору. Низкоуровневый примитив слияния — для однотипных правок одного пути отдавайте предпочтение точечным инструментам: - replace_step_dictionary — сливает ключи в fieldUpdates / responseStructure / fieldMapping без удаления соседних полей - replace_step_path — задаёт один вложенный путь, сохраняя соседние элементы (например, renderer.config.layout) - unset_step_path — удаляет один путь - append_step_array_item / remove_step_array_item — безопасно изменяет tools / integrations Используйте update_step для сложных правок по нескольким путям, преобразования структуры и массовых изменений. Отдавайте ему предпочтение перед update_workflow для любого изменения одного шага; полные массивы steps предназначены только для импорта и полных циклов «туда-обратно». ## Сначала знания (KG) — при редактировании шаблона промпта Если правка вводит или меняет контент, относящийся к рабочему пространству, в шаблоне промпта (тезис, ICP, рубрикатор, список секторов, геофокус, голос бренда) — сначала обратитесь к графу знаний: вызовите list_memories / list_knowledge_lists / get_knowledge_text. Добавьте контент туда, если его ещё нет, а затем ссылайтесь на него во время выполнения ({{steps.read-kg.content}}) вместо того, чтобы вставлять текст напрямую. Граница: стратегия → граф знаний; исполнительная часть → контекст воркфлоу; структура воркфлоу → сам воркфлоу. ## Семантика слияния update_step принимает три независимых операции в одном вызове. Как минимум одна должна быть непустой. - `updates` — частичное обновление шага. Поля верхнего уровня заменяются; вложенные объекты (pipelineStepPrompt, stepInputData, entryConditions, renderer и т.д.) глубоко сливаются НА ОДИН УРОВЕНЬ ВГЛУБЬ — ключи, вложенные на два уровня, перезаписываются целиком, без слияния. Массивы заменяются полностью. - `replace: string[]` — точечные пути (например, "stepInputData.fieldUpdates"), значения которых из updates присваиваются шагу ЦЕЛИКОМ, минуя глубокое слияние. Используйте для полей-словарей, где ключи — это пользовательские данные. - `unset: string[]` — точечные пути для УДАЛЕНИЯ. Каждый из них должен существовать в исходном шаге. ## Когда что использовать | Ситуация | Действие | Пример | |---|---|---| | Изменить один… | | |

Обновляет запись продукта WorkspaceUseCase по сохранённому id, key или workflowGraphId. Используйте это для прикрепления существующих workflow, агентов, рутин, AgentFiles, ссылок KG, источников данных, конфигурации, валидации, владельца, коллабораторов или статуса жизненного цикла к хабу use-case. config.onboardingGoal.approvalRequirements доступен только для чтения через внешние инструменты; редактируйте его через Use case > Safeguards. Для config.useCasePage.header используйте source pointers вместо скопированных меток: workflow analytics требуют { source: "workflow-analytics", workflowId, metricId, window }, а channels требуют { channel, workflowId, stepId }. Для config.useCasePage.body.columns сохраняйте каждую существующую колонку, задавайте целочисленные значения order для явного порядка и устанавливайте semanticRole: "company", когда колонка, похожая на company (например, Startup), должна отображаться до Status. Колонки-бейджи могут сопоставлять любое значение без учёта регистра с фиксированным семантическим цветом через valueRoles, например { type: "badge", field: "qualification", valueRoles: { ready: "success", warm: "warning" }, defaultRole: "neutral" }. Числовые колонки-оценки используют { type: "score", field, thresholds: [{ min, role }], defaultRole }; побеждает наибольшее подходящее минимальное значение. Допустимые цветовые роли: neutral, accent, warning, success и danger; никогда не храните CSS-классы в config. Платформа выводит метки/форматы метрик и режимы утверждения/провайдера каналов из этих источников; проверяйте каждый связанный workflow после обновления use case. Это обновляет только запись use-case; оно не запускает workflows, не изменяет провайдеров, не тратит кредиты и не принимает решения об утверждении. Требует доступ на запись при подключении через OAuth.

Обновляет существующий workflow. ## Рекомендуемый порядок действий для изменений агентом При пошаговом редактировании существующего workflow отдавайте предпочтение инструментам для отдельных шагов — они перехватывают ошибки на каждом этапе и позволяют избежать ловушек, связанных с массовой передачей JSON (ai / integration / knowledge_graph_query, а также тихо отбрасываемых корневых полей вроде prompt / listKey / appId): - update_step({ workflowId, stepId, updates }) — изменяет один шаг (prompt, inputs, next и т. д.). Самый безопасный и распространённый вариант. - add_step({ workflowId, step, insertAfter? }) — добавляет или вставляет новый шаг. - remove_step({ workflowId, stepId }) — удаляет шаг и переподключает соседние. - После серии правок: validate_workflow → (если опубликован) promote_draft / discard_draft. Массовый параметр updates ниже поддерживается для импорта, шаблонной перезаписи и программного обмена данными (экспорт → редактирование JSON → повторный импорт). Агентам, редактирующим в интерактивном режиме, не следует использовать его для изменения шагов — вместо этого применяйте update_step. ## Рекомендации по типу триггера Отдавайте предпочтение schedule (опрос) для приёма писем, обработки документов и любых workflow, где не требуется задержка до миллисекунд, — этот подход идемпотентен, поддерживает откат и не требует инфраструктуры вебхуков. Используйте app_event или webhook только тогда, когда пользователь явно говорит «как только», «в течение X секунд» или «в реальном времени». Если сомневаетесь — выбирайте schedule. ## Маршрутизация черновиков (опубликованные workflow) Если workflow опубликован, изменения конфигурации (шаги, контекст, название и т. д.) автоматически направляются в снимок черновика, а не изменяют работающий конвейер. Ответ будет содержать editingDraft: true. Используйте get_draft для просмотра черновика, promote_draft для публикации или discard_draft для отмены изменений. Неопубликованные workflow обновляются напрямую, при этом автоматически создаётся снимок для отката. ## Массовый параметр updates (только импорт / обмен) ⚠️ Избегайте передачи полного массива steps для больших workflow — используйте update_step. Отправка более ~20 шагов грозит молчаливым усечением на уровне транспортного протокола MCP.

Точечное редактирование workflow.context (и workflow.metadata) - аналог update_step на уровне workflow. НЕ заходит в steps (используйте для этого update_step). ## Формат вызова (предпочтительный): три явных глагола { updates, replace, unset } - та же модель слияния, что и у update_step, но для путей относительно workflow. Как минимум одно поле должно быть непустым. - `updates` - частичный патч workflow. Ключи верхнего уровня ограничены context и metadata. Каждый ключ сливается поверхностно ({ ...stored, ...patch }), поэтому пропуск соседнего ключа сохраняет его. Прямые под-объекты внутри context (например, executionInputConfig) по умолчанию всё равно заменяются целиком - используйте replace[] для явной глубокой замены, unset[] для удаления. - `replace: string[]` - точечные пути относительно workflow, значения которых из updates присваиваются ЦЕЛИКОМ, минуя глубокое слияние. Примеры путей: "context.executionInputConfig.fields", "context.inputPages", "metadata.tags". Значение по указанному пути ОБЯЗАТЕЛЬНО должно присутствовать в updates. - `unset: string[]` - точечные пути относительно workflow для удаления. Каждый путь должен существовать в workflow на момент вызова. ## Что находится в context workflow.context содержит две сущности, расположенные рядом как сестринские поля: 1. Схемы страниц - context.inputPages, context.outputPages, context.executionInputConfig. Определения полей, значения по умолчанию, shortDescriptionFields и т.д. 2. Сохранённые пользователем значения страниц - context.<contextKey>, где <contextKey> повторяет contextKey страницы. Например, context.outreachProfile, context.cadence, context.introductionWorkflow. Это значения, которые пользователь сохраняет при нажатии "Save" на странице конфигурационного ввода. ### Формы записей страниц (прочитайте это ПЕРЕД записью в context.outputPages или context.inputPages) Интерфейс workflow детали падает при загрузке, если в записи страницы отсутствуют обязательные поля, а validate_workflow теперь отклоняет некорректные формы с ошибками MISSING_OUTPUT_PAGE_FIELD / INVALID_OUTPUT_STEPS_TYPE. - `context.outputPages` - PipelineOutputPage[].…

Обновляет поля профиля компании верхнего уровня рабочего пространства. Используйте это для идентификации компании и сводной информации, такой как название, отрасль, размер, логотип, URL-адреса веб-сайтов и описание компании. Товары и услуги находятся в тексте знаний company.products, а не в этом структурированном профиле. Требует права на запись при подключении через OAuth.

Записывает исполнительное резюме на уровне рабочего пространства, отображаемое на карточке Workspace Assistant. Использует ту же сигнатуру резюме, что и исполнительные резюме кластера: тело, опциональные маркеры и опциональный автор. API записывает только Workspace.metadata.executiveSummary и сохраняет остальные ключи метаданных рабочего пространства. Требует права на запись при подключении через OAuth.

Обновляет черновик навыка, созданного в рабочей области. Опубликованные и архивированные навыки рабочей области неизменяемы с помощью этого инструмента; вместо этого архивируйте и создайте новую версию. Требует права на запись при подключении через OAuth.

Обновляет сохранённый WorkspaceView по идентификатору или ключу. Обновляет только манифест представления. Не изменяет исходные строки, не выполняет действия представления, не запускает рабочие процессы, не принимает решения об одобрении, не вызывает провайдеров и не расходует кредиты. Требует права на запись при подключении через OAuth.

Загружает файл в агента. Файлы предоставляют агенту дополнительный контекст: справочные документы, базы знаний или конфигурационные данные. - name: Имя файла (например, 'thesis.md', 'company-context.txt') - content: Сырой текст или содержимое в Markdown (максимум 400 КБ) - mime_type: MIME-тип (по умолчанию 'text/plain', для .md-файлов используйте 'text/markdown') - role: Необязательная метка, описывающая назначение файла (например, 'knowledge', 'context') Требует права на запись при подключении через OAuth.

Создаёт или обновляет внешний профиль AI-билдера, привязанный к этому аутентифицированному API-ключу. Клиентам следует вызывать это после получения scoped API-ключа; workspaceId и apiKeyId определяются на стороне сервера. Настраивает частоту опроса для билдера: опрос каждые 4 часа, когда нет активной темы, каждый час, когда есть активная тема или недавняя назначенная работа, каждые 30 минут, пока работа выполняется, и при возможности вызывает list_builder_work_items, когда уже ведётся диалог с пользователем по другой теме. Требует права на запись при подключении через OAuth.

Создаёт или обновляет строки в списке знаний. Максимум 500 строк за один вызов - разбивайте на страницы для больших наборов данных. Порядок разрешения для каждой строки: - строки с id → обновляет существующую строку по id - строки с userKey → upsert за O(1) (один и тот же userKey в одном и том же списке всегда сопоставляется с одной и той же строкой, независимо от вызовов и запусков - идеально для идемпотентных рабочих процессов извлечения и обогащения данных) - строки без того и другого → обычная вставка с новым UUID (без дедупликации) Выберите один стабильный ключ для каждой строки. userKey определяется вызывающей стороной: candidateId, нормализованный URL, домен и т.д. Любая строка, которая однозначно идентифицирует сущность в списке для вашего сценария использования. mergeStrategy управляет тем, как обновления применяются к существующим строкам: - "overwrite" (по умолчанию) - полностью заменяет существующие rowData новыми значениями - "merge" - поверхностно объединяет новые значения с существующими rowData (сохраняет поля, добавленные далее, такие как оценки или заметки) Возвращает: { inserted, updated, errors[] } - ошибки относятся к отдельным строкам и не прерывают пакетную операцию. Требует права на запись при подключении через OAuth.

Создаёт или обновляет текстовую запись знаний. Используется для хранения текста в свободной форме (заметки, промпты, описания ICP и т.д.), который можно получить по ключу.Возвращает: { key, upserted, created }. Требует права на запись при подключении через OAuth.

Валидирует определение пайплайна рабочего процесса. Возвращает структурированные ошибки для каждого шага. Используйте после создания или обновления рабочего процесса для проверки: - Отсутствующих соединений шагов (неработающие ссылки next.stepId) - Отсутствующих обязательных полей (действие приложения без входных данных, шаг ИИ без подсказки) - Недостижимых шагов (не подключены к цепочке триггера) - Неверных ID приложений/действий (не зарегистрированы в реестре приложений) - Отсутствующих шагов триггера или контрольной точки - Неправильной настройки полей списка (отсутствуют itemFields, несоответствие формата defaultValue) - Проверки полей страницы конфигурации (отсутствуют name/type в полях страницы ввода) Каждая ошибка/предупреждение может включать "suggestedFix" с конкретным исправлением. Также можно передать объект пайплайна для проверки черновика перед сохранением. Возвращает: { valid: boolean, errors: [...], warnings: [...], stepCount: number }

Проверяет, доступно ли собственное OAuth-соединение для использования без выполнения действия приложения. Возвращает только нейтральное по отношению к провайдеру состояние, безопасную метку учётной записи и временную метку checkedAt. Состояния: healthy, refresh-required, reconnect-required, missing-scope, provider-unavailable или unsupported. Используйте после list_connections, когда наличия соединения недостаточно. Используйте test_app_action только когда намеренно нужно выполнить и проверить конкретное действие приложения. Требует права на запись при подключении через OAuth.