Agent Runs

Continuar uma execução depois que seus aprovadores decidiram

Continua a execução do agente a que pertence uma chamada de ferramenta retida, assim que os aprovadores dos nomes de política de ferramenta da organização tiverem decidido cada chamada retida dessa execução na fila de aprovação. Chame este endpoint depois de registrar uma decisão lá; este endpoint não registra nenhuma e não recebe corpo. O chamador deve ser capaz de ler a aprovação: o chamador cuja execução foi retida, ou um de seus aprovadores autenticado na mesma organização. Caso contrário, a resposta é 404 com o código de erro tool_approval_not_found. Uma chamada retida que não foi feita por nenhuma execução de agente retorna 404 com o código de erro not_an_agent_run. Enquanto qualquer chamada da execução estiver indecisa, incluindo uma sem aprovadores que apenas o chamador da execução pode decidir, a resposta tem status waiting e não cria nada. Assim que todas forem decididas, uma execução de continuação é criada com a identidade do chamador da execução e executa cada decisão registrada; aprovações expiradas são ignoradas. Repetir a solicitação, ou dois aprovadores concluindo ao mesmo tempo, retorna a mesma execução de continuação. Quando toda aprovação tiver expirado, a resposta é 409 com o código de erro tool_approval_expired. A continuação é uma execução обычная do agente: ela não é entregue à conversa do conector nem à sessão de chat na web que iniciou a execução retida.

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>"
  }
}

Autorizações

Authorization

string

header

obrigatório

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.

Cabeçalhos

X-On-Behalf-Of

string

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

Parâmetros de caminho

approval_request_id

string

obrigatório

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

Resposta

A execução ainda está aguardando decisões, ou foi continuada.

object

enum<string>

obrigatório

Opções disponíveis:

agent.run.approval_resume

status

enum<string>

obrigatório

aguardando enquanto uma chamada retida da execução está indefinida, com a contagem em pending; retomado assim que a execução foi continuada, com a nova execução em continuation_run.

Opções disponíveis:

waiting,

resumed

source_run_id

string

obrigatório

A execução que foi interrompida para aprovação.

pending

integer

Quantas chamadas retidas da execução estão sem decisão. Presente quando o status está aguardando.

Intervalo obrigatório: 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 uma execução depois que seus aprovadores decidiram

Autorizações

Cabeçalhos

Parâmetros de caminho

Resposta