Compare Agent Skill Versions

POST

https://api.getzep.com/api/v4/agents/:agent_uuid/skills/:skill_uuid/versions/compare

POST

/api/v4/agents/:agent_uuid/skills/:skill_uuid/versions/compare

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.skill.version.compare(
    agent_uuid="agent_uuid",
    skill_uuid="skill_uuid",
    from_version=1,
    to_version=1,
)

{
  "changed_fields": [
    "string"
  ],
  "from": {
    "contract": {},
    "created_at": "string",
    "definition": {
      "agent_versions": [
        "string"
      ],
      "aliases": [
        "string"
      ],
      "description": "string",
      "do_not_use_when": [
        "string"
      ],
      "done_when": [
        "string"
      ],
      "environments": [
        {
          "aliases": [
            "string"
          ],
          "name": "string",
          "version": "string"
        }
      ],
      "failures": [
        {
          "recover": [
            "string"
          ],
          "when": "string"
        }
      ],
      "kind": "string",
      "name": "string",
      "outputs": [
        "string"
      ],
      "package_name": "string",
      "preconditions": [
        "string"
      ],
      "procedure": [
        {
          "decision": "string",
          "expect": [
            "string"
          ],
          "instruction": "string"
        }
      ],
      "related_skills": [
        {
          "relation": "string",
          "skill": "string",
          "version": "string"
        }
      ],
      "sections": [
        {
          "heading": "string",
          "id": "string",
          "markdown": "string"
        }
      ],
      "stop_when": [
        "string"
      ],
      "task_family": "string",
      "tools": [
        {
          "aliases": [
            "string"
          ],
          "name": "string",
          "version": "string"
        }
      ],
      "use_when": [
        "string"
      ]
    },
    "markdown": "string",
    "self_contained": true,
    "version": 1
  },
  "to": {
    "contract": {},
    "created_at": "string",
    "definition": {
      "agent_versions": [
        "string"
      ],
      "aliases": [
        "string"
      ],
      "description": "string",
      "do_not_use_when": [
        "string"
      ],
      "done_when": [
        "string"
      ],
      "environments": [
        {
          "aliases": [
            "string"
          ],
          "name": "string",
          "version": "string"
        }
      ],
      "failures": [
        {
          "recover": [
            "string"
          ],
          "when": "string"
        }
      ],
      "kind": "string",
      "name": "string",
      "outputs": [
        "string"
      ],
      "package_name": "string",
      "preconditions": [
        "string"
      ],
      "procedure": [
        {
          "decision": "string",
          "expect": [
            "string"
          ],
          "instruction": "string"
        }
      ],
      "related_skills": [
        {
          "relation": "string",
          "skill": "string",
          "version": "string"
        }
      ],
      "sections": [
        {
          "heading": "string",
          "id": "string",
          "markdown": "string"
        }
      ],
      "stop_when": [
        "string"
      ],
      "task_family": "string",
      "tools": [
        {
          "aliases": [
            "string"
          ],
          "name": "string",
          "version": "string"
        }
      ],
      "use_when": [
        "string"
      ]
    },
    "markdown": "string",
    "self_contained": true,
    "version": 1
  }
}

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

skill_uuidstringRequired

Skill UUID

Request

Versions to compare

from_versionintegerRequired>=1

to_versionintegerRequired>=1

Response

changed_fieldslist of stringsOptional

fromobjectOptional

toobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

503

Service Unavailable Error