This commit is contained in:
a2a-platform
2026-06-28 16:45:57 +00:00
commit 416af50961
40 changed files with 41629 additions and 0 deletions

189
skills/ai/SKILL.md Normal file
View File

@@ -0,0 +1,189 @@
---
name: ai-routes
description: Handle 21 OpenAPI operation(s) under /api/v1/ai for the ai route group.
---
# ai API Routes
Handle 21 OpenAPI operation(s) under /api/v1/ai for the ai route group.
Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.
## Operations
### api_ai_start_activity_chat_session_api_v1_ai_start_activity_chat_session_post
- Operation ID: `api_ai_start_activity_chat_session_api_v1_ai_start_activity_chat_session_post`
- Route: `POST /api/v1/ai/start/activity_chat_session`
- Mode: WRITE
- Summary: Start activity AI chat session
- Body: JSON request body accepted.
### api_ai_send_activity_chat_message_api_v1_ai_send_activity_chat_message_post
- Operation ID: `api_ai_send_activity_chat_message_api_v1_ai_send_activity_chat_message_post`
- Route: `POST /api/v1/ai/send/activity_chat_message`
- Mode: WRITE
- Summary: Send activity AI chat message
- Body: JSON request body accepted.
### api_ai_start_activity_chat_session_stream_api_v1_ai_stream_start_activity_chat_s
- Operation ID: `api_ai_start_activity_chat_session_stream_api_v1_ai_stream_start_activity_chat_s`
- Route: `POST /api/v1/ai/stream/start/activity_chat_session`
- Mode: WRITE
- Summary: Start activity AI chat session (streaming)
- Body: JSON request body accepted.
### api_ai_send_activity_chat_message_stream_api_v1_ai_stream_send_activity_chat_mes
- Operation ID: `api_ai_send_activity_chat_message_stream_api_v1_ai_stream_send_activity_chat_mes`
- Route: `POST /api/v1/ai/stream/send/activity_chat_message`
- Mode: WRITE
- Summary: Send activity AI chat message (streaming)
- Body: JSON request body accepted.
### api_editor_ai_start_chat_session_stream_api_v1_ai_stream_editor_start_post
- Operation ID: `api_editor_ai_start_chat_session_stream_api_v1_ai_stream_editor_start_post`
- Route: `POST /api/v1/ai/stream/editor/start`
- Mode: WRITE
- Summary: Start editor AI chat session (streaming)
- Body: JSON request body accepted.
### api_editor_ai_send_message_stream_api_v1_ai_stream_editor_message_post
- Operation ID: `api_editor_ai_send_message_stream_api_v1_ai_stream_editor_message_post`
- Route: `POST /api/v1/ai/stream/editor/message`
- Mode: WRITE
- Summary: Send editor AI chat message (streaming)
- Body: JSON request body accepted.
### start_magicblock_session_api_v1_ai_magicblocks_start_post
- Operation ID: `start_magicblock_session_api_v1_ai_magicblocks_start_post`
- Route: `POST /api/v1/ai/magicblocks/start`
- Mode: WRITE
- Summary: Start MagicBlock session (streaming)
- Body: JSON request body accepted.
### iterate_magicblock_session_api_v1_ai_magicblocks_iterate_post
- Operation ID: `iterate_magicblock_session_api_v1_ai_magicblocks_iterate_post`
- Route: `POST /api/v1/ai/magicblocks/iterate`
- Mode: WRITE
- Summary: Iterate MagicBlock session (streaming)
- Body: JSON request body accepted.
### get_session_state_api_v1_ai_magicblocks_session_session_uuid_get
- Operation ID: `get_session_state_api_v1_ai_magicblocks_session_session_uuid_get`
- Route: `GET /api/v1/ai/magicblocks/session/{session_uuid}`
- Mode: READ
- Summary: Get MagicBlock session state
- Parameters:
- `session_uuid` in `path` required
### start_course_planning_session_api_v1_ai_courseplanning_start_post
- Operation ID: `start_course_planning_session_api_v1_ai_courseplanning_start_post`
- Route: `POST /api/v1/ai/courseplanning/start`
- Mode: WRITE
- Summary: Start course planning session (streaming)
- Body: JSON request body accepted.
### iterate_course_planning_session_api_v1_ai_courseplanning_iterate_post
- Operation ID: `iterate_course_planning_session_api_v1_ai_courseplanning_iterate_post`
- Route: `POST /api/v1/ai/courseplanning/iterate`
- Mode: WRITE
- Summary: Iterate course planning session (streaming)
- Body: JSON request body accepted.
### finalize_course_plan_api_v1_ai_courseplanning_finalize_post
- Operation ID: `finalize_course_plan_api_v1_ai_courseplanning_finalize_post`
- Route: `POST /api/v1/ai/courseplanning/finalize`
- Mode: WRITE
- Summary: Finalize course plan
- Body: JSON request body accepted.
### generate_activity_content_api_v1_ai_courseplanning_generate_activity_post
- Operation ID: `generate_activity_content_api_v1_ai_courseplanning_generate_activity_post`
- Route: `POST /api/v1/ai/courseplanning/generate-activity`
- Mode: WRITE
- Summary: Generate activity content (streaming)
- Body: JSON request body accepted.
### save_activity_content_api_v1_ai_courseplanning_save_activity_content_post
- Operation ID: `save_activity_content_api_v1_ai_courseplanning_save_activity_content_post`
- Route: `POST /api/v1/ai/courseplanning/save-activity-content`
- Mode: WRITE
- Summary: Save AI-generated activity content
- Body: JSON request body accepted.
### get_session_state_api_v1_ai_courseplanning_session_session_uuid_get
- Operation ID: `get_session_state_api_v1_ai_courseplanning_session_session_uuid_get`
- Route: `GET /api/v1/ai/courseplanning/session/{session_uuid}`
- Mode: READ
- Summary: Get course planning session state
- Parameters:
- `session_uuid` in `path` required
### api_rag_chat_api_v1_ai_rag_chat_post
- Operation ID: `api_rag_chat_api_v1_ai_rag_chat_post`
- Route: `POST /api/v1/ai/rag/chat`
- Mode: WRITE
- Summary: RAG chat (streaming)
- Body: JSON request body accepted.
### api_rag_index_api_v1_ai_rag_index_post
- Operation ID: `api_rag_index_api_v1_ai_rag_index_post`
- Route: `POST /api/v1/ai/rag/index`
- Mode: WRITE
- Summary: Reindex course content for RAG
- Body: JSON request body accepted.
### api_rag_sessions_api_v1_ai_rag_sessions_get
- Operation ID: `api_rag_sessions_api_v1_ai_rag_sessions_get`
- Route: `GET /api/v1/ai/rag/sessions`
- Mode: READ
- Summary: List RAG chat sessions
- Parameters:
- `org_slug` in `query`
### api_rag_session_messages_api_v1_ai_rag_sessions_aichat_uuid_messages_get
- Operation ID: `api_rag_session_messages_api_v1_ai_rag_sessions_aichat_uuid_messages_get`
- Route: `GET /api/v1/ai/rag/sessions/{aichat_uuid}/messages`
- Mode: READ
- Summary: Get RAG chat session messages
- Parameters:
- `aichat_uuid` in `path` required
### api_rag_session_delete_api_v1_ai_rag_sessions_aichat_uuid_delete
- Operation ID: `api_rag_session_delete_api_v1_ai_rag_sessions_aichat_uuid_delete`
- Route: `DELETE /api/v1/ai/rag/sessions/{aichat_uuid}`
- Mode: WRITE
- Summary: Delete a RAG chat session
- Parameters:
- `aichat_uuid` in `path` required
### api_rag_session_update_api_v1_ai_rag_sessions_aichat_uuid_patch
- Operation ID: `api_rag_session_update_api_v1_ai_rag_sessions_aichat_uuid_patch`
- Route: `PATCH /api/v1/ai/rag/sessions/{aichat_uuid}`
- Mode: WRITE
- Summary: Update a RAG chat session
- Parameters:
- `aichat_uuid` in `path` required
- Body: JSON request body accepted.