Importar un documento OpenAPI como un conjunto de herramientas
Analiza un documento OpenAPI 3.0 o 3.1 (JSON o YAML, enviado en el cuerpo; nunca se obtiene desde una URL) y almacena sus operaciones compatibles como herramientas que un agente puede invocar. Las operaciones que no pueden invocarse fielmente se enumeran en skipped_operations; seleccionar una con operations rechaza la importación en su lugar. Las credenciales nunca forman parte del documento: haga referencia a un servidor de almacén de credenciales registrado para la URL base de la API.
Autorizaciones
Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.
Encabezados
Optional external end-user identifier forwarded by the API gateway.
Cuerpo
El documento OpenAPI 3.0 o 3.1, como objeto o como texto JSON o YAML (como máximo 4 MiB).
1Etiqueta para el conjunto de herramientas. Por defecto, un slug del info.title del documento.
^[a-zA-Z0-9_-]{1,64}$La URL base pública de la API. Por defecto, es el primer servidor del documento, con las variables establecidas en sus valores predeterminados.
2048operationIds a importar. Por defecto, todas las operaciones compatibles (como máximo 128).
1 - 128 elements1 - 64Servidor de bóveda de credenciales, registrado para la URL base de la API, cuya credencial autentica cada llamada.
Credencial de mcp_server_id a usar. De forma predeterminada, será la credencial activa más reciente del servidor en tiempo de ejecución.
Respuesta
Conjunto de herramientas OpenAPI
agent.openapi_tool_set La info.title del documento.
La info.version del documento.
La definición normalizada de la herramienta que envía una ejecución del agente. Contiene referencias de credenciales, nunca valores de credenciales.
Operaciones del documento que no se importaron, y por qué.
Lo que los esquemas de seguridad del documento esperan que la credencial del vault envíe.