AtlasCustomer portalAPI DocumentationGo to Atlas
Help Center›Zeus AI› Zeus AI: Agent Setup›Learn about blocks in Zeus AI native tools

Learn about blocks in Zeus AI native tools

Last updated October 23, 2026

Who can use this feature?
Admins and Agents can view and edit. Viewers can't open Zeus AI.
Zeus AI is a paid add-on available for any Atlas plan.

Overview

Blocks are the steps of a Zeus AI native tool. Every tool starts with a start block, and you add branching, workflow and return blocks to build the flow.

Related articles:
•  How to manage Zeus AI Tools: Create, publish and manage tools.
•  Learn about key components in Zeus AI native tools: Blocks, connections and branches.
•  How to configure organization settings and business hours: Set the hours the "By business hours" block uses.

How to use blocks in a native tool

Start block

Every new tool includes a start block, added automatically with the first setup. It's the entry point of the flow, so connect it to the rest of your blocks.

The start block

The start block.

Click "Edit settings" on the block to open the "Tool setup" panel, which shows the configuration you entered when you created the tool.

The "Tool setup" panel

The "Tool setup" panel.

Branching blocks

Route Zeus AI conversations based on custom logic and rules.

Branching blocks in the block menu

Branching blocks in the block menu.

By business hoursCode branching

Adds two branches to your flow: one followed "During business hours" and one "Outside business hours". Click "Set up business hours" to adjust your hours.

The "By business hours" blockThe "By business hours" block

Use it to handle support one way during the day and another way at night.

Important:
The "Code branching" block may not be available in all cases. Contact Support if you have questions about availability.

Write custom JavaScript to decide which path the tool takes next, for example based on user data or conversation history.

  • context and customer: The inputs, with data about the current conversation and the customer.
  • return "BranchLabel": The decision. The text your code returns decides which output Zeus AI follows.
  • Outputs: Your custom branches, one per value your code can return.
  • Error branch: Followed if the code fails, for example because of a typo or a temporary glitch, so the tool never freezes.

For example, if your code checks a customer's VIP status and returns "VIP_1", route them to the "VIP_1" output (a premium support path).

  1. Click "Edit configuration" and edit the "Code".
  2. Click "Add Output" for each value your code can return. Each output becomes a branch.
  3. Click "Confirm".

Code branching configuration with outputsCode branching configuration with outputs

Workflow blocks

Insert custom code or connect to APIs as steps in the tool's flow.

Workflow blocks in the block menu

Workflow blocks in the block menu.

CodeAPI
Important:
The "Code" block may not be available in all cases. Contact Support if you have questions about availability.

Runs custom JavaScript during a Zeus AI conversation, for example to perform calculations, change variables, format data or run logic no other block offers. The code can use the workflow data, such as the conversation, customer or context.

  • If the code succeeds: The flow continues through the first branch.
  • If the code fails: The flow continues through the second branch.

The Code blockThe Code block

Click "Edit configuration", edit the code, then click "Confirm".

Editing the Code blockEditing the Code block

Important:
The "API" block may not be available in all cases. Contact Support if you have questions about availability.

Sends or retrieves information from another system, for example to check an order status, look up customer information or send data to another system.

The API blockThe API block

  • Configure: Opens the configuration of the API request. Configure a new API, select an existing one, or click "Edit API template" to change the HTTP method (GET, POST and so on), headers and payload. You can select any API created through "{ } New API Call...".
  • Input variables: The information the API needs, for example an Order ID. In "Value", enter the value or variable from your flow to send.
  • Output variables: In "Expression", isolate the piece of data you want from the response (usually with JSONPath, for example $.body.customer.name). In "Variable", name the container that stores it, so you can use it in later messages. Click "+ Add" to save several fields from one call, such as a tracking number and a delivery date.
  • If the action succeeds: The API returned a successful response, such as 200 OK, and the flow continues through the success branch with the output variables available.
  • If the action fails: The flow continues through the failure branch instead of stopping. For example, ask the user to try again later, retry the request or route the conversation to a human agent.

Return blocks

Pass the final output back to Zeus AI to complete the tool.

Return blocks in the block menu

Return blocks in the block menu.

Tool result

The "Tool result" block is the end point of your tool flow. It passes formatted text, variables or status responses back to Zeus AI, which uses them to respond to the customer or complete its action.

The "Tool result" block

The "Tool result" block.

  1. Click "Edit" or double-click the block.
  2. In "Return text", enter the message the tool returns. You can combine plain text with flow variables, such as {{workflow_input.email_id}} or {{context.expected_date}}.
  3. Click "Save".

Was this article helpful?