Actualizar un horario de agente

POST

api

agents

{agent_id}

schedules

{schedule_id}

CSharp (SDK)

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

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

var res = await sdk.AgentSchedules.UpdateAgentScheduleAsync(
    agentId: "<id>",
    scheduleId: "<id>",
    body: new MeetKai.MKA1.Types.Components.UpdateAgentScheduleRequest() {}
);

// handle response

from meetkai_mka1 import SDK


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

    res = sdk.agent_schedules.update_agent_schedule(agent_id="<id>", schedule_id="<id>")

    # 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.agentSchedules.updateAgentSchedule({
    agentId: "<id>",
    scheduleId: "<id>",
    updateAgentScheduleRequest: {},
  });

  console.log(result);
}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"github.com/MeetKai/mka1-sdks/go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.AgentSchedules.UpdateAgentSchedule(ctx, "<id>", "<id>", components.UpdateAgentScheduleRequest{}, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentSchedule != nil {
        switch res.AgentSchedule.Schedule.Type {
            case components.AgentScheduleSpecTypeOnce:
                // res.AgentSchedule.Schedule.AgentScheduleSpecOnce is populated
            case components.AgentScheduleSpecTypeInterval:
                // res.AgentSchedule.Schedule.AgentScheduleSpecInterval is populated
            case components.AgentScheduleSpecTypeCron:
                // res.AgentSchedule.Schedule.AgentScheduleSpecCron is populated
            default:
                // Unknown type - use res.AgentSchedule.Schedule.GetUnknownRaw() for raw JSON
        }

    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "schedule": {
    "type": "once",
    "run_at": "2023-11-07T05:31:56Z",
    "timezone": "UTC"
  },
  "input": "<string>",
  "conversation": "<unknown>",
  "previous_response_id": "<string>",
  "context_management": [
    {
      "type": "compaction",
      "compact_threshold": 1001
    }
  ],
  "metadata": {}
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    schedule: {type: 'once', run_at: '2023-11-07T05:31:56Z', timezone: 'UTC'},
    input: '<string>',
    conversation: '<unknown>',
    previous_response_id: '<string>',
    context_management: [{type: 'compaction', compact_threshold: 1001}],
    metadata: {}
  })
};

fetch('https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_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}/schedules/{schedule_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>',
    'schedule' => [
        'type' => 'once',
        'run_at' => '2023-11-07T05:31:56Z',
        'timezone' => 'UTC'
    ],
    'input' => '<string>',
    'conversation' => '<unknown>',
    'previous_response_id' => '<string>',
    'context_management' => [
        [
                'type' => 'compaction',
                'compact_threshold' => 1001
        ]
    ],
    '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;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"schedule\": {\n    \"type\": \"once\",\n    \"run_at\": \"2023-11-07T05:31:56Z\",\n    \"timezone\": \"UTC\"\n  },\n  \"input\": \"<string>\",\n  \"conversation\": \"<unknown>\",\n  \"previous_response_id\": \"<string>\",\n  \"context_management\": [\n    {\n      \"type\": \"compaction\",\n      \"compact_threshold\": 1001\n    }\n  ],\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_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  \"schedule\": {\n    \"type\": \"once\",\n    \"run_at\": \"2023-11-07T05:31:56Z\",\n    \"timezone\": \"UTC\"\n  },\n  \"input\": \"<string>\",\n  \"conversation\": \"<unknown>\",\n  \"previous_response_id\": \"<string>\",\n  \"context_management\": [\n    {\n      \"type\": \"compaction\",\n      \"compact_threshold\": 1001\n    }\n  ],\n  \"metadata\": {}\n}"

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

{
  "object": "agent.schedule",
  "id": "<string>",
  "agent_id": "<string>",
  "name": "<string>",
  "status": "active",
  "schedule": {
    "type": "once",
    "run_at": "2023-11-07T05:31:56Z",
    "timezone": "UTC"
  },
  "input": "<unknown>",
  "conversation": "<unknown>",
  "previous_response_id": "<string>",
  "context_management": [
    {
      "type": "compaction",
      "compact_threshold": 1001
    }
  ],
  "metadata": {},
  "temporal_schedule_id": "<string>",
  "last_run_at": "2023-11-07T05:31:56Z",
  "last_run_id": "<string>",
  "last_run_status": "<string>",
  "last_error": "<string>",
  "next_run_at": "2023-11-07T05:31:56Z",
  "stalled": true,
  "run_count": 123,
  "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>"
  }
}

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

Autorizaciones

Authorization

string

header

requerido

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Encabezados

X-On-Behalf-Of

string

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

Parámetros de ruta

agent_id

string

requerido

schedule_id

string

requerido

Cuerpo

application/json

name

string | null

Required string length: 1 - 120

schedule

object

Option 1
Option 2
Option 3

Show child attributes

input

Required string length: 1 - 20000

conversation

any | null

Valor JSON arbitrario.

previous_response_id

string | null

context_management

object[] | null

Estrategias de gestión del contexto a aplicar durante la generación de respuestas gestionadas por el agente. Establecer en nulo para limpiar las estrategias a nivel de programación.

Show child attributes

metadata

object

Show child attributes

Respuesta

Horario actualizado.

object

enum<string>

requerido

Opciones disponibles:

agent.schedule

string

requerido

agent_id

string

requerido

name

string | null

requerido

status

enum<string>

requerido

Opciones disponibles:

active,

paused,

completed,

deleted

schedule

object

requerido

Option 1
Option 2
Option 3

Show child attributes

input

any

requerido

Valor JSON arbitrario.

conversation

any | null

requerido

Valor JSON arbitrario.

previous_response_id

string | null

requerido

context_management

object[] | null

requerido

Show child attributes

