bitrix-background-jobs

Orchestrate Bitrix background tasks across CAgent, addBackgroundJob, and Messenger queues.

33|3|Updated Jun 5, 2025
One-click install
npx skills add https://github.com/bxmaximum/bitrix_ai_challenge --skill bitrix-background-jobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bitrix-background-jobs
Source: https://github.com/bxmaximum/bitrix_ai_challenge/tree/main/.agents/skills/bitrix-background-jobs
Command: npx skills add https://github.com/bxmaximum/bitrix_ai_challenge --skill bitrix-background-jobs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bitrix development often requires reliable scheduling and asynchronous processing. This skill covers three mechanisms for deferred work: CAgent (cron-like agents), Application::addBackgroundJob() for short-lived post-response tasks, and Messenger queues for reliable, scalable processing. It guides when to use each mechanism and how to implement robust scheduling, error handling, and retry strategies.

Core Features & Use Cases

  • Understand when to use CAgent, addBackgroundJob, and Messenger for background work.
  • Implement cron-like tasks with CAgent and proper next_run management.
  • Design reliable, asynchronous processing with Messenger, including dispatch, consumption, and retries.

Quick Start

Configure and run a Bitrix background task using CAgent, addBackgroundJob, or Messenger queues.

Frequently Asked Questions about bitrix-background-jobs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule cron-like background tasks in Bitrix?

To schedule cron-like background tasks in Bitrix, use the CAgent mechanism. This skill guides correct CAgent implementation, including proper next_run management, reliable registration, and safe cleanup procedures for recurring agents.

What is the best way to handle deferred processing after a Bitrix HTTP response?

The best way to handle deferred processing after a Bitrix HTTP response is Application::addBackgroundJob(). This skill enforces safe usage patterns for short-lived post-response tasks to ensure they execute reliably without blocking the user experience.

When should I use Messenger queues over addBackgroundJob in Bitrix?

Use Bitrix Messenger queues over addBackgroundJob for long-running asynchronous workflows requiring scalable processing. This skill guides when to use each mechanism, implementing Messenger with reliable dispatch, consumption, retries, and logging.

How do I implement retries and error handling for Bitrix background jobs?

Implement retries and error handling for Bitrix background jobs using Messenger queues. This skill provides patterns for reliable message handling, ensuring scalable asynchronous processing includes robust retry strategies and proper logging.

Can I run long-running asynchronous workflows within Bitrix-based projects?

Yes, you can run long-running asynchronous workflows within Bitrix-based projects using Messenger queues. This skill orchestrates reliable message handling, including safe dispatch, consumption, and retries for scalable processing.