Get Remediation Plan
curl --request GET \
--url {scheme}://{host}:{port}/{basePath}/remediations/{name} \
--header 'X-API-Key: <api-key>'import requests
url = "{scheme}://{host}:{port}/{basePath}/remediations/{name}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('{scheme}://{host}:{port}/{basePath}/remediations/{name}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "62437",
CURLOPT_URL => "{scheme}://{host}:{port}/{basePath}/remediations/{name}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "{scheme}://{host}:{port}/{basePath}/remediations/{name}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("{scheme}://{host}:{port}/{basePath}/remediations/{name}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("{scheme}://{host}:{port}/{basePath}/remediations/{name}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"apiVersion": "v1",
"kind": "RemediationPlan",
"resourceMeta": {
"name": "checkout-api-error-rate-1773932940-plan-1",
"namespace": "production",
"uid": "0f1e2d3c-4b5a-4968-8776-655443322110",
"creationTimestamp": "2026-03-19T15:09:00Z",
"labels": {}
},
"spec": {
"name": "checkout-api-error-rate-1773932940-plan-1",
"namespace": "production",
"issueRef": "checkout-api-error-rate-1773932940",
"attempt": 1,
"strategy": "Agentic AI-driven remediation",
"state": "Completed",
"startedAt": "2026-03-19T15:10:00Z",
"completedAt": "2026-03-19T15:16:00Z",
"result": "Issue resolved after 4 agentic steps",
"agenticMode": true,
"agenticStepCount": 4,
"creationTimestamp": "2026-03-19T15:09:00Z",
"safetyConstraints": [
"Do not scale below current replica count",
"Verify health for 90 seconds after each action"
],
"evidence": [
{
"type": "action_completed",
"data": "ScaleDeployment executed: replicas 3 -> 5",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"type": "verification_passed",
"data": "All 5/5 pods ready after 45 seconds",
"timestamp": "2026-03-19T15:12:30Z"
}
],
"rollbackPerformed": false,
"agenticHistory": [
{
"stepNumber": 1,
"aiMessage": "The deployment has 3 replicas but CPU usage is at 95%. The error rate spike correlates with high CPU. I'll scale up to reduce per-pod load.",
"action": {
"type": "ScaleDeployment",
"params": {
"replicas": "5"
}
},
"observation": "ScaleDeployment executed successfully. New pods are starting.",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"stepNumber": 2,
"aiMessage": "Pods are starting. Let me observe the metrics to verify the scale-up is helping.",
"observation": "5/5 pods ready. CPU usage dropped to 62%. Error rate decreasing.",
"timestamp": "2026-03-19T15:12:30Z"
},
{
"stepNumber": 3,
"aiMessage": "CPU is now at safe levels and error rate is dropping. I'll also adjust the HPA to prevent this from happening again.",
"action": {
"type": "AdjustHPA",
"params": {
"maxReplicas": "8",
"targetCPUUtilization": "70"
}
},
"observation": "HPA updated. maxReplicas=8, targetCPUUtilization=70%.",
"timestamp": "2026-03-19T15:14:00Z"
},
{
"stepNumber": 4,
"aiMessage": "The deployment is stable with healthy CPU usage and zero errors. Issue resolved.",
"observation": "Health verified: all pods ready, error rate 0%, CPU 58%.",
"timestamp": "2026-03-19T15:16:00Z"
}
]
},
"status": {
"state": "Completed",
"startedAt": "2026-03-19T15:10:00Z",
"actionsCompletedAt": "2026-03-19T15:14:00Z",
"completedAt": "2026-03-19T15:16:00Z",
"result": "Issue resolved after 4 agentic steps",
"evidence": [
{
"type": "action_completed",
"data": "ScaleDeployment executed: replicas 3 -> 5",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"type": "verification_passed",
"data": "All 5/5 pods ready after 45 seconds",
"timestamp": "2026-03-19T15:12:30Z"
}
],
"agenticStepCount": 4,
"agenticStartedAt": "2026-03-19T15:10:00Z",
"preflightSnapshot": {
"resourceKind": "Deployment",
"resourceName": "checkout-api",
"namespace": "production",
"replicas": 3,
"containerImages": {
"app": "registry.example.com/checkout-api:v2.1.0"
},
"hpaMinReplicas": 2,
"hpaMaxReplicas": 5
}
}
}
Remediations
Obter Plano de Remediação
Retorna os detalhes completos do plano de remediação, incluindo evidências de execução, informações de rollback, restrições de segurança e histórico de conversação agêntica
GET
/
remediations
/
{name}
Get Remediation Plan
curl --request GET \
--url {scheme}://{host}:{port}/{basePath}/remediations/{name} \
--header 'X-API-Key: <api-key>'import requests
url = "{scheme}://{host}:{port}/{basePath}/remediations/{name}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('{scheme}://{host}:{port}/{basePath}/remediations/{name}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "62437",
CURLOPT_URL => "{scheme}://{host}:{port}/{basePath}/remediations/{name}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "{scheme}://{host}:{port}/{basePath}/remediations/{name}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("{scheme}://{host}:{port}/{basePath}/remediations/{name}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("{scheme}://{host}:{port}/{basePath}/remediations/{name}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"apiVersion": "v1",
"kind": "RemediationPlan",
"resourceMeta": {
"name": "checkout-api-error-rate-1773932940-plan-1",
"namespace": "production",
"uid": "0f1e2d3c-4b5a-4968-8776-655443322110",
"creationTimestamp": "2026-03-19T15:09:00Z",
"labels": {}
},
"spec": {
"name": "checkout-api-error-rate-1773932940-plan-1",
"namespace": "production",
"issueRef": "checkout-api-error-rate-1773932940",
"attempt": 1,
"strategy": "Agentic AI-driven remediation",
"state": "Completed",
"startedAt": "2026-03-19T15:10:00Z",
"completedAt": "2026-03-19T15:16:00Z",
"result": "Issue resolved after 4 agentic steps",
"agenticMode": true,
"agenticStepCount": 4,
"creationTimestamp": "2026-03-19T15:09:00Z",
"safetyConstraints": [
"Do not scale below current replica count",
"Verify health for 90 seconds after each action"
],
"evidence": [
{
"type": "action_completed",
"data": "ScaleDeployment executed: replicas 3 -> 5",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"type": "verification_passed",
"data": "All 5/5 pods ready after 45 seconds",
"timestamp": "2026-03-19T15:12:30Z"
}
],
"rollbackPerformed": false,
"agenticHistory": [
{
"stepNumber": 1,
"aiMessage": "The deployment has 3 replicas but CPU usage is at 95%. The error rate spike correlates with high CPU. I'll scale up to reduce per-pod load.",
"action": {
"type": "ScaleDeployment",
"params": {
"replicas": "5"
}
},
"observation": "ScaleDeployment executed successfully. New pods are starting.",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"stepNumber": 2,
"aiMessage": "Pods are starting. Let me observe the metrics to verify the scale-up is helping.",
"observation": "5/5 pods ready. CPU usage dropped to 62%. Error rate decreasing.",
"timestamp": "2026-03-19T15:12:30Z"
},
{
"stepNumber": 3,
"aiMessage": "CPU is now at safe levels and error rate is dropping. I'll also adjust the HPA to prevent this from happening again.",
"action": {
"type": "AdjustHPA",
"params": {
"maxReplicas": "8",
"targetCPUUtilization": "70"
}
},
"observation": "HPA updated. maxReplicas=8, targetCPUUtilization=70%.",
"timestamp": "2026-03-19T15:14:00Z"
},
{
"stepNumber": 4,
"aiMessage": "The deployment is stable with healthy CPU usage and zero errors. Issue resolved.",
"observation": "Health verified: all pods ready, error rate 0%, CPU 58%.",
"timestamp": "2026-03-19T15:16:00Z"
}
]
},
"status": {
"state": "Completed",
"startedAt": "2026-03-19T15:10:00Z",
"actionsCompletedAt": "2026-03-19T15:14:00Z",
"completedAt": "2026-03-19T15:16:00Z",
"result": "Issue resolved after 4 agentic steps",
"evidence": [
{
"type": "action_completed",
"data": "ScaleDeployment executed: replicas 3 -> 5",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"type": "verification_passed",
"data": "All 5/5 pods ready after 45 seconds",
"timestamp": "2026-03-19T15:12:30Z"
}
],
"agenticStepCount": 4,
"agenticStartedAt": "2026-03-19T15:10:00Z",
"preflightSnapshot": {
"resourceKind": "Deployment",
"resourceName": "checkout-api",
"namespace": "production",
"replicas": 3,
"containerImages": {
"app": "registry.example.com/checkout-api:v2.1.0"
},
"hpaMinReplicas": 2,
"hpaMaxReplicas": 5
}
}
}
string
obrigatório
Nome do plano de remediação,
<issue>-plan-<tentativa> (ex.: checkout-api-error-rate-1773932940-plan-1)string
padrão:"default"
Namespace do Kubernetes. O padrão é
default (outros namespaces não são pesquisados), então informe o namespace do plano explicitamente.Detalhes da Resposta
spec é o item da lista estendido com os campos abaixo; status é o status Kubernetes bruto do plano (incluindo preflightSnapshot, actionCheckpoints, actionsCompletedAt e postFailureHealthy quando preenchidos).
| Campo | Descrição |
|---|---|
safetyConstraints | Restrições que devem ser respeitadas durante a execução |
evidence | Evidências registradas durante a execução (preflight_snapshot, action_completed, action_failed, verification_passed, verification_failed, rollback, …) |
rollbackPerformed | Se o rollback automático foi acionado |
rollbackResult | Resultado da tentativa de rollback |
agenticHistory | Raciocínio e ações passo a passo da IA (apenas modo agêntico) |
Histórico Agêntico
QuandoagenticMode é true, o array agenticHistory mostra a conversação completa da IA:
aiMessage: O raciocínio da IA para cada passoaction: A ação concreta proposta (omitida em um passo apenas de observação)observation: O resultado após executar a açãostepNumber: Número sequencial do passo
{
"apiVersion": "v1",
"kind": "RemediationPlan",
"resourceMeta": {
"name": "checkout-api-error-rate-1773932940-plan-1",
"namespace": "production",
"uid": "0f1e2d3c-4b5a-4968-8776-655443322110",
"creationTimestamp": "2026-03-19T15:09:00Z",
"labels": {}
},
"spec": {
"name": "checkout-api-error-rate-1773932940-plan-1",
"namespace": "production",
"issueRef": "checkout-api-error-rate-1773932940",
"attempt": 1,
"strategy": "Agentic AI-driven remediation",
"state": "Completed",
"startedAt": "2026-03-19T15:10:00Z",
"completedAt": "2026-03-19T15:16:00Z",
"result": "Issue resolved after 4 agentic steps",
"agenticMode": true,
"agenticStepCount": 4,
"creationTimestamp": "2026-03-19T15:09:00Z",
"safetyConstraints": [
"Do not scale below current replica count",
"Verify health for 90 seconds after each action"
],
"evidence": [
{
"type": "action_completed",
"data": "ScaleDeployment executed: replicas 3 -> 5",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"type": "verification_passed",
"data": "All 5/5 pods ready after 45 seconds",
"timestamp": "2026-03-19T15:12:30Z"
}
],
"rollbackPerformed": false,
"agenticHistory": [
{
"stepNumber": 1,
"aiMessage": "The deployment has 3 replicas but CPU usage is at 95%. The error rate spike correlates with high CPU. I'll scale up to reduce per-pod load.",
"action": {
"type": "ScaleDeployment",
"params": {
"replicas": "5"
}
},
"observation": "ScaleDeployment executed successfully. New pods are starting.",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"stepNumber": 2,
"aiMessage": "Pods are starting. Let me observe the metrics to verify the scale-up is helping.",
"observation": "5/5 pods ready. CPU usage dropped to 62%. Error rate decreasing.",
"timestamp": "2026-03-19T15:12:30Z"
},
{
"stepNumber": 3,
"aiMessage": "CPU is now at safe levels and error rate is dropping. I'll also adjust the HPA to prevent this from happening again.",
"action": {
"type": "AdjustHPA",
"params": {
"maxReplicas": "8",
"targetCPUUtilization": "70"
}
},
"observation": "HPA updated. maxReplicas=8, targetCPUUtilization=70%.",
"timestamp": "2026-03-19T15:14:00Z"
},
{
"stepNumber": 4,
"aiMessage": "The deployment is stable with healthy CPU usage and zero errors. Issue resolved.",
"observation": "Health verified: all pods ready, error rate 0%, CPU 58%.",
"timestamp": "2026-03-19T15:16:00Z"
}
]
},
"status": {
"state": "Completed",
"startedAt": "2026-03-19T15:10:00Z",
"actionsCompletedAt": "2026-03-19T15:14:00Z",
"completedAt": "2026-03-19T15:16:00Z",
"result": "Issue resolved after 4 agentic steps",
"evidence": [
{
"type": "action_completed",
"data": "ScaleDeployment executed: replicas 3 -> 5",
"timestamp": "2026-03-19T15:11:00Z"
},
{
"type": "verification_passed",
"data": "All 5/5 pods ready after 45 seconds",
"timestamp": "2026-03-19T15:12:30Z"
}
],
"agenticStepCount": 4,
"agenticStartedAt": "2026-03-19T15:10:00Z",
"preflightSnapshot": {
"resourceKind": "Deployment",
"resourceName": "checkout-api",
"namespace": "production",
"replicas": 3,
"containerImages": {
"app": "registry.example.com/checkout-api:v2.1.0"
},
"hpaMinReplicas": 2,
"hpaMaxReplicas": 5
}
}
}
{
"apiVersion": "v1",
"kind": "Error",
"error": "Not Found",
"code": 404,
"message": "remediation plan not found: remediationplans.platform.chatcli.io \"checkout-api-error-rate-1773932940-plan-9\" not found"
}
Autorizações
API key sent in the X-API-Key header. Keys are read from the Secret chatcli-operator-secrets, key api-keys (fallback: ConfigMap chatcli-operator-config, key api-keys) in the operator namespace, as a YAML list of {key, role, name, description} (name is the identity recorded on approval decisions); the operator chart creates it only with apiKeys.create: true. Roles: viewer < operator < admin — any other role string is denied everywhere. Changes are picked up within about 30 seconds; deleting both the Secret and the ConfigMap revokes every key. With no keys configured every /api/ call returns 401, unless CHATCLI_OPERATOR_DEV_MODE=true, which grants admin without a key (development only).
Parâmetros de caminho
RemediationPlan name.
Exemplo:
"payment-oom-plan-1"
Parâmetros de consulta
Namespace of the object. Defaults to default — pass it for objects in any other namespace.