Arc Flash Platform — Estudos Elétricos

Tempo de atuação da proteção (IEC 60255-151 / IEEE C37.112)

tempo_de_atuacao

Read-only

Tempo de atuação de um dispositivo de proteção à corrente de falta, pela curva composta 4-segmentos do algoritmo da plataforma (IEC 60255-151 / IEEE C37.112): 51 inversa · 50 curto-tempo · 50 instantânea. É o ELO entre o curto e o arco: encadeie calcular_curto_circuito → tempo_de_atuacao → calcular_energia_incidente (o tempo_s daqui é o t_arc_s, o parâmetro mais difícil de estimar à mão).

O tempo é o da borda LENTA da banda de tolerância, a mesma régua do estudo da plataforma: no modelo do catálogo que declara a banda do fabricante ela é aplicada (banda: "fabricante"); sem banda declarada, informe tolerancia_pct (± %, só na instantânea, a do manual do seu disjuntor; a IEC 60947-2 admite ±20 % no disparador de curto-circuito) e a instantânea sobe para o extremo de cima (banda: "informada"); sem nada, a curva ajustada (banda: "nenhuma"). A corrente de arco REDUZIDA que fica entre o ajuste e o extremo da banda cai na curva térmica, e é ela que costuma governar a energia.

MANUAL (universal): pickup_A = pickup do 51 (relé: RTC×tap; disjuntor: Ir); curva ∈ IEC/IEEE, pelo nome ou pelo apelido dos manuais: NI/SI (= IEC-NI), VI, EI, LTI, UI, DT/DTL e ANSI/IEEE MI/VI/EI; o nome lido volta em curva e o que você escreveu em curva_informada. Códigos de fabricante (como U1–U5 e C1–C5) NÃO são aceitos: cada fabricante numera e escala do seu jeito (a U1 da SEL usa outra escala de dial). tms = TMS (IEC) ou time-dial (IEEE), 0,10 se omitido; instantaneo_A+t_disjuntor_ms (50 instantânea) e curto_tempo_A+t_curto_tempo_ms (50 temporizada) são opcionais; sem eles, só a inversa opera. CATÁLOGO: device_id de MCCB/ACB (use listar_dispositivos); tms omitido = o padrão do aparelho, e nos disparadores de curva I²t da IEC 60947-2 (3WL, Emax 2, Tmax XT7) o tms é o t1/tR em SEGUNDOS, o número do mostrador.

CURVA TÉRMICA TABELADA (termomagnético, cuja térmica não é IEC/IEEE): curva_pontos = [[múltiplo, t_s], …] lidos da tabela do manual (a borda de cima; múltiplo crescente, tempo que não cresce) e curva_base = 'Ir' ou 'In' (de qual corrente são os múltiplos; obrigatória). A região inversa sai desses pontos (interpolação log-log) no lugar da curva; a resposta traz curva_tabelada. Nunca leia pontos de um GRÁFICO: só de tabela. Gratuito (uso limitado).

Input Schema

Name	Required	Default
`tms`	No
`curva`	No	IEC Very Inverse (VI)
`api_key`	No
`pickup_A`	No
`device_id`	No
`curva_base`	No
`curva_pontos`	No
`curto_tempo_A`	No
`instantaneo_A`	No
`t_disjuntor_ms`	No
`tolerancia_pct`	No
`corrente_falta_A`	Yes
`t_curto_tempo_ms`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 14, 2026

addedInput schema / properties / curva_base

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Curva Base"
+}

addedInput schema / properties / curva_pontos

Added value: +{
+  "anyOf": [
+    {
+      "items": {},
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Curva Pontos"
+}

Changed1 schema field changedOct 9, 2026

addedInput schema / properties / tolerancia_pct

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Tolerancia Pct"
+}

Changed3 schema fields changedOct 8, 2026
- addedInput schema / properties / tms / anyOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
- changedInput schema / properties / tms / default
```
Previous value: -0.1New value: +null
```
- removedInput schema / properties / tms / type
```
Removed value: -"number"
```
AddedJul 4, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnlyHint=true, and the description is consistent with a pure computation while adding substantial context beyond it: the tolerance-band policy (fabricante/informada/nenhuma), how the instantânea moves to the upper band edge, that the reduced arc current falls on the thermal curve, and that tms maps to t1/tR in seconds for IEC 60947-2 I²t trip units. It also reveals default behavior (0,10 if tms omitted; only the inverse curve operates without 50 parameters) and that the call is 'Gratuito (uso limitado)'. It stops short of stating failure/error behavior or the full response shape, which keeps it at 4.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and the workflow chain before any detail, and the mode-specific sections (MANUAL / CATÁLOGO / CURVA TÉRMICA TABELADA) are visually separated so an agent can jump to the relevant branch. It is dense and long — several clauses are packed per line — but for 13 parameters with zero schema documentation almost every sentence removes ambiguity, so the length is mostly earned.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 13 parameters, no schema descriptions, and no output schema, the definition covers the mode-selection logic, defaults, unit traps (tms as t1/tR in seconds), and even names key response fields (banda, curva, curva_informada, curva_tabelada, tempo_s consumed as t_arc_s). Remaining gaps are the complete return payload and error/validation behavior, which matter somewhat more here precisely because there is no output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage across 13 parameters, the description carries the entire burden and does so for nearly all of them: pickup_A (RTC×tap / Ir), curva with the full alias table (NI/SI, VI, EI, LTI, UI, DT/DTL, ANSI MI/VI/EI), tms semantics and default, instantaneo_A/t_disjuntor_ms, curto_tempo_A/t_curto_tempo_ms, device_id, curva_pontos format ([múltiplo, t_s] pairs, log-log interpolation) and obligatory curva_base ('Ir'/'In'), plus tolerancia_pct with the IEC 60947-2 ±20% reference. Only api_key and corrente_falta_A go unexplained, and the latter is self-evident as the required input; that small residual keeps it from a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb and resource ('tempo de atuação de um dispositivo de proteção à corrente de falta') and pins the exact standards plus the 4-segment curve composition (51/50 curto-tempo/50 instantânea). It positions itself against siblings explicitly by naming the chain calcular_curto_circuito → tempo_de_atuacao → calcular_energia_incidente, so an agent can place it in the workflow without opening other schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit alternatives and preconditions: use MANUAL mode with pickup_A/curva for relays, CATÁLOGO mode with device_id from listar_dispositivos for MCCB/ACB, and CURVA TÉRMICA TABELADA with curva_pontos for thermomagnetic devices whose thermal curve is not IEC/IEEE. It also states a hard exclusion ('Códigos de fabricante (como U1–U5 e C1–C5) NÃO são aceitos') and a data-entry rule ('Nunca leia pontos de um GRÁFICO: só de tabela'), which is exactly the kind of negative guidance agents need.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Arc Flash Platform — Estudos Elétricos tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?