@skillful-ai/piece-skillful-agents 0.0.12 โ 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +9 -28
- package/src/index.d.ts +1 -1
- package/src/index.js.map +1 -1
- package/src/lib/actions/run-agent.d.ts +1 -1
- package/src/lib/actions/run-agent.js +1 -0
- package/src/lib/actions/run-agent.js.map +1 -1
- package/src/lib/common.js.map +1 -1
- package/src/lib/types.js.map +1 -1
- package/README.md +0 -173
package/package.json
CHANGED
|
@@ -1,36 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@skillful-ai/piece-skillful-agents",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"type": "commonjs",
|
|
5
|
-
"main": "./src/index.js",
|
|
6
|
-
"types": "./src/index.d.ts",
|
|
5
|
+
"main": "./dist/src/index.js",
|
|
6
|
+
"types": "./dist/src/index.d.ts",
|
|
7
7
|
"dependencies": {
|
|
8
|
-
"@activepieces/pieces-framework": "
|
|
9
|
-
"@sinclair/typebox": "0.34.11",
|
|
8
|
+
"@activepieces/pieces-framework": "workspace:*",
|
|
10
9
|
"@skillful-ai/skai-sdk": "*",
|
|
11
|
-
"axios": "1.8.3",
|
|
12
|
-
"axios-retry": "4.4.1",
|
|
13
|
-
"deepmerge-ts": "7.1.0",
|
|
14
|
-
"fastify": "5.4.0",
|
|
15
|
-
"mime-types": "2.1.35",
|
|
16
|
-
"nanoid": "3.3.8",
|
|
17
|
-
"semver": "7.6.0",
|
|
18
10
|
"tslib": "^2.3.0",
|
|
19
|
-
"
|
|
20
|
-
"@activepieces/
|
|
21
|
-
"@activepieces/shared": "0.22.0"
|
|
11
|
+
"@activepieces/pieces-common": "workspace:*",
|
|
12
|
+
"@activepieces/shared": "workspace:*"
|
|
22
13
|
},
|
|
23
|
-
"
|
|
24
|
-
"
|
|
25
|
-
"@notionhq/client": "$@notionhq/client"
|
|
26
|
-
},
|
|
27
|
-
"vite": {
|
|
28
|
-
"rollup": "npm:@rollup/wasm-node"
|
|
29
|
-
},
|
|
30
|
-
"undici": "6.19.8"
|
|
31
|
-
},
|
|
32
|
-
"resolutions": {
|
|
33
|
-
"rollup": "npm:@rollup/wasm-node",
|
|
34
|
-
"undici": "6.19.8"
|
|
14
|
+
"scripts": {
|
|
15
|
+
"build": "tsc -p tsconfig.lib.json ; cp package.json dist/"
|
|
35
16
|
}
|
|
36
|
-
}
|
|
17
|
+
}
|
package/src/index.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const skillfulAgents: import("@activepieces/pieces-framework").Piece<
|
|
1
|
+
export declare const skillfulAgents: import("@activepieces/pieces-framework").Piece<undefined>;
|
package/src/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,qEAAwE;AACxE,iDAAqD;AACrD,uDAAmD;AAEtC,QAAA,cAAc,GAAG,IAAA,8BAAW,EAAC;IACxC,WAAW,EAAE,iBAAiB;IAC9B,IAAI,EAAE,4BAAS,CAAC,IAAI,EAAE;IACtB,uBAAuB,EAAE,QAAQ;IACjC,OAAO,EAAE,2CAA2C;IACpD,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,WAAW,EAAE,qFAAqF;IAClG,OAAO,EAAE;QACP,oBAAQ;KACT;IACD,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,CAAC,sBAAa,CAAC,YAAY,CAAC;CACzC,CAAC,CAAC"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export declare const runAgent: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").PieceAuthProperty, {
|
|
2
|
-
agentId: import("@activepieces/pieces-framework").DropdownProperty<string, true>;
|
|
2
|
+
agentId: import("@activepieces/pieces-framework").DropdownProperty<string, true, undefined>;
|
|
3
3
|
message: import("@activepieces/pieces-framework").LongTextProperty<true>;
|
|
4
4
|
testMode: import("@activepieces/pieces-framework").CheckboxProperty<false>;
|
|
5
5
|
organizationId: import("@activepieces/pieces-framework").ShortTextProperty<false>;
|
|
@@ -25,6 +25,7 @@ exports.runAgent = (0, pieces_framework_1.createAction)({
|
|
|
25
25
|
agentId: pieces_framework_1.Property.Dropdown({
|
|
26
26
|
displayName: 'Skillful Agent',
|
|
27
27
|
description: 'Select the Skillful agent to run',
|
|
28
|
+
auth: pieces_framework_1.PieceAuth.None(),
|
|
28
29
|
required: true,
|
|
29
30
|
refreshers: [],
|
|
30
31
|
options: (_auth, ctx) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-agent.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"run-agent.js","sourceRoot":"","sources":["../../../../src/lib/actions/run-agent.ts"],"names":[],"mappings":"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"}
|
package/src/lib/common.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"common.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/lib/common.ts"],"names":[],"mappings":"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"}
|
package/src/lib/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
|
package/README.md
DELETED
|
@@ -1,173 +0,0 @@
|
|
|
1
|
-
# Skillful Agents Piece
|
|
2
|
-
|
|
3
|
-
Interact with Skillful AI agents for advanced conversational AI and task automation. This piece provides seamless integration with the SKAI Agents platform through Activepieces, allowing you to send messages to your Skillful agents directly from your workflows.
|
|
4
|
-
|
|
5
|
-
## ๐ฏ Features
|
|
6
|
-
|
|
7
|
-
- **Send Messages to Agents**: Send messages to Skillful agents and receive intelligent responses
|
|
8
|
-
- **Agent Selection**: Choose from your available Skillful agents via dropdown
|
|
9
|
-
- **Test Mode**: Test agents without consuming your usage allowance
|
|
10
|
-
- **Server-side Authentication**: Secure API key management handled by Activepieces
|
|
11
|
-
- **Flow Builder Integration**: Skillful agents appear directly in the Activepieces agents view
|
|
12
|
-
|
|
13
|
-
## ๐ Actions
|
|
14
|
-
|
|
15
|
-
### Send Message to Skillful Agent
|
|
16
|
-
|
|
17
|
-
The primary action for interacting with Skillful agents. Always starts a new conversation.
|
|
18
|
-
|
|
19
|
-
**Properties:**
|
|
20
|
-
- **Skillful Agent** (required): Select from your available Skillful agents
|
|
21
|
-
- **Message** (required): The message to send to the agent
|
|
22
|
-
- **Test Mode** (optional): Enable to avoid consuming your usage allowance
|
|
23
|
-
|
|
24
|
-
**Response:**
|
|
25
|
-
```json
|
|
26
|
-
{
|
|
27
|
-
"success": true,
|
|
28
|
-
"message": "Agent's response text",
|
|
29
|
-
"chat_history_id": "conversation-id-123",
|
|
30
|
-
"agent_id": "agent-456",
|
|
31
|
-
"user_message": "Your original message",
|
|
32
|
-
"test_mode": false
|
|
33
|
-
}
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## ๐ง Authentication & Setup
|
|
37
|
-
|
|
38
|
-
### Server-Side Authentication
|
|
39
|
-
This piece uses **server-side authentication** - no piece-level configuration required. Your SKAI API key is securely stored and managed by the Activepieces server.
|
|
40
|
-
|
|
41
|
-
### Setting Up SKAI API Key
|
|
42
|
-
1. Obtain your SKAI API key from your Skillful account
|
|
43
|
-
2. Configure it in your Activepieces user settings (stored as `skaiApiKey` in user profile)
|
|
44
|
-
3. The piece automatically uses your configured API key for all requests
|
|
45
|
-
|
|
46
|
-
### Agent Access Integration
|
|
47
|
-
Skillful agents are integrated directly into Activepieces:
|
|
48
|
-
- **Agents View**: Skillful agents appear in the flow builder's agents section
|
|
49
|
-
- **Unified Experience**: Same interface as internal Activepieces agents
|
|
50
|
-
- **Dynamic Loading**: Agent list updates automatically based on your SKAI account
|
|
51
|
-
|
|
52
|
-
## ๐ Usage Examples
|
|
53
|
-
|
|
54
|
-
### Basic Message Sending
|
|
55
|
-
1. Add "Send Message to Skillful Agent" action to your flow
|
|
56
|
-
2. Select an agent from the dropdown (populated from your SKAI account)
|
|
57
|
-
3. Enter your message
|
|
58
|
-
4. Run the flow to get the agent's response
|
|
59
|
-
|
|
60
|
-
### In a Workflow Context
|
|
61
|
-
```yaml
|
|
62
|
-
Flow Example:
|
|
63
|
-
1. Trigger: New email received
|
|
64
|
-
2. Action: Send Message to Skillful Agent
|
|
65
|
-
- Agent: "Customer Support Agent"
|
|
66
|
-
- Message: "Analyze this email: {{trigger.email_body}}"
|
|
67
|
-
3. Action: Send response email with agent's analysis
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
### Testing Mode
|
|
71
|
-
Enable "Test Mode" to:
|
|
72
|
-
- Verify agent responses without consuming allowance
|
|
73
|
-
- Test different message formats
|
|
74
|
-
- Debug agent behavior during development
|
|
75
|
-
|
|
76
|
-
## โ ๏ธ Error Handling
|
|
77
|
-
|
|
78
|
-
The action returns structured error information for troubleshooting:
|
|
79
|
-
|
|
80
|
-
### Success Response
|
|
81
|
-
```json
|
|
82
|
-
{
|
|
83
|
-
"success": true,
|
|
84
|
-
"message": "Agent response",
|
|
85
|
-
"chat_history_id": "abc-123",
|
|
86
|
-
// ... additional fields
|
|
87
|
-
}
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
### Error Response
|
|
91
|
-
```json
|
|
92
|
-
{
|
|
93
|
-
"success": false,
|
|
94
|
-
"error": "Error description",
|
|
95
|
-
"agent_id": "agent-456",
|
|
96
|
-
"user_message": "Your message"
|
|
97
|
-
}
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
### Common Issues
|
|
101
|
-
|
|
102
|
-
| Issue | Cause | Solution |
|
|
103
|
-
|-------|-------|----------|
|
|
104
|
-
| No agents in dropdown | Missing SKAI API key | Configure API key in user settings |
|
|
105
|
-
| "Agent not found" error | Invalid agent selection | Verify agent is accessible to your account |
|
|
106
|
-
| Authentication errors | Invalid/expired API key | Update API key in user settings |
|
|
107
|
-
| Network timeouts | SKAI API connectivity | Check network and API status |
|
|
108
|
-
|
|
109
|
-
## ๐งช Local Development & Testing
|
|
110
|
-
|
|
111
|
-
### Adding to Development Environment
|
|
112
|
-
Add the piece to your local development:
|
|
113
|
-
|
|
114
|
-
```bash
|
|
115
|
-
# 1. Add to development pieces in packages/server/api/.env
|
|
116
|
-
AP_DEV_PIECES="google-sheets,store,skillful-agents"
|
|
117
|
-
|
|
118
|
-
# 2. Build the piece
|
|
119
|
-
npx nx build pieces-skillful-agents
|
|
120
|
-
|
|
121
|
-
# 3. Start development server
|
|
122
|
-
npm run dev
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
### Database Setup (SQLite)
|
|
126
|
-
For local testing with SQLite, add SKAI API key to user:
|
|
127
|
-
|
|
128
|
-
```sql
|
|
129
|
-
-- Update user with SKAI API key
|
|
130
|
-
UPDATE user SET skaiApiKey = 'your-skai-api-key-here' WHERE id = 'USER_ID';
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
### Testing Integration
|
|
134
|
-
1. **Agents View**: Navigate to agents in flow builder - should show Skillful agents
|
|
135
|
-
2. **Piece Available**: "Skillful Agents" should appear in pieces list
|
|
136
|
-
3. **Agent Dropdown**: Should populate with your agents when creating flows
|
|
137
|
-
4. **End-to-End**: Send test message and verify response
|
|
138
|
-
|
|
139
|
-
## ๐ Architecture
|
|
140
|
-
|
|
141
|
-
### System Integration
|
|
142
|
-
- **Bridge Service**: `/v1/skai-agents` API endpoints handle SKAI communication
|
|
143
|
-
- **Agents Service**: Modified to return Skillful agents in place of internal agents
|
|
144
|
-
- **Piece Framework**: Standard Activepieces piece using dropdown properties
|
|
145
|
-
- **Authentication**: Server-side user context extraction with API key management
|
|
146
|
-
|
|
147
|
-
### API Endpoints Used
|
|
148
|
-
- `GET /v1/skai-agents` - List user's agents (used by dropdown)
|
|
149
|
-
- `POST /v1/skai-agents/chat/new` - Send new message (used by action)
|
|
150
|
-
|
|
151
|
-
## ๐ Technical Details
|
|
152
|
-
|
|
153
|
-
- **Package Name**: `@skillful-ai/piece-skillful-agents`
|
|
154
|
-
- **Piece Name**: `skillful-agents`
|
|
155
|
-
- **Category**: Universal AI
|
|
156
|
-
- **Minimum Release**: 0.66.0
|
|
157
|
-
- **Authentication**: Server-side (PieceAuth.None)
|
|
158
|
-
|
|
159
|
-
## ๐ Support
|
|
160
|
-
|
|
161
|
-
### For Piece Issues
|
|
162
|
-
1. Check SKAI API key is configured in user settings
|
|
163
|
-
2. Verify selected agents are accessible to your account
|
|
164
|
-
3. Check Activepieces server logs for detailed error messages
|
|
165
|
-
4. Ensure piece is built and loaded in development environment
|
|
166
|
-
|
|
167
|
-
### For Skillful Platform Issues
|
|
168
|
-
Visit [https://skillful.ai](https://skillful.ai) for Skillful Agents platform support.
|
|
169
|
-
|
|
170
|
-
### Development Support
|
|
171
|
-
- Check `AP_DEV_PIECES` environment variable includes `skillful-agents`
|
|
172
|
-
- Verify piece builds successfully: `npx nx build pieces-skillful-agents`
|
|
173
|
-
- Monitor server logs during piece loading and execution
|