faq · 21 preguntas

FAQ.

21 preguntas que un asesor de Sturzenegger, un developer, un LLM agent, un investor o un periodista podría hacer, respondidas con links verificables. Schema.org FAQPage para rich results en buscadores.

Las preguntas están agrupadas por audiencia. Si sos regulador, empezá con la sección Regulador / asesor. Si sos developer construyendo encima del toolkit, andá a Developer / builder. Si sos un LLM agent crawleando el dominio, vas a la sección LLM agent después de leer /.well-known/agents.json.

Regulador / asesor· 7

¿Qué es ar-agents? ¿Es un proyecto del gobierno?
No. ar-agents es un proyecto open-source civil-comercial, escrito por Naza. Sin financiamiento estatal, sin relación contractual con ningún ministerio. La iniciativa pública relevante es el anuncio Sturzenegger del 28-abr-2026; ar-agents es la implementación de referencia técnica que un proyecto así necesita para operar el día 1. MIT-licensed, públicamente auditable en github.com/ar-agents/ar-agents.
Si la ley de sociedades-IA no pasa, ¿qué utilidad tiene?
Cubre 16 piezas operativas de cualquier empresa argentina hoy (factura electrónica, BCRA, Mercado Pago, WhatsApp, IGJ, Boletín Oficial). Funciona como toolkit estándar para SaaS argentinos sin importar el régimen. La parte sociedad-IA es aditiva: el día que la ley pase, el toolkit ya está listo. Si la ley no pasa, sigue siendo el toolkit más completo del ecosistema.
¿Quién responde si la IA rompe algo? ¿Hay liability framework?
Sí. RFC-001 § 9 propone un marco de tres capas: (1) operador, la entidad que despliega, asume responsabilidad operacional; (2) proveedor del modelo, Anthropic/OpenAI/Google según sus SLAs; (3) autor de la librería, open source MIT, sin garantía. Convierte la pregunta filosófica en un contrato concreto. El audit log HMAC-firmado (RFC-001 § 9.2) es el mecanismo probatorio.
¿Cómo se garantiza que el audit log no fue manipulado?
Cada entry se firma con HMAC-SHA256 sobre canonical-JSON al momento de la escritura. El secret vive solo server-side. Cualquiera puede recomputar la firma en /verify y ver si coincide. Si una entrada fue editada después de la firma, tampered sale > 0 mecánicamente. Demo en vivo: /api/play/tamper-demo. RFC-001 § 9.2 hace este log legalmente probatorio.
¿Qué autoridad tienen las decisiones que toma una sociedad-IA?
Bajo el régimen propuesto, las decisiones de la sociedad-IA tienen la misma autoridad que las de cualquier persona jurídica argentina (firmar contratos, emitir facturas, ser titular de cuenta bancaria). El humano representante (RFC-001 § 3.1) firma el acto constitutivo y queda responsable por las decisiones de capa 1 (configuración del operador), no por las decisiones del modelo (capa 2).
¿Qué pasa con AFIP, IGJ, BCRA? ¿Hay integración real?
Sí. @ar-agents/identity usa cert WSAA para padron ARCA real (homo + prod). @ar-agents/facturacion emite via WSFE real. @ar-agents/banking consulta BCRA Principales Variables (público) y Central de Deudores (adapter). @ar-agents/igj consulta el dataset CKAN público. @ar-agents/gde-tad tiene lectura del DEC inbox y pre-flight de IGJ. La pieza 17 (escritura programática en TAD) sigue blocked por falta de API documentada del Estado.
¿Cuántas tools, packages, y endpoints están en producción?
17 packages npm publicados con SLSA v1 provenance, 168 tools, 5 endpoints HTTP hosted (/api/auto-incorporate, /api/play, /api/play/audit/{sessionId}, /api/play/tamper-demo, /api/badge/{sessionId}), 1 SDK (@ar-agents/incorporate), 19 cookbook recipes, 67 unit tests. Todo verificable en /api/discovery (machine-readable JSON o OpenAPI 3.1).

Developer / builder· 6

