Skip to main content

Agents

Configure AI agents and their capabilities. Agents are the AI entities that power chat interactions, flow execution, and other intelligent features in Hublvu.

Understanding Agents​

Hublvu has built-in AI agents, each designed for specific purposes:

AgentPurpose
Chat AgentInteractive conversational assistant for questions and tasks
Flow AgentExecutes agentic flows for diagnosis and remediation
Guide AgentRuns step-by-step guides
Insight AgentCreates and manages data explorations
Assistant AgentProvides help and documentation guidance

These are built-in agents with configurable settings—not user-created.

Custom Agents​

Custom agents extend the chat interface with specialized capabilities.

Why Create Custom Agents​

  • Add new skills — Give chat access to new capabilities
  • Wrap guides — Make guides accessible through natural conversation
  • Specialize responses — Create agents focused on specific domains
  • Control access — Limit what different user groups can do

Creating Custom Agents​

  1. Go to Agent Management
  2. Click New Custom Agent
  3. Configure:
    • Name — What users will call this agent
    • Description — What this agent does
    • Trigger phrases — How users invoke it
    • Guide — The guide this agent executes
    • Tools — Which tools the agent can access
  4. Save

Guide-Wrapped Agents​

A powerful pattern: wrap a guide around a custom agent.

  1. Create a guide with the steps your agent should perform
  2. Configure tool access for each step
  3. Create a custom agent that uses this guide
  4. Users invoke the agent through conversation

Example: Create a "Network Admin" agent with a guide for network tasks. Users can say "check connectivity to server X" and the agent runs the appropriate steps.

Agent Configuration​

For each agent, configure:

SettingDescription
EnabledWhether the agent is available
Trigger PhrasesWords/phrases that invoke this agent
Guide AssociationWhich guide the agent executes
Tool AccessWhich tools the agent can use
Input VariablesParameters the agent accepts
Output VariablesWhat the agent returns

Tool Assignment​

Control which tools agents can access.

Why Tool Assignment Matters​

  • Security — Limit tools to those needed for the agent's purpose
  • Focus — Prevent agents from using irrelevant tools
  • Compliance — Ensure agents only access approved systems

Configuring Tool Access​

  1. Open an agent's configuration
  2. Go to Tools tab
  3. Enable/disable specific tools or tool categories
  4. Set operation permissions
  5. Save

Tool Operations​

Tools have different operation types:

OperationDescriptionRisk
READ_DATARead informationLow
WRITE_DATACreate or modify dataMedium
EXECUTE_QUERIESRun queriesMedium
READ_LOGSAccess logsLow
DELETE_DATARemove dataHigh
ADMIN_SYSTEMAdministrative actionsHigh

Assign only the operations each agent needs.

Agent Security​

Permission Checks​

When a user interacts with an agent:

  1. User can use agent — Is this agent available to their group?
  2. Agent can use tool — Is the tool in the agent's allowed list?
  3. User can perform operation — Does the user's group allow the operation?

All three checks must pass.

Group-Based Access​

Control which user groups can access which agents:

  1. Go to Group Management
  2. Select a group
  3. Go to Agent Access tab
  4. Enable/disable agents for this group
  5. Save

Audit Trail​

All agent interactions are logged:

  • Who used the agent
  • What was requested
  • Which tools were executed
  • What results were returned

View in Audit Logs.

Best Practices​

Start Restrictive

Begin with minimal tool access and add more as needed. It's easier to grant access than to revoke it.

Use Descriptive Names

Name custom agents after their function: "Database Admin", "Network Troubleshooter", "Deployment Helper".

Test Before Enabling

Test custom agents with sample requests before making them available to users.

Document Trigger Phrases

Make sure users know how to invoke custom agents. Document trigger phrases in your team's guides.