Audit
Obter um rastreamento da solicitação
Retorna o trace ponta a ponta de uma solicitação de API: seu tempo de resposta no gateway da API, cada resposta que ela criou (incluindo os agentes que chamou) e as invocações de modelo e chamadas de ferramentas de cada resposta, com suas durações. Consulte pelo X-Request-ID retornado em cada resposta ou pelo próprio ID de solicitação do gateway da API. Apenas proprietários e administradores da organização, restrito à sua própria organização. Solicitações auditadas antes de os IDs de solicitação serem registrados mostram o tempo do gateway, mas não as respostas.
GET
/
api
/
v1
/
llm
/
audit
/
requests
/
{request_id}
/
trace
CSharp (SDK)
using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;
var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
var res = await sdk.Llm.Audit.GetRequestTraceAsync(requestId: "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12");
// handle responsefrom meetkai_mka1 import SDK
with SDK(
bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:
res = sdk.llm.audit.get_request_trace(request_id="3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12")
# 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.llm.audit.getRequestTrace({
requestId: "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
});
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.Llm.Audit.GetRequestTrace(ctx, "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12")
if err != nil {
log.Fatal(err)
}
if res.Object != nil {
// handle response
}
}curl --request GET \
--url https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace', 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/llm/audit/requests/{request_id}/trace",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
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;
}HttpResponse<String> response = Unirest.get("https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "audit.request_trace",
"request_id": "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
"truncated": false,
"gateway": [
{
"kong_request_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"request_id": "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
"correlation_id": "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
"trace_id": null,
"method": "POST",
"path": "/api/v1/llm/responses",
"status_code": 200,
"started_at": "2026-10-26T00:00:00.000Z",
"completed_at": "2026-10-26T00:00:03.000Z",
"latency_ms": 3000,
"gateway_latency_ms": 2,
"upstream_latency_ms": 2990
}
],
"responses": [
{
"response_id": "resp_0a1b2c3d",
"parent_response_id": null,
"conversation_id": null,
"status": "completed",
"requested_model": "auto",
"effective_model": "meetkai:functionary-urdu-mini-pak",
"started_at": "2026-10-26T00:00:00.100Z",
"completed_at": "2026-10-26T00:00:02.900Z",
"duration_ms": 2800,
"spans": [
{
"kind": "model",
"name": "meetkai:functionary-urdu-mini-pak",
"call_id": null,
"step": 1,
"attempt": 1,
"status": "completed",
"started_at": "2026-10-26T00:00:00.200Z",
"completed_at": "2026-10-26T00:00:01.200Z",
"duration_ms": 1000
},
{
"kind": "tool",
"name": "web_search",
"call_id": "call_4e5f6a7b",
"step": null,
"attempt": null,
"status": "completed",
"started_at": "2026-10-26T00:00:01.300Z",
"completed_at": "2026-10-26T00:00:01.800Z",
"duration_ms": 500
}
]
}
]
}Autorizações
Parâmetros de caminho
Resposta
200 - application/json
OK
End-to-end trace of one API request
Esta página foi útil?
⌘I
CSharp (SDK)
using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;
var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");
var res = await sdk.Llm.Audit.GetRequestTraceAsync(requestId: "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12");
// handle responsefrom meetkai_mka1 import SDK
with SDK(
bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:
res = sdk.llm.audit.get_request_trace(request_id="3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12")
# 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.llm.audit.getRequestTrace({
requestId: "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
});
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.Llm.Audit.GetRequestTrace(ctx, "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12")
if err != nil {
log.Fatal(err)
}
if res.Object != nil {
// handle response
}
}curl --request GET \
--url https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace', 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/llm/audit/requests/{request_id}/trace",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
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;
}HttpResponse<String> response = Unirest.get("https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apigw.mka1.com/api/v1/llm/audit/requests/{request_id}/trace")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "audit.request_trace",
"request_id": "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
"truncated": false,
"gateway": [
{
"kong_request_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"request_id": "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
"correlation_id": "3f6c1b2e-8d4a-4c1e-9b7f-2a5d6e8f9c01#12",
"trace_id": null,
"method": "POST",
"path": "/api/v1/llm/responses",
"status_code": 200,
"started_at": "2026-10-26T00:00:00.000Z",
"completed_at": "2026-10-26T00:00:03.000Z",
"latency_ms": 3000,
"gateway_latency_ms": 2,
"upstream_latency_ms": 2990
}
],
"responses": [
{
"response_id": "resp_0a1b2c3d",
"parent_response_id": null,
"conversation_id": null,
"status": "completed",
"requested_model": "auto",
"effective_model": "meetkai:functionary-urdu-mini-pak",
"started_at": "2026-10-26T00:00:00.100Z",
"completed_at": "2026-10-26T00:00:02.900Z",
"duration_ms": 2800,
"spans": [
{
"kind": "model",
"name": "meetkai:functionary-urdu-mini-pak",
"call_id": null,
"step": 1,
"attempt": 1,
"status": "completed",
"started_at": "2026-10-26T00:00:00.200Z",
"completed_at": "2026-10-26T00:00:01.200Z",
"duration_ms": 1000
},
{
"kind": "tool",
"name": "web_search",
"call_id": "call_4e5f6a7b",
"step": null,
"attempt": null,
"status": "completed",
"started_at": "2026-10-26T00:00:01.300Z",
"completed_at": "2026-10-26T00:00:01.800Z",
"duration_ms": 500
}
]
}
]
}