feat(skills): implement API endpoints for retrieving skill references in workflows and add related data models

api/controllers/console/__init__.py

@@ -63,6 +63,7 @@ from .app import (
     model_config,
     ops_trace,
     site,
+    skills,
     statistic,
     workflow,
     workflow_app_log,
@@ -206,6 +207,7 @@ __all__ = [
     "saved_message",
     "setup",
     "site",
+    "skills",
     "spec",
     "statistic",
     "tags",

api/controllers/console/app/skills.py

@@ -0,0 +1,72 @@
+from flask_restx import Resource
+
+from controllers.console import console_ns
+from controllers.console.app.error import DraftWorkflowNotExist
+from controllers.console.app.wraps import get_app_model
+from controllers.console.wraps import account_initialization_required, setup_required
+from libs.login import login_required
+from models import App
+from models.model import AppMode
+from services.skill_service import SkillService
+from services.workflow_service import WorkflowService
+
+
+@console_ns.route("/apps/<uuid:app_id>/workflows/draft/nodes/<string:node_id>/skills")
+class NodeSkillsApi(Resource):
+    """API for retrieving skill references for a specific workflow node."""
+
+    @console_ns.doc("get_node_skills")
+    @console_ns.doc(description="Get skill references for a specific node in the draft workflow")
+    @console_ns.doc(params={"app_id": "Application ID", "node_id": "Node ID"})
+    @console_ns.response(200, "Node skills retrieved successfully")
+    @console_ns.response(404, "Workflow or node not found")
+    @setup_required
+    @login_required
+    @account_initialization_required
+    @get_app_model(mode=[AppMode.ADVANCED_CHAT, AppMode.WORKFLOW])
+    def get(self, app_model: App, node_id: str):
+        """
+        Get skill information for a specific node in the draft workflow.
+
+        Returns information about skill references in the node, including:
+        - skill_references: List of prompt messages marked as skills
+        - tool_references: Aggregated tool references from all skill prompts
+        - file_references: Aggregated file references from all skill prompts
+        """
+        workflow_service = WorkflowService()
+        workflow = workflow_service.get_draft_workflow(app_model=app_model)
+
+        if not workflow:
+            raise DraftWorkflowNotExist()
+
+        skill_info = SkillService.get_node_skill_info(workflow=workflow, node_id=node_id)
+        return skill_info.model_dump()
+
+
+@console_ns.route("/apps/<uuid:app_id>/workflows/draft/skills")
+class WorkflowSkillsApi(Resource):
+    """API for retrieving all skill references in a workflow."""
+
+    @console_ns.doc("get_workflow_skills")
+    @console_ns.doc(description="Get all skill references in the draft workflow")
+    @console_ns.doc(params={"app_id": "Application ID"})
+    @console_ns.response(200, "Workflow skills retrieved successfully")
+    @console_ns.response(404, "Workflow not found")
+    @setup_required
+    @login_required
+    @account_initialization_required
+    @get_app_model(mode=[AppMode.ADVANCED_CHAT, AppMode.WORKFLOW])
+    def get(self, app_model: App):
+        """
+        Get skill information for all nodes in the draft workflow that have skill references.
+
+        Returns a list of nodes with their skill information.
+        """
+        workflow_service = WorkflowService()
+        workflow = workflow_service.get_draft_workflow(app_model=app_model)
+
+        if not workflow:
+            raise DraftWorkflowNotExist()
+
+        skills_info = SkillService.get_workflow_skills(workflow=workflow)
+        return {"nodes": [info.model_dump() for info in skills_info]}