Atualizar um agente

Typescript (SDK)

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

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)

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": [
    {
      "user_location": {
        "type": "approximate",
        "city": "<string>",
        "country": "<string>",
        "region": "<string>",
        "timezone": "<string>"
      },
      "filters": {
        "allowed_domains": [
          "<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: [
      {
        user_location: {
          type: 'approximate',
          city: '<string>',
          country: '<string>',
          region: '<string>',
          timezone: '<string>'
        },
        filters: {allowed_domains: ['<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' => [
        [
                'user_location' => [
                                'type' => 'approximate',
                                'city' => '<string>',
                                'country' => '<string>',
                                'region' => '<string>',
                                'timezone' => '<string>'
                ],
                'filters' => [
                                'allowed_domains' => [
                                                                '<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      \"user_location\": {\n        \"type\": \"approximate\",\n        \"city\": \"<string>\",\n        \"country\": \"<string>\",\n        \"region\": \"<string>\",\n        \"timezone\": \"<string>\"\n      },\n      \"filters\": {\n        \"allowed_domains\": [\n          \"<string>\"\n        ]\n      }\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      \"user_location\": {\n        \"type\": \"approximate\",\n        \"city\": \"<string>\",\n        \"country\": \"<string>\",\n        \"region\": \"<string>\",\n        \"timezone\": \"<string>\"\n      },\n      \"filters\": {\n        \"allowed_domains\": [\n          \"<string>\"\n        ]\n      }\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      \"user_location\": {\n        \"type\": \"approximate\",\n        \"city\": \"<string>\",\n        \"country\": \"<string>\",\n        \"region\": \"<string>\",\n        \"timezone\": \"<string>\"\n      },\n      \"filters\": {\n        \"allowed_domains\": [\n          \"<string>\"\n        ]\n      }\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": "web_search",
      "search_context_size": "low",
      "user_location": {
        "type": "approximate",
        "city": "<string>",
        "country": "<string>",
        "region": "<string>",
        "timezone": "<string>"
      },
      "filters": {
        "allowed_domains": [
          "<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"
}

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

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

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

POST

api

agents

{agent_id}

Typescript (SDK)

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

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)

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": [
    {
      "user_location": {
        "type": "approximate",
        "city": "<string>",
        "country": "<string>",
        "region": "<string>",
        "timezone": "<string>"
      },
      "filters": {
        "allowed_domains": [
          "<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: [
      {
        user_location: {
          type: 'approximate',
          city: '<string>',
          country: '<string>',
          region: '<string>',
          timezone: '<string>'
        },
        filters: {allowed_domains: ['<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' => [
        [
                'user_location' => [
                                'type' => 'approximate',
                                'city' => '<string>',
                                'country' => '<string>',
                                'region' => '<string>',
                                'timezone' => '<string>'
                ],
                'filters' => [
                                'allowed_domains' => [
                                                                '<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      \"user_location\": {\n        \"type\": \"approximate\",\n        \"city\": \"<string>\",\n        \"country\": \"<string>\",\n        \"region\": \"<string>\",\n        \"timezone\": \"<string>\"\n      },\n      \"filters\": {\n        \"allowed_domains\": [\n          \"<string>\"\n        ]\n      }\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      \"user_location\": {\n        \"type\": \"approximate\",\n        \"city\": \"<string>\",\n        \"country\": \"<string>\",\n        \"region\": \"<string>\",\n        \"timezone\": \"<string>\"\n      },\n      \"filters\": {\n        \"allowed_domains\": [\n          \"<string>\"\n        ]\n      }\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      \"user_location\": {\n        \"type\": \"approximate\",\n        \"city\": \"<string>\",\n        \"country\": \"<string>\",\n        \"region\": \"<string>\",\n        \"timezone\": \"<string>\"\n      },\n      \"filters\": {\n        \"allowed_domains\": [\n          \"<string>\"\n        ]\n      }\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": "web_search",
      "search_context_size": "low",
      "user_location": {
        "type": "approximate",
        "city": "<string>",
        "country": "<string>",
        "region": "<string>",
        "timezone": "<string>"
      },
      "filters": {
        "allowed_domains": [
          "<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"
}

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

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

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

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

agent_id

string

obrigatório

Corpo

application/json

Atualiza apenas os campos fornecidos. Os campos omitidos preservam seus valores salvos; atualizações vazias são rejeitadas.

name

string

Required string length: 1 - 120

description

string | null

Maximum string length: 2000

model

string

Minimum string length: 1

Exemplo:

"functionary-pt"

instructions

string | null

Maximum string length: 20000

tools

object[]

Configuração da ferramenta para criação ou atualização de agente. Shell container_auto aceita network_policy com tipo 'allowlist' e até 256 allowed_domains (nomes de host DNS); uma lista vazia ou omitida nega todos os hosts externos. Isso restringe ainda mais as políticas do locatário e do operador. Segredos de domínio, campos de política desconhecidos e a alteração de uma política container_reference são rejeitados. computer_use_preview não é suportado. Respostas históricas de agentes e versões mantêm seus campos de ferramenta originais.

Show child attributes

tool_choice

any

Valor JSON arbitrário.

parallel_tool_calls

boolean

max_tool_calls

integer | null

Intervalo obrigatório: 1 <= x <= 300

text

object | null

Show child attributes

reasoning

object | null

Show child attributes

metadata

object

Show child attributes

Resposta

Agente atualizado.

object

enum<string>

obrigatório

Opções disponíveis:

agent

string

obrigatório

name

string

obrigatório

description

string | null

obrigatório

model

string

obrigatório

Exemplo:

"functionary-pt"

instructions

string | null

obrigatório

tools

object[]

obrigatório

Show child attributes

tool_choice

any

obrigatório

Valor JSON arbitrário.

parallel_tool_calls

boolean

obrigatório

max_tool_calls

integer | null

obrigatório

text

object | null

obrigatório

Show child attributes

reasoning

object | null

obrigatório

Show child attributes

metadata

object

obrigatório

Show child attributes

version

integer

obrigatório

Versão da configuração atual. Incrementada a cada atualização ou reversão.

Intervalo obrigatório: x >= 1

created_at

string<date-time>

obrigatório

updated_at

string<date-time>

obrigatório

deleted_at

string<date-time> | null

obrigatório

⌘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

Atualizar um agente

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta