Actualizar un agente

Python (SDK)

from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.agents.update_agent(agent_id="<id>", model="functionary-pt")

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.agents.updateAgent({
    agentId: "<id>",
    updateAgentRequest: {
      model: "functionary-pt",
    },
  });

  console.log(result);
}

run();

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Agents.UpdateAgentAsync(
    agentId: "<id>",
    body: new MeetKai.MKA1.Types.Components.UpdateAgentRequest() {
        Model = "functionary-pt",
    }
);

// handle response

curl --request POST \
  --url https://apigw.mka1.com/api/v1/agents/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "model": "functionary-pt",
  "instructions": "<string>",
  "tools": [
    {
      "type": "function_reference",
      "function_tool_id": "<string>"
    }
  ],
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "max_tool_calls": 150,
  "text": {
    "format": {}
  },
  "reasoning": {},
  "metadata": {}
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    model: 'functionary-pt',
    instructions: '<string>',
    tools: [{type: 'function_reference', function_tool_id: '<string>'}],
    tool_choice: '<unknown>',
    parallel_tool_calls: true,
    max_tool_calls: 150,
    text: {format: {}},
    reasoning: {},
    metadata: {}
  })
};

fetch('https://apigw.mka1.com/api/v1/agents/{agent_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/agents/{agent_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'model' => 'functionary-pt',
    'instructions' => '<string>',
    'tools' => [
        [
                'type' => 'function_reference',
                'function_tool_id' => '<string>'
        ]
    ],
    'tool_choice' => '<unknown>',
    'parallel_tool_calls' => true,
    'max_tool_calls' => 150,
    'text' => [
        'format' => [
                
        ]
    ],
    'reasoning' => [
        
    ],
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apigw.mka1.com/api/v1/agents/{agent_id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"model\": \"functionary-pt\",\n  \"instructions\": \"<string>\",\n  \"tools\": [\n    {\n      \"type\": \"function_reference\",\n      \"function_tool_id\": \"<string>\"\n    }\n  ],\n  \"tool_choice\": \"<unknown>\",\n  \"parallel_tool_calls\": true,\n  \"max_tool_calls\": 150,\n  \"text\": {\n    \"format\": {}\n  },\n  \"reasoning\": {},\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/agents/{agent_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"model\": \"functionary-pt\",\n  \"instructions\": \"<string>\",\n  \"tools\": [\n    {\n      \"type\": \"function_reference\",\n      \"function_tool_id\": \"<string>\"\n    }\n  ],\n  \"tool_choice\": \"<unknown>\",\n  \"parallel_tool_calls\": true,\n  \"max_tool_calls\": 150,\n  \"text\": {\n    \"format\": {}\n  },\n  \"reasoning\": {},\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/{agent_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"model\": \"functionary-pt\",\n  \"instructions\": \"<string>\",\n  \"tools\": [\n    {\n      \"type\": \"function_reference\",\n      \"function_tool_id\": \"<string>\"\n    }\n  ],\n  \"tool_choice\": \"<unknown>\",\n  \"parallel_tool_calls\": true,\n  \"max_tool_calls\": 150,\n  \"text\": {\n    \"format\": {}\n  },\n  \"reasoning\": {},\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "object": "agent",
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "model": "functionary-pt",
  "instructions": "<string>",
  "tools": [
    {
      "type": "function_reference",
      "function_tool_id": "<string>"
    }
  ],
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "max_tool_calls": 123,
  "text": {
    "format": {
      "type": "text"
    },
    "verbosity": "low"
  },
  "reasoning": {
    "effort": "low"
  },
  "metadata": {},
  "version": 2,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "deleted_at": "2023-11-07T05:31:56Z",
  "retention_expires_at": "2023-11-07T05:31:56Z",
  "within_restore_window": true,
  "can_restore": true
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  }
}

POST

api

agents

{agent_id}

Python (SDK)

from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.agents.update_agent(agent_id="<id>", model="functionary-pt")

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.agents.updateAgent({
    agentId: "<id>",
    updateAgentRequest: {
      model: "functionary-pt",
    },
  });

  console.log(result);
}

run();

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Agents.UpdateAgentAsync(
    agentId: "<id>",
    body: new MeetKai.MKA1.Types.Components.UpdateAgentRequest() {
        Model = "functionary-pt",
    }
);

// handle response

curl --request POST \
  --url https://apigw.mka1.com/api/v1/agents/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "model": "functionary-pt",
  "instructions": "<string>",
  "tools": [
    {
      "type": "function_reference",
      "function_tool_id": "<string>"
    }
  ],
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "max_tool_calls": 150,
  "text": {
    "format": {}
  },
  "reasoning": {},
  "metadata": {}
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    model: 'functionary-pt',
    instructions: '<string>',
    tools: [{type: 'function_reference', function_tool_id: '<string>'}],
    tool_choice: '<unknown>',
    parallel_tool_calls: true,
    max_tool_calls: 150,
    text: {format: {}},
    reasoning: {},
    metadata: {}
  })
};

