Lerty icon

Lerty

Interact with Lerty AI agents

Actions5

Overview

This node integrates with the Lerty AI platform to manage and interact with AI agents. Specifically, the "List Agents" operation retrieves a list of all available AI agents configured in the Lerty system. This is useful when you want to dynamically fetch and display agents for selection or further processing in your workflow.

Common scenarios include:

  • Displaying all AI agents to allow users to select one for messaging or monitoring.
  • Automating workflows that need to process or analyze multiple agents.
  • Synchronizing agent lists between Lerty and other systems.

Example: You might use this node to get all agents and then loop over them to send messages or gather status updates.

Properties

Name Meaning
Additional Fields Optional extra parameters:
- Metadata Key-value pairs to attach as metadata (not used in List Agents but available in other ops)
- Timeout Request timeout in milliseconds (default 30000 ms)

Note: For the "List Agents" operation, only the "Additional Fields" property is relevant, mainly for setting request timeout or adding metadata if applicable.

Output

The output JSON contains two main fields:

  • agents: An array of agent objects, each representing an available AI agent. Each agent object typically includes properties like id and name.
  • count: The total number of agents returned.

Example output structure:

{
  "agents": [
    {
      "id": "agent_123",
      "name": "Support Bot"
    },
    {
      "id": "agent_456",
      "name": "Sales Assistant"
    }
  ],
  "count": 2
}

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Lerty API.
  • The node uses the Lerty HTTP client utility internally to communicate with the Lerty service.
  • Network access to the Lerty API endpoint specified in the credentials is necessary.
  • Optionally, the request timeout can be configured via the "Timeout" additional field.

Troubleshooting

  • Failed to load agents: This error usually indicates invalid API credentials or network connectivity issues. Verify that the API key is correct and that the Lerty API is reachable from your environment.
  • Empty agent list: If no agents are returned, ensure that agents exist in your Lerty account and that the API user has permission to list them.
  • Timeouts: If requests time out, consider increasing the "Timeout" value in additional fields.
  • Unexpected errors: Check the node's error message for details. Enabling detailed logging or debugging may help identify issues.

Links and References

Discussion