You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/devel_doc/openapi.json
+253-4Lines changed: 253 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -1584,6 +1584,156 @@
1584
1584
}
1585
1585
}
1586
1586
},
1587
+
"/v1/skills": {
1588
+
"get": {
1589
+
"tags": [
1590
+
"skills"
1591
+
],
1592
+
"summary": "Skills Endpoint Handler",
1593
+
"description": "Handle requests to the /skills endpoint.\n\nProcess GET requests to the /skills endpoint, returning a list of loaded\nagent skills with their metadata (name, description).\n\n### Parameters:\n- request: The incoming HTTP request (used by middleware).\n- auth: Authentication tuple from the auth dependency (used by middleware).\n\n### Raises:\n- HTTPException: with status 401 for unauthorized access.\n- HTTPException: with status 403 if permission is denied.\n- HTTPException: with status 500 and a detail object containing `response`\n and `cause` when service configuration is wrong or incomplete.\n\n### Returns:\n- SkillsResponse: An object containing the list of loaded skills.",
"cause": "Lightspeed Stack configuration has not been initialized.",
1726
+
"response": "Configuration is not loaded"
1727
+
}
1728
+
}
1729
+
}
1730
+
}
1731
+
}
1732
+
}
1733
+
}
1734
+
}
1735
+
}
1736
+
},
1587
1737
"/v1/providers": {
1588
1738
"get": {
1589
1739
"tags": [
@@ -11591,6 +11741,7 @@
11591
11741
"feedback",
11592
11742
"get_models",
11593
11743
"get_tools",
11744
+
"get_skills",
11594
11745
"get_shields",
11595
11746
"list_providers",
11596
11747
"get_provider",
@@ -12907,6 +13058,22 @@
12907
13058
"title": "Service name",
12908
13059
"description": "Name of the service. That value will be used in REST API endpoints."
12909
13060
},
13061
+
"config_format_version": {
13062
+
"anyOf": [
13063
+
{
13064
+
"type": "string",
13065
+
"enum": [
13066
+
"legacy",
13067
+
"unified"
13068
+
]
13069
+
},
13070
+
{
13071
+
"type": "null"
13072
+
}
13073
+
],
13074
+
"title": "Configuration format version",
13075
+
"description": "Optional explicit marker of the configuration format. When set, it must agree with the shape detected from the configuration body: 'unified' requires a synthesis input (a non-empty inference.providers, a non-empty vector_store.providers, or a llama_stack.config block), 'legacy' requires no synthesis input. Reserved as the lever for a future breaking change of the unified schema (R11)."
"description": "Additional OKP filter query applied to every OKP search request. Use Solr boolean syntax, e.g. 'product:ansible AND product:*openshift*'."
15878
16045
},
16046
+
"search_mode": {
16047
+
"anyOf": [
16048
+
{
16049
+
"type": "string",
16050
+
"enum": [
16051
+
"semantic",
16052
+
"hybrid",
16053
+
"keyword"
16054
+
]
16055
+
},
16056
+
{
16057
+
"type": "null"
16058
+
}
16059
+
],
16060
+
"title": "OKP search mode",
16061
+
"description": "Default Solr search mode for OKP queries. 'keyword' uses BM25 text search (no embedding model needed). 'hybrid' combines vector + keyword search. 'semantic' uses pure vector search. When unset, falls back to the global default ('hybrid')."
16062
+
},
15879
16063
"max_chunks": {
15880
16064
"type": "integer",
15881
16065
"exclusiveMinimum": 0.0,
@@ -17703,12 +17887,15 @@
17703
17887
{
17704
17888
"type": "string"
17705
17889
},
17890
+
{
17891
+
"type": "integer"
17892
+
},
17706
17893
{
17707
17894
"type": "null"
17708
17895
}
17709
17896
],
17710
17897
"title": "PostgreSQL port",
17711
-
"description": "PostgreSQL port. Defaults to ${env.POSTGRES_PORT}."
17898
+
"description": "PostgreSQL port. Defaults to ${env.POSTGRES_PORT}. Accepts string placeholders and integer values."
17712
17899
},
17713
17900
"db": {
17714
17901
"anyOf": [
@@ -19293,6 +19480,9 @@
19293
19480
{
19294
19481
"type": "string"
19295
19482
},
19483
+
{
19484
+
"type": "integer"
19485
+
},
19296
19486
{
19297
19487
"type": "null"
19298
19488
}
@@ -21361,6 +21551,27 @@
21361
21551
}
21362
21552
]
21363
21553
},
21554
+
"SkillMetadata": {
21555
+
"properties": {
21556
+
"name": {
21557
+
"type": "string",
21558
+
"title": "Name",
21559
+
"description": "Unique name of the skill"
21560
+
},
21561
+
"description": {
21562
+
"type": "string",
21563
+
"title": "Description",
21564
+
"description": "Human readable description of what the skill does"
21565
+
}
21566
+
},
21567
+
"type": "object",
21568
+
"required": [
21569
+
"name",
21570
+
"description"
21571
+
],
21572
+
"title": "SkillMetadata",
21573
+
"description": "Metadata describing a single loaded agent skill.\n\nAttributes:\n name: Unique name of the skill.\n description: Human readable description of what the skill does."
21574
+
},
21364
21575
"SkillsConfiguration": {
21365
21576
"properties": {
21366
21577
"paths": {
@@ -21378,6 +21589,38 @@
21378
21589
"title": "SkillsConfiguration",
21379
21590
"description": "Agent skills configuration.\n\nSpecifies paths to skill directories. Skill metadata (name, description)\nis read from SKILL.md frontmatter at startup.\n\nEach path can point to either:\n- A directory containing a SKILL.md file (single skill)\n- A directory containing subdirectories with SKILL.md files (multiple skills)\n\nPaths are validated at startup to ensure they exist and contain valid SKILL.md files."
21380
21591
},
21592
+
"SkillsResponse": {
21593
+
"properties": {
21594
+
"skills": {
21595
+
"items": {
21596
+
"$ref": "#/components/schemas/SkillMetadata"
21597
+
},
21598
+
"type": "array",
21599
+
"title": "Skills",
21600
+
"description": "List of loaded skills with metadata"
21601
+
}
21602
+
},
21603
+
"type": "object",
21604
+
"required": [
21605
+
"skills"
21606
+
],
21607
+
"title": "SkillsResponse",
21608
+
"description": "Model representing a response to skills request.\n\nAttributes:\n skills: List of loaded skills with metadata (name and description).",
21609
+
"examples": [
21610
+
{
21611
+
"skills": [
21612
+
{
21613
+
"description": "Review code for quality and security",
"description": "Solr vector_io search mode. When omitted, the server default ('hybrid') is used.",
21642
+
"description": "Solr vector_io search mode. When omitted, the configured OKP default is used; otherwise 'hybrid' applies. 'keyword' and 'lexical' both use BM25 text search.",
21399
21643
"examples": [
21400
21644
"hybrid",
21401
21645
"semantic",
21646
+
"keyword",
21402
21647
"lexical"
21403
21648
]
21404
21649
},
@@ -21454,7 +21699,7 @@
21454
21699
"additionalProperties": false,
21455
21700
"type": "object",
21456
21701
"title": "SolrVectorSearchRequest",
21457
-
"description": "LCORE Solr inline RAG options for vector_io.query (mode and provider filters).\n\nAttributes:\n mode: Solr vector_io search mode. When omitted, the server default (hybrid) is used.\n filters: Solr provider filter payload passed through as params['solr'].\n\nLegacy clients may send a plain JSON object with filter keys only;\nthat object is accepted as filters with mode unset (server default applies)."
21702
+
"description": "LCORE Solr inline RAG options for vector_io.query (mode and provider filters).\n\nAttributes:\n mode: Solr vector_io search mode. When omitted, the configured OKP default is used.\n filters: Solr provider filter payload passed through as params['solr'].\n\nLegacy clients may send a plain JSON object with filter keys only;\nthat object is accepted as filters with mode unset (server default applies)."
0 commit comments