metadata

object | null

requerido

Show child attributes

temporal_schedule_id

string | null

requerido

last_run_at

string<date-time> | null

requerido

last_run_id

string | null

requerido

last_run_status

string | null

requerido

Resultado de la ocurrencia más reciente: el estado de la ejecución creada (se actualiza cuando la ejecución termina), se omite cuando no se creó ninguna ejecución (programación huérfana o límite de concurrencia), o falla cuando la ocurrencia agotó sus reintentos. Una ocurrencia que no creó ninguna ejecución borra last_run_id. Nulo antes de la primera ocurrencia.

last_error

string | null

requerido

Mensaje de error de la ocurrencia más reciente, o null cuando produjo una ejecución sin error.

next_run_at

string<date-time> | null

requerido

La próxima hora de ejecución que informa Temporal, o null cuando no haya ninguna programada o no se pueda contactar con Temporal.

stalled

boolean | null

requerido

Verdadero cuando el estado está activo pero Temporal no tiene un horario para él, lo tiene pausado o no informa de ninguna próxima activación; falso en caso contrario; nulo cuando no se pudo consultar a Temporal.

run_count

integer

requerido

created_at

string<date-time>

requerido

updated_at

string<date-time>

requerido

deleted_at

string<date-time> | null

requerido

⌘I

CSharp (SDK)

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

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

var res = await sdk.AgentSchedules.UpdateAgentScheduleAsync(
    agentId: "<id>",
    scheduleId: "<id>",
    body: new MeetKai.MKA1.Types.Components.UpdateAgentScheduleRequest() {}
);

// handle response

from meetkai_mka1 import SDK


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

    res = sdk.agent_schedules.update_agent_schedule(agent_id="<id>", schedule_id="<id>")

    # 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.agentSchedules.updateAgentSchedule({
    agentId: "<id>",
    scheduleId: "<id>",
    updateAgentScheduleRequest: {},
  });

  console.log(result);
}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"github.com/MeetKai/mka1-sdks/go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.AgentSchedules.UpdateAgentSchedule(ctx, "<id>", "<id>", components.UpdateAgentScheduleRequest{}, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentSchedule != nil {
        switch res.AgentSchedule.Schedule.Type {
            case components.AgentScheduleSpecTypeOnce:
                // res.AgentSchedule.Schedule.AgentScheduleSpecOnce is populated
            case components.AgentScheduleSpecTypeInterval:
                // res.AgentSchedule.Schedule.AgentScheduleSpecInterval is populated
            case components.AgentScheduleSpecTypeCron:
                // res.AgentSchedule.Schedule.AgentScheduleSpecCron is populated
            default:
                // Unknown type - use res.AgentSchedule.Schedule.GetUnknownRaw() for raw JSON
        }

    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "schedule": {
    "type": "once",
    "run_at": "2023-11-07T05:31:56Z",
    "timezone": "UTC"
  },
  "input": "<string>",
  "conversation": "<unknown>",
  "previous_response_id": "<string>",
  "context_management": [
    {
      "type": "compaction",
      "compact_threshold": 1001
    }
  ],
  "metadata": {}
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    schedule: {type: 'once', run_at: '2023-11-07T05:31:56Z', timezone: 'UTC'},
    input: '<string>',
    conversation: '<unknown>',
    previous_response_id: '<string>',
    context_management: [{type: 'compaction', compact_threshold: 1001}],
    metadata: {}
  })
};

fetch('https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_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}/schedules/{schedule_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>',
    'schedule' => [
        'type' => 'once',
        'run_at' => '2023-11-07T05:31:56Z',
        'timezone' => 'UTC'
    ],
    'input' => '<string>',
    'conversation' => '<unknown>',
    'previous_response_id' => '<string>',
    'context_management' => [
        [
                'type' => 'compaction',
                'compact_threshold' => 1001
        ]
    ],
    '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;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"schedule\": {\n    \"type\": \"once\",\n    \"run_at\": \"2023-11-07T05:31:56Z\",\n    \"timezone\": \"UTC\"\n  },\n  \"input\": \"<string>\",\n  \"conversation\": \"<unknown>\",\n  \"previous_response_id\": \"<string>\",\n  \"context_management\": [\n    {\n      \"type\": \"compaction\",\n      \"compact_threshold\": 1001\n    }\n  ],\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/{agent_id}/schedules/{schedule_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  \"schedule\": {\n    \"type\": \"once\",\n    \"run_at\": \"2023-11-07T05:31:56Z\",\n    \"timezone\": \"UTC\"\n  },\n  \"input\": \"<string>\",\n  \"conversation\": \"<unknown>\",\n  \"previous_response_id\": \"<string>\",\n  \"context_management\": [\n    {\n      \"type\": \"compaction\",\n      \"compact_threshold\": 1001\n    }\n  ],\n  \"metadata\": {}\n}"

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

{
  "object": "agent.schedule",
  "id": "<string>",
  "agent_id": "<string>",
  "name": "<string>",
  "status": "active",
  "schedule": {
    "type": "once",
    "run_at": "2023-11-07T05:31:56Z",
    "timezone": "UTC"
  },
  "input": "<unknown>",
  "conversation": "<unknown>",
  "previous_response_id": "<string>",
  "context_management": [
    {
      "type": "compaction",
      "compact_threshold": 1001
    }
  ],
  "metadata": {},
  "temporal_schedule_id": "<string>",
  "last_run_at": "2023-11-07T05:31:56Z",
  "last_run_id": "<string>",
  "last_run_status": "<string>",
  "last_error": "<string>",
  "next_run_at": "2023-11-07T05:31:56Z",
  "stalled": true,
  "run_count": 123,
  "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>"
  }
}

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

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 horario de agente

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta