Skip to content

Commit 98497cc

Browse files
committed
README.md banner added, Agent profiles list added
1 parent 8d89fb8 commit 98497cc

File tree

2 files changed

+109
-2
lines changed

2 files changed

+109
-2
lines changed

README.md

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Manus AI PHP SDK
22

3+
<div align="center">
4+
<img src="https://github.com/user-attachments/assets/eb30d0e5-3d22-4edb-bb42-dd4e751b5cf4" alt="Monica AI PHP SDK" style="max-width: 100%; height: auto;">
5+
</div>
6+
37
🚀 Complete PHP library for integration with [Manus AI](https://manus.ai) API. Easily integrate Manus AI agent into your PHP applications with full Laravel support.
48

59
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -116,15 +120,30 @@ Tasks are the core of Manus AI - they represent AI agent work items that can per
116120
[API Docs: Create Task](https://open.manus.ai/docs/api-reference/create-task)
117121

118122
```php
123+
use Tigusigalpa\ManusAI\Helpers\AgentProfile;
124+
119125
$task = $client->createTask('Your task prompt here', [
120-
'agentProfile' => 'manus-1.5', // or 'manus-1.5-lite'
121-
'taskMode' => 'agent', // 'chat', 'adaptive', or 'agent'
126+
'agentProfile' => AgentProfile::MANUS_1_5, // or AgentProfile::MANUS_1_5_LITE
127+
'taskMode' => 'agent', // 'chat', 'adaptive', or 'agent'
122128
'locale' => 'en-US',
123129
'hideInTaskList' => false,
124130
'createShareableLink' => true,
125131
]);
126132
```
127133

134+
**Available Agent Profiles:**
135+
- `AgentProfile::MANUS_1_5` - Latest and most capable model (recommended)
136+
- `AgentProfile::MANUS_1_5_LITE` - Faster, lightweight version
137+
- `AgentProfile::SPEED` - ⚠️ Deprecated, use `MANUS_1_5_LITE` instead
138+
- `AgentProfile::QUALITY` - ⚠️ Deprecated, use `MANUS_1_5` instead
139+
140+
```php
141+
// Or use string values directly
142+
$task = $client->createTask('Your prompt', [
143+
'agentProfile' => 'manus-1.5',
144+
]);
145+
```
146+
128147
#### Get Task Details
129148

130149
[API Docs: Get Task](https://open.manus.ai/docs/api-reference/get-task)
@@ -403,6 +422,16 @@ php artisan manus-ai:task delete --id=task_123
403422
- `TaskAttachment::fromBase64(string $data, string $mimeType): array`
404423
- `TaskAttachment::fromFilePath(string $path): array`
405424

425+
#### AgentProfile
426+
- `AgentProfile::MANUS_1_5` - Latest model (recommended)
427+
- `AgentProfile::MANUS_1_5_LITE` - Lightweight version
428+
- `AgentProfile::SPEED` - Deprecated
429+
- `AgentProfile::QUALITY` - Deprecated
430+
- `AgentProfile::all(): array` - Get all profiles
431+
- `AgentProfile::recommended(): array` - Get recommended profiles
432+
- `AgentProfile::isValid(string $profile): bool`
433+
- `AgentProfile::isDeprecated(string $profile): bool`
434+
406435
#### WebhookHandler
407436
- `WebhookHandler::parsePayload(string $json): array`
408437
- `WebhookHandler::isTaskCreated(array $payload): bool`

src/Helpers/AgentProfile.php

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
<?php
2+
3+
namespace Tigusigalpa\ManusAI\Helpers;
4+
5+
class AgentProfile
6+
{
7+
/**
8+
* Manus 1.5 - Latest and most capable model (recommended)
9+
*/
10+
public const MANUS_1_5 = 'manus-1.5';
11+
12+
/**
13+
* Manus 1.5 Lite - Faster, lightweight version
14+
*/
15+
public const MANUS_1_5_LITE = 'manus-1.5-lite';
16+
17+
/**
18+
* Speed - Deprecated, use MANUS_1_5_LITE instead
19+
* @deprecated Use MANUS_1_5_LITE instead
20+
*/
21+
public const SPEED = 'speed';
22+
23+
/**
24+
* Quality - Deprecated, use MANUS_1_5 instead
25+
* @deprecated Use MANUS_1_5 instead
26+
*/
27+
public const QUALITY = 'quality';
28+
29+
/**
30+
* Get all available agent profiles
31+
*
32+
* @return array
33+
*/
34+
public static function all(): array
35+
{
36+
return [
37+
self::MANUS_1_5,
38+
self::MANUS_1_5_LITE,
39+
self::SPEED,
40+
self::QUALITY,
41+
];
42+
}
43+
44+
/**
45+
* Get recommended agent profiles (non-deprecated)
46+
*
47+
* @return array
48+
*/
49+
public static function recommended(): array
50+
{
51+
return [
52+
self::MANUS_1_5,
53+
self::MANUS_1_5_LITE,
54+
];
55+
}
56+
57+
/**
58+
* Check if an agent profile is valid
59+
*
60+
* @param string $profile
61+
* @return bool
62+
*/
63+
public static function isValid(string $profile): bool
64+
{
65+
return in_array($profile, self::all(), true);
66+
}
67+
68+
/**
69+
* Check if an agent profile is deprecated
70+
*
71+
* @param string $profile
72+
* @return bool
73+
*/
74+
public static function isDeprecated(string $profile): bool
75+
{
76+
return in_array($profile, [self::SPEED, self::QUALITY], true);
77+
}
78+
}

0 commit comments

Comments
 (0)