fetch('https://apigw.mka1.com/api/v1/agents/{agent_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/agents/{agent_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'description' => '<string>',
    'model' => 'functionary-pt',
    'instructions' => '<string>',
    'tools' => [
        [
                'type' => 'function_reference',
                'function_tool_id' => '<string>'
        ]
    ],
    'tool_choice' => '<unknown>',
    'parallel_tool_calls' => true,
    'max_tool_calls' => 150,
    'text' => [
        'format' => [
                
        ]
    ],
    'reasoning' => [
        
    ],
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apigw.mka1.com/api/v1/agents/{agent_id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"model\": \"functionary-pt\",\n  \"instructions\": \"<string>\",\n  \"tools\": [\n    {\n      \"type\": \"function_reference\",\n      \"function_tool_id\": \"<string>\"\n    }\n  ],\n  \"tool_choice\": \"<unknown>\",\n  \"parallel_tool_calls\": true,\n  \"max_tool_calls\": 150,\n  \"text\": {\n    \"format\": {}\n  },\n  \"reasoning\": {},\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/agents/{agent_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"model\": \"functionary-pt\",\n  \"instructions\": \"<string>\",\n  \"tools\": [\n    {\n      \"type\": \"function_reference\",\n      \"function_tool_id\": \"<string>\"\n    }\n  ],\n  \"tool_choice\": \"<unknown>\",\n  \"parallel_tool_calls\": true,\n  \"max_tool_calls\": 150,\n  \"text\": {\n    \"format\": {}\n  },\n  \"reasoning\": {},\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/{agent_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"model\": \"functionary-pt\",\n  \"instructions\": \"<string>\",\n  \"tools\": [\n    {\n      \"type\": \"function_reference\",\n      \"function_tool_id\": \"<string>\"\n    }\n  ],\n  \"tool_choice\": \"<unknown>\",\n  \"parallel_tool_calls\": true,\n  \"max_tool_calls\": 150,\n  \"text\": {\n    \"format\": {}\n  },\n  \"reasoning\": {},\n  \"metadata\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "object": "agent",
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "model": "functionary-pt",
  "instructions": "<string>",
  "tools": [
    {
      "type": "function_reference",
      "function_tool_id": "<string>"
    }
  ],
  "tool_choice": "<unknown>",
  "parallel_tool_calls": true,
  "max_tool_calls": 123,
  "text": {
    "format": {
      "type": "text"
    },
    "verbosity": "low"
  },
  "reasoning": {
    "effort": "low"
  },
  "metadata": {},
  "version": 2,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "deleted_at": "2023-11-07T05:31:56Z",
  "retention_expires_at": "2023-11-07T05:31:56Z",
  "within_restore_window": true,
  "can_restore": true
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  }
}

Autorizaciones

Authorization

string

header

requerido

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

X-On-Behalf-Of

string

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

Parámetros de ruta

agent_id

string

requerido

Cuerpo

application/json

Actualiza solo los campos proporcionados. Los campos omitidos conservan sus valores guardados; las actualizaciones vacías se rechazan.

name

string

Required string length: 1 - 120

description

string | null

Maximum string length: 2000

model

string

Minimum string length: 1

Ejemplo:

"functionary-pt"

instructions

string | null

Maximum string length: 20000

tools

object[]

Configuración de herramientas para la creación o actualización de agentes. Shell container_auto acepta network_policy con tipo 'allowlist' y hasta 256 allowed_domains (nombres de host DNS); una lista vacía u omitida deniega todos los hosts externos. Esto restringe aún más las políticas del inquilino y del operador. Se rechazan los secretos de dominio, los campos de política desconocidos y cambiar una política container_reference. computer_use_preview no es compatible. Las respuestas históricas del agente y las versiones conservan sus campos de herramientas originales.

Show child attributes

tool_choice

any

Valor JSON arbitrario.

parallel_tool_calls

boolean

max_tool_calls

integer | null

Rango requerido: 1 <= x <= 300

text

object | null

Show child attributes

reasoning

object | null

Show child attributes

metadata

object

Show child attributes

Respuesta

Agente actualizado.

object

enum<string>

requerido

Opciones disponibles:

agent

string

requerido

name

string

requerido

description

string | null

requerido

model

string

requerido

Ejemplo:

"functionary-pt"

instructions

string | null

requerido

tools

object[]

requerido

Show child attributes

tool_choice

any

requerido

Valor JSON arbitrario.

parallel_tool_calls

boolean

requerido

max_tool_calls

integer | null

requerido

text

object | null

requerido

Show child attributes

reasoning

object | null

requerido

Show child attributes

metadata

object

requerido

Show child attributes

version

integer

requerido

Versión de configuración actual. Incrementada en cada actualización o retroceso.

Rango requerido: x >= 1

created_at

string<date-time>

requerido

updated_at

string<date-time>

requerido

deleted_at

string<date-time> | null

requerido

retention_expires_at

string<date-time> | null

requerido

within_restore_window

boolean

requerido

Si el agente eliminado está dentro de su plazo de restauración fijado, independientemente del permiso del llamante.

can_restore

boolean

requerido

Si la persona que llama actualmente tiene permiso de restauración dentro del plazo fijado.

⌘I

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Actualizar un agente

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta