Integrate with a Hermes agent and configure scheduled tasks -

AI Task Scheduling supports intelligent task scheduling through a Hermes agent. It handles network connections and traffic configuration automatically, requiring no additional operations from you. This topic describes the complete workflow of integrating a Hermes agent through ACS Sandbox or manual entry, creating a scheduled task, and verifying task execution results.

Overview

AI Task Scheduling supports intelligent task scheduling through a Hermes agent. When your Hermes is deployed in the Alibaba Cloud internal network, AI Task Scheduling establishes a private network connection with your VPC. When Hermes is deployed on the public network, AI Task Scheduling accesses your agent directly through the public network. All network configuration and traffic costs are covered by AI Task Scheduling, and you do not need to configure any network settings.

Note

This topic describes the complete workflow of integrating a Hermes agent and configuring scheduled tasks through the AI Task Scheduling platform.

Prerequisites

AI Task Scheduling is activated and a workspace is created.
Container Compute Service (ACS) is activated, and a cluster that uses ACS Sandbox as the runtime is created.

Step 1: Integrate with a Hermes agent

Enter the workspace. On the Agent Management page, click Connect Agent and select the Hermes Agent type.

Two integration methods are supported: ACS Sandbox and Manual Entry. Choose the method that suits your situation.

Method 1: Integrate through ACS Sandbox

Prerequisites:

Agent Sandbox is activated.
The Sandbox component is installed in the corresponding ACS cluster.

To integrate a Hermes agent, complete the following configurations in order:

Basic Information: Enter the basic information of the agent, such as the name and description.
Integration Method and Network: Select the ACS Sandbox integration method and enter the following network parameters to establish a private network connection between AI Task Scheduling and your VPC:
- VPC ID: The ID of your VPC instance.
- vSwitch: Select a vSwitch.
- Security Group: Select a security group.
Resource Configuration: Configure the ACS resource parameters:
- ACS Cluster: Select the ACS cluster that you have created.
- Namespace: Select or enter a namespace.
- Node Specification: Select a node specification.
Authentication:
- Gateway Token: Enter the API Server Key of the Hermes agent that you configured in the prerequisites.
- Model Provider: Select a model provider.
- Name: Enter the model name.
- API Key: Enter the model API key.
Monitoring and Elasticity:
- You can optionally enable OpenTelemetry tracing.
- You can optionally enable Sandbox Auto Scaling.

After the configuration is complete, click OK to complete the Hermes agent integration.

Method 2: Integrate through manual entry

Prerequisites: The Hermes Agent API Server is manually deployed and started. For the deployment commands, see the appendix at the end of this topic.

Enter the workspace. On the Agent Management page, click Connect Agent and select the Hermes Agent type.

Configure the following parameters:

Network Connection: Select Public Network or Private Network to connect to the self-deployed Hermes agent.
- If you select Private Network, you must enter the VPC ID, vSwitch, and security group.
Executor Address: Enter the API access address of the agent. Format requirements:
- The address must start with http:// or https://.
- Domain names or IP addresses are supported, for example, http://192.168.0.1:18789.
Gateway Token: Enter the API Server Key of the Hermes agent.

After all parameters are configured, click OK to complete the Hermes agent integration.

Step 2: Create a Hermes agent scheduled task

On the Task Management page, click Create Task and select the corresponding agent.

Enter the task configuration:

Basic Information:
- Task Name: Enter a custom task name.
- Prompt: Describe the work that you want the agent to perform, for example, "Generate a daily order summary report at 9 AM every day".
- Session (Session Mode):
  - Task Isolation: Each run executes in a newly created isolated session. The session contexts of different runs are isolated from each other.
  - Specified Session: Runs in a specified session and shares context with the specified session.
Advanced Configuration: Configure advanced parameters as needed.
Schedule Configuration: Set the scheduling cycle and trigger time of the task.
Notification Configuration: Configure the notification methods and conditions for task execution results.

After the configuration is complete, click OK to create the task.

Step 3: Verify task execution

On the Task Management page, find the task that you created and click Run Once to perform a manual test.

After the execution is complete:

Click Execution Records to view the execution history of the task.
Click Logs to view the streaming output log of the current execution.
Click the icon next to the task status to view the complete output.
On the Agent Management page, click the Monitor icon, or go to the Monitor Center page to view the monitoring data of the current agent.

The task scheduling is now configured. The agent will run automatically according to the defined schedule.

Appendix: Manually deploy Hermes Agent API Server

If you select Manual Entry to integrate a Hermes agent, you must deploy and start the Hermes Agent API Server by yourself. Use the following commands to complete the configuration:

# Enable api_server
hermes config set platforms.api_server.enabled true

# Configure api_server access token (customize or generate with: openssl rand -hex 32)
hermes config set platforms.api_server.extra.key "{access_token}"

# Configure api_server listen address
hermes config set platforms.api_server.extra.host 0.0.0.0

# Start api_server (convert to background process as needed)
hermes gateway run