Начать бесплатно

Все ноды/Integrations/Calendar

Календарь: инструменты агента

Инструменты CalDAV для ИИ-агента. Подключение берётся из поля «Подключение CalDAV» на самой ноде или из ноды, подключённой к порту «Подключение CalDAV».

Календарь: инструменты агентаT
Подключение CalDAVРасширение агента

Тип в графе: calendar_tool

Tool

Как попробовать

Минимальный рабочий сценарий

Вход
ИИ-агент▶▦
Календарь: инструменты агентаT
LLM▦
Вся история диалога▶S
Выход▶
  • Исполнение + данные
  • Расширение
  • LLM
  • Память
  • Исполнение + данные + стрим
Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.

Как применять

Двенадцать операций CalDAV, которые вызывает сама модель. Берите эту ноду, когда запрос формулируется словами — «что у меня завтра», «перенеси встречу на четверг», — и порядок действий заранее неизвестен. Если порядок известен, дешевле и предсказуемее цепочка обычных шагов: Запрос к календарю → Изменить событие календаря.

Как это работает

Нода не участвует в цепочке исполнения. Её выход подключается проводом link_extension в порт Расширения агента ноды ИИ-агент. Модель получает выбранные в поле «Разрешённые инструменты» операции: список календарей, запрос событий, запрос задач, пакетное получение, получение, создание или замена, изменение полей, удаление, занятость и три планирующих — приглашение, ответ, отмена.

По умолчанию включено всё, кроме планирующих. Планирование требует, чтобы в подключении был задан URL исходящих и чтобы сервер поддерживал RFC 6638 (iCloud и Google его не поддерживают); если это не так, инструменты просто не показываются модели — вместо отказа на каждом вызове.

Ошибка инструмента возвращается модели как JSON с ok: false и error_code и не останавливает запуск: модель видит причину и может исправиться сама.

Частые ошибки

  • Модель не знает, где календарь. У запросов есть обязательный аргумент calendar_url. Оставьте включённым «Список календарей» или назовите адрес коллекции в системном промпте, иначе модель будет его выдумывать.
  • Запись включена по умолчанию. Создание, изменение и удаление событий входят в набор по умолчанию. Агенту, который должен только читать, снимите эти три галочки.
  • Галочка планирования сама по себе ничего не включает. Без URL исходящих в интеграции инструмент останется скрытым, сколько его ни отмечай.
  • ETag живёт внутри хода. Создание и изменение возвращают модели новый etag; прежний после записи недействителен, и повторное использование даёт отказ сервера.
  • Две календарные ноды на одном агенте. Имена инструментов фиксированы, поэтому вторая нода объявит те же имена, что и первая. Два календаря — это два разных агента.
  • Нода без агента ничего не делает. Не подключённая к порту Расширения агента, она остаётся просто настройкой на холсте.

Входы

ПортПроводДанныеПримечания
Подключение CalDAVcalendar_storeДанныеdata—

обязателен

Выходы

ПортПроводДанныеПримечания
Расширение агентаtool_outРасширениеlink_extension—

Настройки

ПолеТипПо умолчаниюОписание
Подключение CalDAVconnection_idstring""

Сохранённое подключение CalDAV из пространства: простому календарному сценарию не нужна отдельная нода «Календарь: подключение CalDAV». Нода, подключённая к порту «Подключение CalDAV», имеет приоритет над этим полем.

подключение: caldavперекрывается портом: calendar_store

Разрешённые инструментыenabled_toolsarray<string>["cal_list_calendars","cal_query_events","cal_query_todos","cal_multiget_even…

Какие операции CalDAV может вызывать модель. Планирование (приглашение/ответ/отмена) выключено по умолчанию: ему нужны подключение с планирующим outbox и провайдер с поддержкой RFC 6638. Если включить его на подключении без того и другого, инструменты просто не будут показаны модели, а не станут падать на каждом вызове.

Готовые примеры с этой нодой