ZBrain Documentation
  • ZBrain Documentation
    • Components of ZBrain
    • Getting started with ZBrain
    • 📚Knowledge base
      • How to create a knowledge base?
      • Knowledge source
      • Information schema
      • File summary
      • Automated reasoning
      • Retrieval testing
      • Knowledge base settings
    • 📱APP
      • How to create a new app?
      • How to set up and customize your app?
      • How to access the app reporting dashboard?
    • 🤖ZBrain AI agents
      • Get started with agents on ZBrain
      • Deploying pre-built agents
      • Creating custom AI agents
        • Agent setup
        • Define input sources
        • Define Flow
          • Key elements of a Flow
          • Flow Components
            • Activepieces Platform
            • AITable
            • Airtable
            • Amazon S3
            • Amazon SNS
            • Amazon SQS
            • Amazon Textract
            • Apify
            • Apollo
            • Approval
            • Asana
            • Azure Communication Services
            • Azure Cosmos DB
            • Azure Document Intelligence
            • Azure OpenAI
            • Azure Translation
            • Bannerbear
            • Baserow
            • Beamer
            • Bedrock Claude
            • Bettermode
            • Binance
            • Bing Search
            • Blackbaud
            • Bonjoro
            • Box
            • Brevo
            • Brilliant Directories
            • Bubble
            • CSV
            • Calendly
            • Certopus
            • Clearout
            • Clockodo
            • Code
            • Confluence
            • Connections
            • Constant Contact
            • Contiguity
            • Contentful
            • Customer.io
            • Crypto
            • Databricks
            • Data Mapper
            • Date Helper
            • DeepL
            • Delay
            • Discord
            • Discourse
            • Drip
            • Dropbox
            • Dust
            • Facebook Pages
            • Figma
            • Files Helper
            • Flowise
            • Flowlu
            • Formbricks
            • Frame
            • Freshdesk
            • Freshsales
            • GCloud Pub/Sub
            • GenerateBanners
            • GhostCMS
            • GitHub
            • GitLab
            • Gmail
            • Google Calendar
            • Google Contacts
            • Google Docs
            • Google Drive
            • Google Forms
            • Google Gemini
            • Google My Business
            • Google Search
            • Google Search Console
            • Google Sheets
            • Google Tasks
            • Groq
            • Hacker News
            • Heartbeat
            • HubSpot
            • HTTP
            • Image Helper
            • Inputs
            • Instagram for Business
            • Intercom
            • Invoice Ninja
            • Jira Cloud
            • Jotform
            • Kimai
            • Kizeo Forms
            • LeadConnector
            • Line Bot
            • Linear
            • LinkedIn
            • LinkedIn Actions
            • LLMRails
            • Lusha
            • MailerLite
            • Mailchimp
            • Mautic
            • Microsoft Dynamics 365 Business Central
            • Microsoft Dynamics CRM
            • Microsoft Excel 365
            • Microsoft OneDrive
            • Microsoft Outlook Calendar
            • Microsoft Teams
            • Mixpanel
            • MongoDB
            • Notion
            • Odoo
            • OpenAI
            • OpenRouter
            • Pastebin
            • PDF
            • Postgres
            • PostHog
            • Pushover
            • Qdrant
            • Queue
            • Razorpay
            • Router
            • Salesforce
            • SendGrid
            • ServiceNow
            • SFTP
            • SharePoint
            • Slack
            • SMTP
            • Snowflake
            • SOAP
            • Spotify
            • Stability AI
            • Stable Diffusion Web UI
            • Storage
            • Stripe
            • SurrealDB
            • SurveyMonkey
            • Taskade
            • Telegram Bot
            • Text Helper
            • Trello
            • Twilio
            • Twitter
            • Utilities
            • WhatsApp Business
            • WordPress
            • XML
            • YouTube
            • ZBrain
            • Zendesk
            • ZeroBounce
            • Zoho Books
            • Zoho CRM
            • Zoho Invoice
            • Zoom
          • How to Define a Flow?
          • How to Test Each Step in the Flow?
        • Configure Additional Settings
        • Test and Deploy Agents
        • How to access, monitor, and manage agent performance and tasks?
    • Settings
    • 📖API Tutorials
      • 📚Knowledge base
        • Automated Reasoning
      • 📱APP
      • 🤖Agents
Powered by GitBook
On this page
  • Accessing agents
  • Accessing the reporting dashboard
  • Tracking activity and viewing session logs
  • Monitor task status
  • Queue management
  • View detailed agent performance
  • Review Flows
  1. ZBrain Documentation
  2. ZBrain AI agents
  3. Creating custom AI agents

How to access, monitor, and manage agent performance and tasks?

PreviousTest and Deploy AgentsNextSettings

Last updated 5 days ago

To ensure your agents operate smoothly and efficiently, it is essential to access, track, and manage their performance and tasks effectively. Here is a step-by-step guide on how to monitor task status, view detailed logs, filter and review tasks, and assess agent performance.

Accessing agents

You can access all the agents you have created via the Agents Page. Here, you will find key details such as:

  • Agent ID: Unique identifier for each agent.

  • Agent name: The name of the agent.

  • Accuracy: The performance accuracy of the agent.

  • Action required: Any actions that need attention.

  • Tasks completed: The total number of tasks successfully processed by the agent.

  • Last task executed: The date and time the agent most recently completed a task.

  • Status: Whether the agent is active or in draft mode.

