Pular para o conteúdo principal
POST
Python (SDK)

Autorizações

Authorization
string
header
obrigatório

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>.

Cabeçalhos

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parâmetros de caminho

tool_set_id
string
obrigatório

Corpo

application/json
spec
obrigatório

O documento OpenAPI 3.0 ou 3.1, como um objeto ou como texto JSON ou YAML (no máximo 4 MiB).

Minimum string length: 1
name
string

Rótulo para o conjunto de ferramentas. O padrão é um slug do info.title do documento.

Pattern: ^[a-zA-Z0-9_-]{1,64}$
server_url
string

A URL base pública da API. Por padrão, é o primeiro servidor do documento, com as variáveis definidas para seus valores padrão.

Maximum string length: 2048
operations
string[]

operationIds a importar. O padrão é cada operação suportada (no máximo 128).

Required array length: 1 - 128 elements
Required string length: 1 - 64
mcp_server_id
string

Servidor do cofre de credenciais, registrado para a URL base da API, cuja credencial autentica todas as chamadas.

mcp_credential_id
string

Credencial de mcp_server_id a ser usada. Por padrão, a credencial ativa mais recente do servidor no momento da execução.

Resposta

Conjunto de ferramentas OpenAPI

object
enum<string>
obrigatório
Opções disponíveis:
agent.openapi_tool_set
id
string
obrigatório
name
string
obrigatório
title
string | null
obrigatório

O info.title do documento.

version
string | null
obrigatório

O info.version do documento.

definition
object
obrigatório

A definição de ferramenta normalizada enviada por uma execução do agente. Ela contém referências de credenciais, nunca os valores das credenciais.

skipped_operations
object[]
obrigatório

Operações do documento que não foram importadas e o motivo.

authentication
object[]
obrigatório

O que os esquemas de segurança do documento esperam que a credencial do cofre envie.

created_at
string<date-time>
obrigatório
updated_at
string<date-time>
obrigatório