Agent Runs

Continuar una ejecución después de que sus aprobadores hayan decidido

Continúa la ejecución del agente a la que pertenece una llamada de herramienta retenida, una vez que los aprobadores de los nombres de la política de herramientas de la organización hayan decidido cada llamada retenida de esa ejecución en la cola de aprobación. Llámalo después de registrar una decisión allí; este endpoint no registra ninguna y no recibe cuerpo. El llamante debe poder leer la aprobación: el llamante cuya ejecución fue retenida, o uno de sus aprobadores con sesión iniciada en la misma organización. De lo contrario, la respuesta es 404 con el código de error tool_approval_not_found. Una llamada retenida que no fue realizada por ninguna ejecución de agente devuelve 404 con el código de error not_an_agent_run. Mientras cualquier llamada de la ejecución siga sin decidirse, incluida una sin aprobadores que solo el llamante de la ejecución puede decidir, la respuesta tiene estado waiting y no crea nada. Una vez que todas estén decididas, se crea una ejecución de continuación con la identidad del llamante de la ejecución y realiza cada decisión registrada; las aprobaciones expiradas se omiten. Repetir la solicitud, o que dos aprobadores terminen al mismo tiempo, devuelve la misma ejecución de continuación. Cuando todas las aprobaciones han expirado, la respuesta es 409 con el código de error tool_approval_expired. La ejecución de continuación es una ejecución ordinaria del agente: no se entrega a la conversación del conector ni a la sesión de chat web que inició la ejecución retenida.

POST

api

agents

tool-approvals

{approval_request_id}

resume

CSharp (SDK)

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

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

var res = await sdk.AgentRuns.ResumeAgentRunToolApprovalAsync(approvalRequestId: "<id>");

// handle response

from meetkai_mka1 import SDK


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

    res = sdk.agent_runs.resume_agent_run_tool_approval(approval_request_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.agentRuns.resumeAgentRunToolApproval({
    approvalRequestId: "<id>",
  });

  console.log(result);
}

run();

package main

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

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

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

    res, err := s.AgentRuns.ResumeAgentRunToolApproval(ctx, "<id>", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentRunApprovalResume != nil {
        // handle response
    }
}

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume', 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/tool-approvals/{approval_request_id}/resume",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "object": "agent.run.approval_resume",
  "status": "waiting",
  "source_run_id": "<string>",
  "pending": 2,
  "continuation_run": {
    "object": "agent.run",
    "id": "<string>",
    "agent_id": "<string>",
    "agent_version": 2,
    "status": "waiting",
    "input": "<unknown>",
    "conversation": "<unknown>",
    "previous_response_id": "<string>",
    "metadata": {},
    "gateway_response_id": "<string>",
    "gateway_response": "<unknown>",
    "error": "<unknown>",
    "pending_approvals": [
      {
        "id": "<string>",
        "kind": "mcp_approval_request",
        "tool_type": "<string>",
        "name": "<string>",
        "server_label": "<string>",
        "arguments": "<string>"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z"
  }
}

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

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

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

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

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

{
  "error": {
    "message": "<string>",
    "code": "<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

approval_request_id

string

requerido

ID of a held tool call, as the approval queue lists it.

Respuesta

La ejecución sigue esperando decisiones, o fue continuada.

object

enum<string>

requerido

Opciones disponibles:

agent.run.approval_resume

status

enum<string>

requerido

esperando mientras una llamada retenida de la ejecución está sin decidir, con el recuento en pending; reanudado una vez que la ejecución se continuó, con la nueva ejecución en continuation_run.

Opciones disponibles:

waiting,

resumed

source_run_id

string

requerido

La ejecución que se detuvo para su aprobación.

pending

integer

¿Cuántas llamadas en espera de la ejecución no están decididas? Presente cuando el estado es en espera.

Rango requerido: x >= 1

continuation_run

object

Show child attributes

⌘I

CSharp (SDK)

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

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

var res = await sdk.AgentRuns.ResumeAgentRunToolApprovalAsync(approvalRequestId: "<id>");

// handle response

from meetkai_mka1 import SDK


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

    res = sdk.agent_runs.resume_agent_run_tool_approval(approval_request_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.agentRuns.resumeAgentRunToolApproval({
    approvalRequestId: "<id>",
  });

  console.log(result);
}

run();

package main

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

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

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

    res, err := s.AgentRuns.ResumeAgentRunToolApproval(ctx, "<id>", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentRunApprovalResume != nil {
        // handle response
    }
}

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume', 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/tool-approvals/{approval_request_id}/resume",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "object": "agent.run.approval_resume",
  "status": "waiting",
  "source_run_id": "<string>",
  "pending": 2,
  "continuation_run": {
    "object": "agent.run",
    "id": "<string>",
    "agent_id": "<string>",
    "agent_version": 2,
    "status": "waiting",
    "input": "<unknown>",
    "conversation": "<unknown>",
    "previous_response_id": "<string>",
    "metadata": {},
    "gateway_response_id": "<string>",
    "gateway_response": "<unknown>",
    "error": "<unknown>",
    "pending_approvals": [
      {
        "id": "<string>",
        "kind": "mcp_approval_request",
        "tool_type": "<string>",
        "name": "<string>",
        "server_label": "<string>",
        "arguments": "<string>"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z"
  }
}

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

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

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

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

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

{
  "error": {
    "message": "<string>",
    "code": "<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

Continuar una ejecución después de que sus aprobadores hayan decidido

Autorizaciones

Encabezados

Parámetros de ruta

Respuesta