新規セッションを作成
ManageOrgSessions 権限が付与されたサービスユーザーが必要です。
| 機能 | 必要な権限 |
|---|---|
advanced_mode | UseDevinExpert |
create_as_user_id | ImpersonateOrgSessions |
advanced_mode パラメータは、自動化ワークフロー向けの専用のセッション動作を有効にします。有効化されている場合、セッションは高度なペルソナを使用し、選択したモードに応じてプロンプトが変換されます。
| モード | 説明 | 必須パラメータ |
|---|---|---|
analyze | 既存の Devin セッションを分析してインサイトを抽出します | session_links |
create | セッション分析に基づいて新しいプレイブックを作成します | なし(任意: session_links) |
improve | フィードバックに基づいて既存のプレイブックを改善します | child_playbook_id |
batch | 複数のタスクに対して Devin セッションを一括で開始します | child_playbook_id |
manage | Knowledge を管理します | なし |
batch モードを使用する場合、任意で bypass_approval を true に設定し、バッチセッション作成時の承認ステップをスキップできます。これは、セッションを手動承認なしですぐに開始したい、完全に自動化されたワークフローで便利です。
create_as_user_id パラメータを使うと、別のユーザーになり代わってセッションを作成できます。これには次の条件を満たす必要があります。
ImpersonateOrgSessions 権限を持っていることUseDevinSessions 権限を持っていることサービスユーザーの認証情報(接頭辞: cog_)
analyze, create, improve, batch, manage 1 - 2083構造化出力を検証するための JSON Schema(Draft 7)。最大 64KB。自己完結している必要があり(外部 $ref や外部参照は使用できません)。
成功時のレスポンス
new, claimed, running, exit, error, suspended, resuming セッションからの検証済み構造化出力。GET/list エンドポイントでのみ設定されます。