Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

AgentX

AgentX connector package maintained by Flows360 CDK.

CategoryArtificial Intelligence
Authenticationcustom
Version0.1.7
Published scopes0 published scopes
Last updatedSeptember 19, 2026

Overview

AgentX

This CDK catalogue package is pinned to @activepieces/piece-agentx@0.1.7 and declares 5 declared actions and 2 declared triggers. Its definition is derived from the exact reviewed Activepieces source.

Provider runtime verification is recorded separately when an approved test connection is exercised; this catalogue entry does not claim that verification.

Technical guide

Technical reference

  • Package: @activepieces/piece-agentx@0.1.7
  • Exact artifact digest: sha256:fbffd916282c53b13d2f927f3e4a0c4d88fe19c7c8b0baf076ffec621a21c675
  • Source: the exact reviewed Activepieces source
  • Authentication, action and trigger schemas are taken from the exact pinned package.

Capability summary

Authenticationcustom
Supported objects7
Supported actions5
Triggers2

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • AgentX API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
Create Conversation With Single Agent Yes No
Send Message to Existing Conversation Yes No
Find Message Yes No
Search Agents Yes No
Find Conversation Yes No
New Agent Yes No Trigger contract validated offline; live event delivery is tracked separately.
New Conversation Yes No Trigger contract validated offline; live event delivery is tracked separately.

Supported actions

Create Conversation With Single Agent · Read

Create a new conversation with a specific Agent by ID.

create_conversation_with_single_agent · Risk: low · Retry: safe

Inputs

  • agentId · string · Required, Select an AgentX agent
  • type · string · Required, Choose the type of conversation
Send Message to Existing Conversation · Read

Send a message to an existing conversation with an agent.

send_message_to_existing_conversation · Risk: low · Retry: safe

Inputs

  • agentId · string · Required, Select an AgentX agent
  • conversationId · string · Optional, Select a conversation for the chosen Agent
  • agentMode · string · Required, Choose how the agent should respond
  • message · string · Required, The message you want to send to the agent.
  • context · number · Optional, Number of previous messages to include. 0 = as much as possible, 1 = only last message, etc.
Find Message · Read

Searches for a specific message by ID (or searches text within messages) inside a conversation.

find_message · Risk: low · Retry: safe

Inputs

  • agentId · string · Required, Select an AgentX agent
  • conversationId · string · Optional, Select a conversation for the chosen Agent
  • searchTerm · string · Optional, Text to search for in message content. Leave blank if searching by Message ID.
Search Agents · Read

Find agents by name or ID using search filters.

search_agents · Risk: low · Retry: safe

Inputs

  • name · string · Optional, Search by agent name (partial matches allowed).
  • id · string · Optional, Search by exact Agent ID.
Find Conversation · Read

Looks up an existing conversation by Agent ID (optionally by conversation ID or Name).

find_conversation · Risk: low · Retry: safe

Inputs

  • agentId · string · Required, Select an AgentX agent
  • conversationId · string · Optional, Search by exact Conversation ID.
  • conversationName · string · Optional, Search conversation by its name (derived from the first message).

Triggers

New Agent · Poll

Triggers when a new AgentX agent is created.

New Conversation · Poll

Triggers when a new conversation begins with a specific Agent. Only detects conversations created after the trigger is enabled.

Inputs

  • agentId · string

Setup

Setup

Create a tenant connection only in the consuming Studio instance when this connector is made available there. Credentials remain in that tenant's Vault-backed connection and are not stored in CDK package metadata.

Limitations

The package has passed deterministic offline package-load and contract validation. No provider credentials, provider API call or live webhook delivery is represented by this release state.

github.com