Skip to content

Slack

The agents are driven from a single Slack channel: you @mention the bot to start work, and you Approve/Reject its results with buttons. The bot runs in Socket Mode (no public endpoint) as the syntec-slack-bot service on ava.

@mention commands

Mention the agent bot and prefix your request with the project (core or crm):

Run a task

@syntec-agents core: <what you want done>
@syntec-agents crm:  <what you want done>

The bot creates a Jira Task in the mapped project (SOC for core, SOCRM for crm), moves it to To Do, and starts a worker immediately. When the worker finishes, it posts an Approve/Reject card back to the channel.

Example:

@syntec-agents crm: add a "priority" select field (low/med/high) to the lead form

Capture UI-authored metadata (export)

@syntec-agents core: export
@syntec-agents crm:  export

Use this after you've authored metadata in the dev admin UI (e.g. core-dev.syntec-one.nl) — adding a view column, a menu item, a form field. The change is live in the dev database but not yet in git. export runs the package export and:

  • if there are changes → commits them to local dev, opens a Jira ticket straight to In Review, and posts an Approve/Reject card;
  • if there's nothing new → replies "nothing to export — dev matches the committed package."

Unlike a normal ticket, export runs no worker — it just captures what you already authored. Config/data changes (not just structure) are flagged in the card for you to review, not blocked.

The Approve / Reject buttons

Every card the bot posts carries two buttons:

Button Effect
Approve & push agent-approve pushes the ticket's local dev commits to origin/dev (per-repo write tokens), then moves the ticket to Done.
Reject agent-reject reverts the unpushed commits (the dev environment reverts too) and leaves the ticket In Review to retry or close.

Because the worker has read-only Bitbucket access and only agent-approve holds write tokens, nothing reaches origin/dev until someone clicks Approve.

Doing the same from the command line

Everything the Slack commands do is also available on ava (in syntec-one-server-installer/bin/):

bin/agent-intake <PKEY> "<request>"    # create a ticket (the @mention shortcut)
bin/agent-run <PKEY> <ISSUE>           # run the worker on a ticket
bin/export-review <project>            # the "export" command
bin/agent-approve <PKEY> <ISSUE>       # push (the Approve button)
bin/agent-reject  <PKEY> <ISSUE>       # revert (the Reject button)