Herramienta

De OpenAPI a bot: definiciones de herramientas para LLM, comandos y un dispatcher

Expón una API existente a un bot o un LLM sin escribir cada esquema a mano.

OpenAPI 3 (JSON)

{
  "openapi": "3.0.3",
  "info": { "title": "Tasks API", "version": "1.0.0" },
  "servers": [{ "url": "https://api.example.com/v1" }],
  "paths": {
    "/tasks": {
      "get": { "operationId": "listTasks", "summary": "List tasks, optionally filtered by status",
        "parameters": [{ "name": "status", "in": "query", "schema": { "type": "string", "enum": ["open", "done"] } }] },
      "post": { "operationId": "createTask", "summary": "Create a task",
        "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewTask" } } } } }
    },
    "/tasks/{id}": {
      "get": { "operationId": "getTask", "summary": "Get one task by id",
        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }] },
      "delete": { "operationId": "deleteTask", "summary": "Delete a task",
        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }] }
    }
  },
  "components": { "schemas": { "NewTask": { "type": "object", "required": ["title"],
    "properties": { "title": { "type": "string", "description": "Short title" }, "due": { "type": "string", "format": "date" } } } } }
}

Definiciones de herramientas

Lista de comandos (solo lectura)

Abrir constructor de comandos

Cliente y dispatcher (JavaScript)

Solo se mapean cuerpos JSON y parámetros de path o query; las cabeceras y la autenticación quedan para tu código. Revisa cada descripción generada: el modelo las lee para decidir qué llamar. Guía de function calling · OpenAPI Specification