Saltar al contenido principal

Usarla con un agente

La CLI está pensada para que un agente de IA la use tanto como una persona: puede leer un problema, buscar sus registros, arreglarlo y marcarlo como resuelto.

collector issues list --env production --json
collector issues show 2C7ZffP787kc --markdown > issue.md
collector logs --request F3xAbCdEfGh --markdown # la solicitud de la que vino
claude "Arregla el error de issue.md. Cuando el arreglo esté integrado, ejecuta: collector issues resolve 2C7ZffP787kc"

Dale una credencial a su medida​

No le des tu sesión: crea una credencial de acceso para el agente, de solo lectura si solo tiene que mirar, o limitada a una organización, y dásela como COLLECTOR_TOKEN. Puedes revocarla cuando termine sin tocar tu propia sesión.

Lo que el agente tiene que saber​

  • --markdown da el texto que Collector escribe para una IA: en issues show, el error, la pila de llamadas con el código alrededor de las líneas de tu aplicación, la solicitud, lo que pasó antes y las etiquetas; en logs, una línea por registro, de arriba abajo como una historia.
  • --json, en cualquier comando, imprime el JSON de Collector tal cual. Con --json, los errores salen en stderr como {"error": {"code", "message"}}.
  • Los resultados van a stdout; las pistas, el progreso y las advertencias, a stderr.
  • Las listas muestran una página (--limit hasta 100, después --cursor), o todas con --all.
  • Los códigos de salida distinguen un rechazo (1), un mal uso (2) y un problema de credencial (3).
  • Los mensajes de Collector y el Markdown siguen tu idioma en Collector; --lang en o --lang es (o COLLECTOR_LANG) piden uno. El texto propio de la CLI está en inglés.
  • collector api <ruta> hace un pedido directo a la API, para lo que no tiene comando propio.
  • collector open issue <id> imprime (y en una terminal abre) la página del problema en la aplicación web, para dejarle el enlace a una persona.

La guía para agentes​

app.clt.chrom.ar/agents.md es una guía en Markdown para que un agente de programación, como Claude Code, ponga Collector en marcha en tu proyecto: instala la CLI, inicia sesión con collector login, elige o crea el proyecto (collector use <organización>/<proyecto>, collector dsn) y, según el lenguaje (Elixir, Node, JavaScript en el navegador u otro), instala el SDK y configura los errores, los registros, la velocidad y los mapas de código fuente. Termina comprobando que funciona, con collector test y collector issues list.

Es pública y no lleva secretos: el DSN lo saca collector dsn. Está en español y en inglés: ?lang=es o ?lang=en, y si no, el idioma de tu navegador.

Desde la aplicación​

La tarjeta Usa Collector desde tu terminal, en la lista de proyectos, tiene Copiar instrucciones: copia esa misma guía, en tu idioma, para pegársela al agente.

La página de cada problema tiene Copiar como Markdown, el mismo texto que issues show --markdown. Y la Puesta en marcha tiene Copiar instrucciones, para que un agente configure el SDK en tu proyecto.