Skip to main content

Overview

An agent is an asset that connects tools and actors to an AI language model (LLM) to process requests. It invokes registered capabilities as needed and incorporates their results into its response.

Open agent management from Agents in the sidebar's AI section. The same section also contains Tools, Actors, Prompts, and Semantic Layer. You can also expand the agent's collection in Collection Explorer and select the Agent item.

Components

ComponentDescription
AgentInvokes capabilities in response to an input request. Configure it in AI Agent or Workflow mode.
ToolRuns search, calculation, REST calls, or custom code.
ActorA Python function-like execution unit that an agent invokes. It can require human approval before execution.
PromptStores system instructions for reuse across multiple agents.
Semantic LayerManages semantic tables, value dictionaries, and query templates for natural-language queries.

An agent uses one of two execution modes. Select the mode in the creation dialog; it cannot be changed after creation.

  • AI Agent: The LLM selects tools based on the request and uses tool results as input to the next processing step. This repeated execution pattern is called ReAct and is used in chat.
  • Workflow: Connects steps, conditions, and branches in a graph. A workflow runs only through events and does not appear in chat.

List screen

Agent list showing Draft and Running states and the Owner column

Use the agent list page to perform the following tasks.

  • Search and filter: Search by name, alias, or description. Use the status count filters (All / Running / Stopped / Draft) to select which states to display.
  • Alias-first display: Lists and confirmation dialogs show the alias first. Creation and deletion dialogs that require the exact system name also show that name.
  • Owner column: Shows the owner's name and a hover preview.
  • Check status: Each agent's deployment status appears as a Draft / Running / Stopped badge.
  • Actions:
    • Edit: Open the agent builder.
    • Deploy / Undeploy: Make the agent executable or stop it.
    • Chat: Start a saved conversation (session) with a deployed AI agent. This action is disabled before deployment and displays “Available after deployment.”
    • Delete: Remove an agent that is no longer in use.

Chat and preview

There are two distinct surfaces for interacting with a deployed AI agent.

  • Chat (select Chat in the list): A real chat whose conversation is saved as a session. The header displays Saved · Session history.
  • Preview (right panel in the builder): A temporary conversation that is not saved, used to test behavior while editing. The header displays Temporary · Not saved. Select Open in chat to start a new, saved conversation in the real chat.

Chat and Preview show tool-call results in execution order. Tool names, inputs, and outputs are available in tooltips or cards.

Relationship to D.Hub Assistant

The D.Hub Assistant side panel operates separately from user-created agents. There is no setting that connects a deployed agent to D.Hub Assistant.

Workflow agents do not have chat

Workflow agents support event execution only and do not appear in chat. Opening a chat URL directly redirects to the builder. See Workflow agents and chat for behavior by surface.

Human approval (HITL)

When an actor's confirmation policy is set to Confirm, an approval request card appears before execution. Select Approve or Reject, and optionally enter a reason when rejecting. This approval pattern is called Human-in-the-Loop (HITL).

PolicyTechnical identifier
Automaticauto
Confirmconfirm
Denydeny

See Create and edit tools and actors for configuration instructions.