es__submit_sii_batch

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

No hay anotaciones, por lo que la descripción asume toda la carga. Revela comportamientos importantes: requiere variables de entorno y certificado MTLS, tiene límite de 10.000 registros, y ejecuta un flujo humano-en-el-bucle con confirmación previa. No detalla idempotencia ni manejo de errores, pero cubre lo esencial para evitar una invocación accidental.

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

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

La descripción es breve, está bien estructurada en tres bloques funcionales: acción principal, prerrequisitos y flujo de confirmación. Cada frase aporta información necesaria y no hay repetición ni relleno.

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

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

Para una herramienta de envío con riesgo de efectos colaterales, cubre límites, credenciales y el protocolo de confirmación. La existencia de un output schema compensa la falta de descripción del valor de retorno. Podría añadir referencias a estados posteriores o reintentos, pero en general es completa.

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

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

El esquema ya documenta el 100% de los parámetros, por lo que la línea base es 3. La descripción añade significado útil al explicar el comportamiento de confirmation_token en el flujo de confirmación y al contextualizar los records como envelopes generados por otra herramienta, aunque no profundiza en record_type ni fiscal_year.

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

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

La descripción comienza con un verbo de acción específico ('Enviar'), especifica el recurso ('lote de facturas'), el límite operativo ('máximo 10.000 registros') y el endpoint concreto ('SOAP SII de la AEAT'). Este detalle permite distinguirlo inmediatamente de otras herramientas hermanas como las de Verifactu o FACE.

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

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

La descripción indica claramente cuándo y cómo usarla: para envíos por lote al SII, requiriendo credenciales MTLS y explicando el flujo de dos pasos con confirmation_token. No nombra alternativas o exclusiones explícitas, pero el contexto de uso queda suficientemente claro.

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