AgenTool Pieces for Activepieces

Custom Activepieces pieces for integrating with the AgenTool AI Assistant platform.

Features

This package provides 22 actions and 2 triggers for building AI-powered workflows:

$3

- Chat with Assistant - Send messages and get AI responses
- List Assistants - Get all your AI assistants
- Get Assistant - Get details of a specific assistant
- Create Thread - Start a new conversation
- Get Thread - Retrieve thread messages

$3

- Classify Text - Categorize text into predefined categories
- Analyze Sentiment - Detect sentiment and emotions
- Summarize Text - Generate concise summaries
- Translate Text - Translate between 20+ languages
- Detect Language - Identify text language
- Extract Entities - Find people, places, organizations, etc.
- Extract Keywords - Pull out important terms
- Detect Intent - Understand user intentions
- Question & Answer - Answer questions from context
- Rewrite Text - Transform text style (professional, casual, etc.)
- Check Guardrails - Validate content against safety rules

$3

- Generate Embeddings - Create vector embeddings for semantic search
- Compute Similarity - Calculate text similarity scores

$3

- Analyze Image - Use AI vision to understand images
- Generate Image - Create images with DALL-E

$3

- Generate Audio (TTS) - Convert text to speech
- Transcribe Audio - Convert speech to text with Whisper

$3

- New Message - Trigger on new assistant messages
- Webhook - Receive AgenTool webhook events

Installation

$3

The pieces are automatically available when running Activepieces with the AgenTool docker-compose:

``bash
docker-compose -f docker-compose.activepieces.yml up -d
`

$3

1. Clone this repository into your Activepieces pieces directory:
`bash
cd /path/to/activepieces/packages/pieces/custom
git clone https://github.com/agentool/pieces-agentool agentool
`

2. Install dependencies:
`bash
cd agentool
npm install
`

3. Build the pieces:
`bash
npm run build
`

4. Add to Activepieces environment:
`bash
AP_DEV_PIECES=@activepieces/piece-agentool
`

Authentication

$3


When running Activepieces as part of AgenTool, authentication is automatic via environment variables:
- AGENTOOL_API_URL - AgenTool API endpoint
- AGENTOOL_API_KEY - API key (auto-generated)
- TENANT_NUMBER - Multi-tenant identifier

$3

Enter your AgenTool API key when connecting the piece:
1. Go to AgenTool → Settings → API Keys
2. Generate a new key
3. Paste it in the Activepieces connection dialog

Usage Examples

$3

`
Trigger: Webhook (email received)
↓
Action: Classify Text
- Categories: ["billing", "technical", "general", "urgent"]
↓
Action: Chat with Assistant
- Use classification to route to appropriate assistant
`

$3

`
Trigger: New content posted
↓
Action: Detect Language
↓
Action: Translate Text
- Target: English, Spanish, French
↓
Action: Summarize Text
- Style: Brief
`

$3

`
Trigger: Image uploaded
↓
Action: Analyze Image
- Get description and labels
↓
Action: Generate Embeddings
- Create searchable vector
↓
Action: Chat with Assistant
- Provide context for customer queries
`

Development

$3

`bash
npm run build
`

$3

`bash
npm run watch
`

$3

`
pieces-agentool/
├── src/
│ ├── index.ts # Main piece definition
│ └── lib/
│ ├── common/
│ │ └── client.ts # AgenTool API client
│ ├── actions/
│ │ ├── chat.ts
│ │ ├── classify.ts
│ │ ├── sentiment.ts
│ │ └── ...
│ └── triggers/
│ ├── new-message.ts
│ └── webhook.ts
├── package.json
├── tsconfig.json
└── README.md
``

API Reference

All actions use the AgenTool REST API. See the AgenTool API Documentation for full details.

Support

- Documentation: https://agentool.org/docs
- Issues: https://github.com/agentool/pieces-agentool/issues
- Email: support@agentool.org

License

MIT License - see LICENSE file for details.