Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0
"""Agent Evolution endpoints."""
from fastapi import APIRouter, Depends, Query
from openviking.core.uri_validation import validate_request_viking_uri
from openviking.server.auth import get_request_context
from openviking.server.dependencies import get_service
from openviking.server.identity import RequestContext
from openviking.server.models import Response
from openviking.service.agent_evolution_service import (
DEFAULT_TRAJECTORY_PAGE_LIMIT,
MAX_TRAJECTORY_PAGE_LIMIT,
)
router = APIRouter(prefix="/api/v1/agent-evolution", tags=["agent-evolution"])
@router.get("/experiences/trajectories")
async def list_experience_trajectories(
experience_uri: str = Query(..., description="Experience file URI"),
limit: int = Query(
DEFAULT_TRAJECTORY_PAGE_LIMIT,
ge=1,
le=MAX_TRAJECTORY_PAGE_LIMIT,
),
offset: int = Query(0, ge=0),
start_date: str | None = Query(None, description="UTC start date, inclusive (YYYY-MM-DD)"),
end_date: str | None = Query(None, description="UTC end date, inclusive (YYYY-MM-DD)"),
_ctx: RequestContext = Depends(get_request_context),
):
"""List trajectories produced by commits that read an Experience."""
service = get_service()
experience_uri = validate_request_viking_uri(experience_uri, _ctx)
result = await service.agent_evolution.list_trajectories_by_experience(
experience_uri=experience_uri,
ctx=_ctx,
limit=limit,
offset=offset,
start_date=start_date,
end_date=end_date,
)
return Response(status="ok", result=result)
@router.get("/experiences/outcomes")
async def get_experience_outcome_distribution(
experience_uri: str = Query(..., description="Experience file URI"),
start_date: str | None = Query(None, description="UTC start date, inclusive (YYYY-MM-DD)"),
end_date: str | None = Query(None, description="UTC end date, inclusive (YYYY-MM-DD)"),
_ctx: RequestContext = Depends(get_request_context),
):
"""Count application trajectories by outcome for an Experience."""
service = get_service()
experience_uri = validate_request_viking_uri(experience_uri, _ctx)
result = await service.agent_evolution.get_experience_outcome_distribution(
experience_uri=experience_uri,
ctx=_ctx,
start_date=start_date,
end_date=end_date,
)
return Response(status="ok", result=result)