manus

Manus

Manus は、複雑なタスクを非同期で処理する自律型 AI エージェントです。並列処理、ウェブ閲覧、データの可視化を含む包括的なレポートの生成を伴う詳細な調査を特に得意としています。

Manus を使用する場面

• 詳細な調査 - 市場分析、競合状況の調査、製品比較
• 株式・財務分析 - 企業調査、テクニカル分析、価格チャート
• 製品調査 - ブランド間の機能比較、仕様分析
• レポート生成 - Markdown レポート、CSV、チャート、可視化を作成します
• 複数ソースの統合 - 複数のウェブサイトから情報を収集・統合します
• 長時間実行タスク - 1〜10 分以上の自律的な作業を要するタスク

調査プロンプトの例

効果的な調査プロンプトでは、範囲、情報源、希望する出力を具体的に指定します。

製品比較：

Find the best 4K monitors for Mac with Thunderbolt connectivity and 120Hz+ refresh rate.
Focus on BenQ, Samsung, Dell, LG. Only include models released in the last year.
Compare specs, prices, and Mac-specific features. Output a comparison table.

株式・企業分析：

Analyze [TICKER] stock: company profile, recent performance, technical indicators,
valuation metrics, and insider activity. Include a price chart for the past year.

市場調査：

Research the [industry] market: key players, market size, growth trends,
recent developments, and competitive landscape. Focus on [region/segment].

競合分析：

Compare [Product A] vs [Product B] vs [Product C]: features, pricing,
user reviews, pros/cons. Create a decision matrix for [use case].

環境のセットアップ

MANUS_API_KEY 環境変数が必要です。ベース URL：https://api.manus.ai

基本的なワークフロー

1. タスクを作成 → すぐに task_id が返されます
2. ステータスをポーリング → status が completed または failed になるまで確認します
3. 結果を返す → 出力テキストとファイル添付を抽出します

タスクの作成

curl -s -X POST "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"prompt":"<task description>","agentProfile":"manus-1.6"}'

エージェントのプロファイル：

• manus-1.6-lite - 高速でシンプルなタスク向け（簡単な検索、簡単な質問）
• manus-1.6 - 標準（デフォルト。ほとんどの調査に適しています）
• manus-1.6-max - 複雑な推論向け（詳細な調査、複数ソースの分析、詳細なレポート）

レスポンス：

{"task_id":"abc123","task_title":"...","task_url":"https://manus.im/app/abc123"}

タスクのステータス確認

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY"

ステータス値： pending、running、completed、failed

完了するまで 5〜10 秒ごとにポーリングします。

テキスト出力を抽出：

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY" | jq -r '.output[] | select(.role=="assistant") | .content[] | select(.type=="output_text") | .text'

ファイル添付を抽出：

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY" | jq -r '.output[] | select(.role=="assistant") | .content[] | select(.type=="output_file") | "\(.fileName): \(.fileUrl)"'

タスクの一覧表示

curl -s -X GET "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" | jq '.data[] | {id, status, title: .metadata.task_title}'

マルチターンの会話

taskId を含めることで、既存のタスクを続行できます。

curl -s -X POST "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"prompt":"follow-up question","taskId":"abc123","agentProfile":"manus-1.6"}'

タスクの削除

curl -s -X DELETE "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY"

詳細オプション

パラメーター	説明
taskMode	chat、adaptive、または agent
projectId	共有指示を適用するプロジェクトに関連付けます
attachments	ファイルオブジェクトの配列（下記参照）
connectors	事前設定されたコネクター ID（Gmail、Calendar、Notion）
createShareableLink	公開アクセス可能な URL を有効にします

ファイル添付

次の 3 つの形式のいずれかを使用してファイルを添付します。

URL 添付：

{"prompt":"Analyze this","attachments":[{"type":"url","url":"https://example.com/doc.pdf"}]}

Base64 添付：

{"prompt":"What's in this image?","attachments":[{"type":"base64","data":"<base64>","mime_type":"image/png"}]}

ファイル ID（アップロード後）：

{"prompt":"Review this file","attachments":[{"type":"file","file_id":"file-xxx"}]}

プロジェクト

共有指示を設定したプロジェクトを作成します。

curl -s -X POST "https://api.manus.ai/v1/projects" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"name":"My Project","instruction":"Always respond concisely"}'

タスクでプロジェクトを使用します。

curl -s -X POST "https://api.manus.ai/v1/tasks" -H "API_KEY:$MANUS_API_KEY" -H "Content-Type:application/json" -d '{"prompt":"...","projectId":"proj_xxx","agentProfile":"manus-1.6"}'

ベストプラクティス

• 簡単なクエリには manus-1.6-lite を使用します（より高速で低コストです）
• 調査タスクには manus-1.6 または manus-1.6-max を使用します
• ユーザーがブラウザーで進行状況を確認できるよう、必ず task_url を提示します
• 適切な間隔でステータスをポーリングします（簡単なタスクは 5〜10 秒、調査は 15〜30 秒）
• 消費量を追跡するには credit_usage フィールドを確認します
• 調査では、範囲、期間、情報源、希望する出力形式を具体的に指定します
• 調査タスクでは通常、複数の出力ファイル（レポート、CSV、チャート）が生成されるため、すべての添付ファイルを抽出します
• Manus は多面的な調査に並列処理を使用します。1 つのプロンプトで複数の観点を扱えます

エラー処理

失敗したタスクを確認します。

curl -s -X GET "https://api.manus.ai/v1/tasks/{task_id}" -H "API_KEY:$MANUS_API_KEY" | jq '{status, error}'

status が failed の場合、error フィールドに理由が含まれています。よくある問題：

• 無効な API キー → MANUS_API_KEY が設定されていることを確認してください
• タスクのタイムアウト → プロンプトを簡略化するか、manus-1.6-max を使用してください
• レート制限 → 待ってから再試行してください

API リファレンス

エンドポイントの詳細については、references/api.md を参照してください。