phoenix-oss/llama-stack
1
0
Fork 0
forked from phoenix-oss/llama-stack-mirror
Code Pull requests Releases Packages 2 Activity Actions

[docs] add openapi spec to docs (#508)

Browse source 
# What does this PR do?
- modify openapi generator to add coming soon tag for unimplemented api
- sphinx-redocs extension for openapi spec to readthedocs page

## Test Plan



https://github.com/user-attachments/assets/b4c7eebc-2361-4198-a987-dbfbcff914cf






## Before submitting

- [ ] This PR fixes a typo or improves the docs (you can dismiss the
other checks if that's the case).
- [ ] Ran pre-commit to handle lint / formatting issues.
- [ ] Read the [contributor
guideline](https://github.com/meta-llama/llama-stack/blob/main/CONTRIBUTING.md),
      Pull Request section?
- [ ] Updated relevant documentation.
- [ ] Wrote necessary unit or integration tests.
This commit is contained in:
Xi Yan 2024-11-22 17:54:32 -08:00 • committed by GitHub
parent 1b2b32f959
commit d97cfaa9d9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
8 changed files with 80 additions and 44 deletions
Download patch file Download diff file Expand all files Collapse all files

39
docs/resources/llama-stack-spec.html
View file

@ -19,9 +19,9 @@
spec = {
"openapi": "3.1.0",
"info": {
"title": "[DRAFT] Llama Stack Specification",
"title": "Llama Stack Specification",
"version": "alpha",
"description": "This is the specification of the llama stack that provides\n a set of endpoints and their corresponding interfaces that are tailored to\n best leverage Llama Models. The specification is still in draft and subject to change.\n Generated at 2024-11-19 09:14:01.145131"
"description": "This is the specification of the Llama Stack that provides\n a set of endpoints and their corresponding interfaces that are tailored to\n best leverage Llama Models. Generated at 2024-11-22 17:23:55.034164"
},
"servers": [
{
@ -44,7 +44,7 @@
}
},
"tags": [
"BatchInference"
"BatchInference (Coming Soon)"
],
"parameters": [
{
@ -84,7 +84,7 @@
}
},
"tags": [
"BatchInference"
"BatchInference (Coming Soon)"
],
"parameters": [
{
@ -117,7 +117,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -1079,7 +1079,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -1117,7 +1117,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -1155,7 +1155,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -1193,7 +1193,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -1713,7 +1713,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -2161,7 +2161,7 @@
}
},
"tags": [
"PostTraining"
"PostTraining (Coming Soon)"
],
"parameters": [
{
@ -2201,7 +2201,7 @@
}
},
"tags": [
"SyntheticDataGeneration"
"SyntheticDataGeneration (Coming Soon)"
],
"parameters": [
{
@ -3861,7 +3861,8 @@
"type": "string",
"enum": [
"bing",
"brave"
"brave",
"tavily"
],
"default": "brave"
},
@ -8002,7 +8003,7 @@
"description": "<SchemaDefinition schemaRef=\"#/components/schemas/BatchCompletionResponse\" />"
},
{
"name": "BatchInference"
"name": "BatchInference (Coming Soon)"
},
{
"name": "BenchmarkEvalTaskConfig",
@ -8256,7 +8257,7 @@
"description": "<SchemaDefinition schemaRef=\"#/components/schemas/PhotogenToolDefinition\" />"
},
{
"name": "PostTraining"
"name": "PostTraining (Coming Soon)"
},
{
"name": "PostTrainingJob",
@ -8447,7 +8448,7 @@
"description": "<SchemaDefinition schemaRef=\"#/components/schemas/SyntheticDataGenerateRequest\" />"
},
{
"name": "SyntheticDataGeneration"
"name": "SyntheticDataGeneration (Coming Soon)"
},
{
"name": "SyntheticDataGenerationResponse",
@ -8558,7 +8559,7 @@
"name": "Operations",
"tags": [
"Agents",
"BatchInference",
"BatchInference (Coming Soon)",
"DatasetIO",
"Datasets",
"Eval",
@ -8568,12 +8569,12 @@
"Memory",
"MemoryBanks",
"Models",
"PostTraining",
"PostTraining (Coming Soon)",
"Safety",
"Scoring",
"ScoringFunctions",
"Shields",
"SyntheticDataGeneration",
"SyntheticDataGeneration (Coming Soon)",
"Telemetry"
]
},