Mazaal AI Agent

This Activepieces integration allows you to incorporate Mazaal AI agents into your automation workflows.

Overview

Mazaal AI Agent integration enables you to harness the power of AI agents in your automation flows. This piece allows you to interact with Mazaal AI agents, trigger workflows based on agent responses, and automate complex tasks with AI assistance.

Authentication

To use this integration, you'll need:

1. API Key: Obtain your Mazaal AI API key from your dashboard
2. Agent ID: The unique identifier for the specific agent you want to use

Actions

Execute Agent

Runs a Mazaal AI agent with specified inputs and returns the response.

Input Parameters:

• prompt (required): The instruction or query to send to the agent
• parameters (optional): JSON object containing additional parameters for the agent
• tools (optional): Array of tools the agent should have access to
• contextData (optional): Additional context information for the agent

Output: JSON object containing the agent's response

Send Message to Agent

Sends a message to an ongoing agent conversation.

Input Parameters:

• conversationId (required): ID of the existing conversation
• message (required): The message content to send to the agent
• attachments (optional): Any file attachments to include with the message

Output: JSON object containing the agent's response

Triggers

Agent Response

Triggers when a specific agent responds with a defined pattern.

Input Parameters:

• agentId (required): ID of the agent to monitor
• pattern (optional): Pattern to match in agent responses
• maxWaitTime (optional): Maximum time to wait for a response in seconds

Example Usage

Basic Workflow

1. Trigger: When a new support ticket is created
2. Action: Execute the Mazaal AI Customer Support Agent
   • Set prompt to ticket description
   • Set contextData with customer information
3. Action: Send email with the agent's response to the customer

Ongoing Conversation

1. Trigger: When a user sends a message
2. Action: Send Message to Agent with the user's query
3. Action: Record the agent's response in the database
4. Action: Send the agent's response back to the user

Installation

If you're using the Activepieces platform:

1. Navigate to the Pieces section in your Activepieces dashboard
2. Search for "Mazaal AI Agent"
3. Click "Add" to install the integration

If you're using a self-hosted version:

npm install @activepieces/piece-mazaal-ai-agent

Building from Source

This library was generated with Nx.

Run nx build pieces-mazaal-ai-agent to build the library.

Additional Resources

• Mazaal AI Documentation
• Activepieces Documentation
• Support & Community