Plan an Agent split

POST

https://api.getzep.com/api/v4/agents/:agent_uuid/split-plan

POST

/api/v4/agents/:agent_uuid/split-plan

from zep_cloud import Zep, AgentSplitPlanDestinationRequest, CreateAgentRequest, AgentSplitPlanSkillSelectionRequest
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.split.plan(
    agent_uuid="agent_uuid",
    destinations=[
        AgentSplitPlanDestinationRequest(
            agent=CreateAgentRequest(
                agent_id="string",
                name="string",
                security_domain="string",
            ),
            skills=[
                AgentSplitPlanSkillSelectionRequest(
                    skill_uuid="string",
                    skill_version_uuid="string",
                    version=1,
                )
            ],
        )
    ],
    expected_revision=1,
    rationale="string",
    review_acknowledged=True,
)

{
  "authorizes_agent_creation": true,
  "authorizes_publication": true,
  "creates_resources": true,
  "destinations": [
    {
      "agent": {
        "agent_id": "string",
        "name": "string",
        "security_domain": "string",
        "deployment_id": "string",
        "description": "string",
        "memory_settings": {
          "admission_evaluation_requirements": [
            {
              "requirements": [
                {
                  "evaluated_by": "string",
                  "evaluator_version": "string",
                  "result": "string",
                  "controlled": true,
                  "environment": "string"
                }
              ],
              "task_family": "string"
            }
          ],
          "approval": "manual",
          "approval_minimum_attempt_families": 1,
          "approval_required_tools": [
            "string"
          ],
          "auto_approval_task_families": [
            "string"
          ],
          "compilation_mode": "scheduled",
          "provisional_expiry_days": 1,
          "provisional_skill_limit": 1,
          "retention_days": 1
        },
        "metadata": {},
        "version": "default"
      },
      "skills": [
        {
          "package_name": "string",
          "skill_id": "string",
          "skill_uuid": "string",
          "skill_version_uuid": "string",
          "status": "string",
          "version": 1
        }
      ]
    }
  ],
  "rationale": "string",
  "review_acknowledged": true,
  "source": {
    "agent_uuid": "string",
    "revision": 1
  }
}

Authentication

AuthorizationApi-Key

Type "Api-Key" followed by a space and the project API key.

Path parameters

agent_uuidstringRequired

Source Agent UUID

Request

Reviewed split proposal

destinationslist of objectsRequired

expected_revisionintegerRequired>=1

rationalestringRequired<=2000 characters

review_acknowledgedbooleanRequired

Response

authorizes_agent_creationbooleanOptional

authorizes_publicationbooleanOptional

creates_resourcesbooleanOptional

A split plan is not human approval and grants no authority for later commands.

destinationslist of objectsOptional

rationalestringOptional

review_acknowledgedbooleanOptional

sourceobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error