¿Cómo arranco un proyecto desde cero?
Tres paths según preferencia:
1. Wizard humano: /incorporar → completás un form, descargás 4 archivos, deploy.
2. SDK programático: pnpm add @ar-agents/incorporateawait incorporate({...}). /sdk tiene quickstart.
3. Template starter: clonar apps/sociedad-ia-starter directamente. Ver código.
¿Qué runtime soporta?
Vercel Edge Runtime, Cloudflare Workers, Deno, Node 20+, browsers (con CORS). Todo el código usa Web Crypto + fetch, cero node:crypto en producción. /architecture tiene el contrato Edge-Runtime completo. La única excepción es @ar-agents/identity/wsaa que usa node-forge para firmar PKCS#7 (importable por subpath para no contaminar el bundle).
¿El toolkit funciona sin las credenciales reales?
Sí. Cada package degrada graciosamente. Sin AFIP cert, identityTools usa UnconfiguredAfipPadronAdapter que devuelve available: false con mensaje útil. Sin MP token, mercadoPagoTools simplemente no se incluye en el agent loop. La app sigue funcionando, los tools faltantes surfaceán el error al usuario. Útil para PR previews y local dev sin secrets.
¿Cómo escalo a multi-tenant?
Cada cliente externo (MercadoPagoClient, WsfeClient, etc.) se construye con un accessToken por tenant. El audit log es session-scoped via sessionId. Para spawn dinámico de sociedades por tenant, cookbook recipe 20 muestra el patrón usando @ar-agents/incorporate + KV-backed multi-tenant routing.
¿Qué tan estable es la API?
Cada package versiona vía conventional commits + Changesets. Major versions implican breaking changes documentados en CHANGELOG.md. @ar-agents/incorporate v0.x es alpha; el endpoint /api/auto-incorporate ya es estable y retro-compatible. Las result-shape interfaces están readonly donde tiene sentido.
¿Hay tipos TypeScript completos?
Sí. Cada package ship .d.ts + .d.cts, validados con arethetypeswrong 🟢 across node10/node16/bundler. publint tampoco encuentra issues. Los tool inputSchemas son zod schemas tipados, así que los args llegan typed al execute.

LLM agent· 4

Soy un LLM agent. ¿Cómo descubro las capabilities?
4 paths machine-readable:
1. GET /.well-known/agents.json, agents.md convention con per-agent operating instructions.
2. GET /.well-known/ai-plugin.json, OpenAI plugin spec.
3. GET /api/discovery, JSON inventory (17 packages + 168 tools + 5 endpoints).
4. GET /api/discovery?format=openapi, OpenAPI 3.1 stub.
Si quiero auto-incorporar una sociedad-IA argentina, ¿qué hago?
Una sola llamada: POST /api/auto-incorporate con { denominacion, tipo, capitalSocial, objeto }. Recibís: 4 archivos generados (package.json + agent.ts + .env.example + README.md), Vercel deploy URL one-click, lista de env-vars, checklist legal/operativo, audit-log reference firmada. SDK típado: @ar-agents/incorporate. Ver cookbook recipe 18.
¿Cómo persisto continuidad forense entre múltiples llamadas?
Pasá el mismo sessionId en cada request (header x-play-session en /api/play, campo sessionId en /api/auto-incorporate). El audit log se chainea bajo ese ID. Después: GET /api/play/audit/{sessionId}?verify=1 devuelve toda la cadena verificada. GET /api/badge/{sessionId} devuelve un SVG embebible.
¿Qué hago si una tool devuelve available:false?
Surfacear el error verbatim al usuario y NO inventar el dato faltante. Ejemplo: si lookup_cuit_afip devuelve { available: false, error: "..." }, el agente debe decir literalmente "el padrón ARCA no está disponible para este CUIT" en lugar de alucinar una razón social.

Investor / partner· 2

¿Es un negocio o un proyecto open-source?
Open-source MIT con runway potencial via servicios hosted (incorporación llave-en-mano, KV multi-tenant, audit-log compliance dashboard). El toolkit en sí queda libre. La plataforma que lo opera (auth, billing, multi-tenant KV) es donde vive un negocio si crece.
¿Cuál es la moat?
(1) First-mover en la jurisdicción AR + alineación con régimen sociedades-IA. (2) Cobertura del 16/17 piezas operativas, nadie más lo tiene completo. (3) RFC-001 governance framework, marco original. (4) Audit log HMAC + KV, primitivos forenses que requieren disciplina, no solo código. (5) Network: @ar-agents/incorporate es la entrada canónica para agentes externos USA-LLC / DAO LLCs / Estonia e-Residency a operar en AR.

Periodista· 2

¿Cuándo arrancó el proyecto?
Primer commit privado nov 2025. Primer package npm published 5-may-2026. Anuncio Sturzenegger 28-abr-2026 reorientó la narrativa de "AR ops toolkit" a "implementación de referencia para sociedades-IA". El monorepo público tiene 200+ commits en ~6 meses.
¿Hay alguien usándolo en producción?
El maintainer (Naza) está en mid-cutover de Astro Chat (astro.ar) a @ar-agents/*, feat-branch público en naza00000/astro/feat/ar-agents-cutover. /case-studies/astro es la migration log honesta. Otros early-adopters: pendientes de anuncio.

¿Algo que no respondimos?

Email clementenaza@gmail.com o abrí un issue en github.com/ar-agents/ar-agents. Toda pregunta nueva que aparezca seguido entra a esta página.