By reviewing these fields regularly, you can keep track of each agent's performance and ensure any necessary interventions are made promptly.

Accessing the reporting dashboard

The reporting dashboard provides in-depth insights into an agent’s activity and performance. To access the dashboard for a specific ZBrain Agent, follow these steps:

  1. Navigate to the agents tab: In the top navigation bar, click on the Agents tab to view the list of agents.

  2. Select the agent: Find and select the agent you want to analyze. You can search for it by name or filter based on specific criteria.

  3. Click on the agent name: This action will open the agent’s execution interface, where you will see several sections:

    • Queue: Displays tasks that the agent is currently processing or has completed.

    • Input: Shows the input data that the agent is processing.

    • Report: Provides detailed reports on task execution.

    • Activity: Displays the agent’s activity logs, including step-by-step execution details.

Uploading new files

To add new tasks or documents for the agent to process, click the ‘Upload’ button in the Input section. This allows you to upload files directly from your system, enabling the agent to begin processing them.

Viewing queued or processed documents

You can view the queued or processed documents by searching through the documents in the relevant sections of the dashboard. The system will allow you to filter and view documents based on their status.

Accessing detailed processing reports

Detailed processing reports are available for review directly from the Report section. These reports can be downloaded or copied to review results or share them with team members for further evaluation.

Provide feedback on task results

If the results of a task do not meet your expectations, you can provide feedback directly through the dashboard to help improve the agent’s performance over time.

Thumbs down button: If a task does not meet the desired standards or fails to produce accurate results, you can give a thumbs down to indicate dissatisfaction. This feedback helps refine and optimize the agent’s performance for future tasks.

Tracking activity and viewing session logs

To gain deeper insight into how the agent is processing tasks, you can view the session logs by expanding the Agent Activity section. This will provide you with detailed information about each step in the agent’s execution process:

  • Input data: Understand what data the agent has processed, including the format and type of documents it is handling.

  • Output data: See what results or outputs the agent has generated after processing the input.

  • Step-by-step overview: A breakdown of each step during task execution, including:

  • Status of the step: Whether the step was successfully completed, failed, or skipped.

  • Input: Data the agent received at each step.

  • Time taken: The total duration the agent took to complete a specific step.

  • Output: What the agent produced after each processing step.

Reviewing these logs allows you to see exactly how the agent processes tasks, helping you identify areas for improvement or optimization.

Monitor task status

On the Agent Dashboard, you will see indicators that represent the status of each task in real-time. These indicators help you quickly assess whether your agent’s tasks are progressing as expected:

  • Green dot: Indicates that the task has been successfully completed without any issues.

  • Yellow dot: Signifies that the task is pending and awaiting processing. This may happen if there’s a queue of tasks or a delay in processing.

  • Red dot: Shows that the task has failed, indicating that there were issues with processing, such as errors or system failures.

Monitoring task statuses in real-time helps ensure you are aware of any issues and can take corrective action promptly.

Queue management

Managing the document pipeline effectively is crucial for optimizing agent performance. Use the filter and sort tasks by their status:

Task status filters:

  • Show all: Displays all tasks regardless of their status.

  • Processing: Tasks that are actively being executed by the agent.

  • Pending: Tasks that are waiting for the agent to start processing.

  • Completed: Tasks that have been successfully finished by the agent.

  • Failed: Tasks that encountered errors and were not completed successfully.

You can apply filters by clicking on the filter icon, and the filtered tasks will appear on the right side of the screen for quick review and management. This feature makes it easier to track the progress of specific tasks and manage your workflow efficiently.

View detailed agent performance

The Performance section of the agent’s dashboard provides detailed metrics on how well the agent is performing over a specific period:

Summary metrics

  • Utilized time: The total amount of time the agent has been actively processing tasks.

  • Average session time: This metric shows the average duration it takes for the agent to process a task.

  • Satisfaction score: An average score reflecting the quality of the tasks performed by the agent. This score could be based on user feedback.

  • Token used: The total number of tokens consumed by the agent during its tasks. This also provides an estimate of the associated processing costs.

Session details

A detailed breakdown of each task processed by the agent is provided. Key columns include:

  • SessionID: Unique identifier for the processing session.

  • Record name: The name or identifier for the specific task processed.

  • Session start date: When the processing of the task began.

  • Session end date: When the processing concluded.

  • Session time: The total duration of the task.

  • Satisfaction score: The rating assigned to the task.

  • Token used: Tokens consumed during the session.

  • Cost: Estimated cost associated with processing the task.

This information helps you assess agent performance at a granular level.

Review Flows

The All Flows page allows you to evaluate the specific workflows (flows) and triggers used by the agent during task execution:

  • Flow name: Each workflow the agent uses is identified by name.

  • Flow status: Displays the current status of the flow, such as active or draft.

  • Updated: Shows the last date and time the flow was modified.

Reviewing flows helps you understand how the agent’s processes are structured and whether they are optimized for efficiency.

By regularly accessing, monitoring, and managing your agent's tasks, performance, and flows, you can ensure smooth operations, optimize efficiency, and make data-driven adjustments for continuous improvement. This proactive approach helps maintain high performance and enables seamless workflow automation.

🤖