Acceso de agentes y programas
Tres formas de acceder a CenterOS de forma programática: REST API, CLI y MCP Server. Construir flujos de trabajo de robótica automatizados con conjuntos de datos, capacitación y gestión de flota.
En esta página
- [Por qué el acceso programático]
- [Tres formas de acceder]
- [Empezando]
- [La capa de acción]
- [Cómo elegir]
- ¿ Qué es eso ?
Acceso de agentes y desarrolladores
- [Acuerdo general de acceso de los agentes]
- [Referencia de la API de la plataforma]
- [Guía de los CLI]
- [Integración del MCP]
- ¿ Qué es eso ?
También ver
- [← Todos los artículos de Wiki]
- [SDK Quickstart]
- [Referencia de API del SDK]
- Plataforma →
Descripción general de las API + CLI + MCP
CenterOS expone una capa de acción unificada con 39 acciones en 9 dominios. Accédele de tres maneras: REST API, CLI o MCP para herramientas de IA.
Actualizado abril 2026 39 acciones 9 categorías
** Buscando el conjunto de herramientas completo para desarrolladores?** Ver CenterOS -- AI-Powered Dev Tools (CLI + MCP + API) para la visión general completa con inicio rápido, capacidades de MCP, ejemplos de interacciones y hardware soportado. →
Por qué es importante el acceso programático
Los flujos de trabajo de la robótica son inherentemente múltiples pasos: recopilar datos, etiquetarlos, entrenar un modelo, evaluar, desplegar en una flota, monitorear. Cada paso implica diferentes herramientas, equipos y líneas de tiempo.
- CI/CD para robots -- Trigger trabajos de capacitación, ejecutar evaluaciones, y desplegar modelos de su tubería.
- ** Operaciones asistidas por IA** - Deja que Claude o Cursor administren tu plataforma utilizando el lenguaje natural.
- Dashboards personalizados -- Construir herramientas internas que extraen datos en vivo de la API de la plataforma.
- Orquestación de la flota -- Despliegue de guiones, monitoree la salud y responda automáticamente a las alertas.
- ** Pipelines de datos** -- Cargar conjuntos de datos, ejecutar tareas de anotación y rastrear métricas de calidad de forma programática.
Tres maneras de acceder
¿Qué es esto?
API de REST
Acceso directo HTTP a las 31 acciones de la plataforma. Utiliza desde cualquier idioma, cualquier plataforma. autenticación JWT y PAT con escopo de granos finos.
curl / httpx / tracer →
[
Centro CLI
Herramienta de flujo de trabajo de primera terminal con tablas ricas y salida formateada. También se puede usar como un SDK Python en scripts y cuadernos de notas.
instalar el pip centeros-cli →
[
MCP servidor
Conecta la plataforma a asistentes de IA -- Claude Code, Claude Desktop, Cursor, Windsurf. Todas las acciones se convierten en herramientas de IA a través del lenguaje natural.
instalar el pip centeros-mcp →
[
Comenzando
Independientemente del método de acceso que elija, el flujo de configuración es el mismo:
1 de la Comisión
Crear una cuenta de plataforma
Regístrese en [platform.roboticscenter.ai]
2 de la Comisión
Obtenga un token de acceso personal
Instale el CLI con
3 El
Elige el método de acceso
Utilice la API REST para la integración directa de HTTP, el CLI para flujos de trabajo terminales o scripts de Python, o el servidor MCP para operaciones asistidas por IA.
4 de la Comisión
Comience la construcción
Los tres métodos acceden a las mismas 39 acciones con la misma autenticación y permisos.
concha Copia
Paso 1: Instala el CLI $ pip instalar centeros-cli
Paso 2: Ingrese y crea un PAT $ centeros login --username su nombre de usuario --contraseña '***' $ centeros pat crear --nombre "mi-agente" --escopes "*" Se creó el PAT: frl_abc123... (¡Salva esto!)
Paso 3: Usa en cualquier lugar $ exportar CENTEROS_TOKEN=frl_abc123... $ centeros conjunto de datos lista # CLI $ curl .../api/acciones -H "Autorización: portador $CENTEROS_TOKEN" # API
La capa de acción
Los tres métodos de acceso comparten el mismo backend: la Action Layer. Es un registro unificado de 39 acciones ejecutables organizadas en 9 categorías:
- ** Dataset (6)** -- lista, obtención, eliminación, carga, URL firmada, confirmación de carga
- ** Formación (6)** -- lista de trabajos, creación, estado, lanzamiento, catálogo, costo estimado
- Modelos (4) -- lista, registro, promoción del ciclo de vida, obtención de linaje
- Flot (6) -- resumen, lista de robots, estado del robot, registro, modelo de despliegue, parada de emergencia
- ** Simulación (4)** -- lista de escenas, creación de escena, simulación de lanzamiento, estado de simulación
- Procesamiento (4) -- lista de tuberías, creación de tuberías, estado de ejecución, cancelación de ejecución
- Anotations (4) -- lista de tareas, creación de tareas, métricas, presentación para revisión
- Organizaciones (3) -- lista de organismos, miembros, invitados
- Estados (2) -- estadísticas de la plataforma, salud del sistema
Cada acción tiene un nombre, descripción, esquema de entrada JSON y los ámbitos requeridos. El descubrimiento es automático:
Cómo elegir
| Use Case | Best Choice | Why |
|---|---|---|
| CI/CD pipeline automation | CLI or REST API | Set CENTEROS_TOKEN in CI, run centeros commands or curl. |
| Python notebook / script | Python SDK | from centeros import CenterOSClient gives you typed methods. |
| Non-Python integration | REST API | Standard HTTP/JSON works with any language. |
| AI-assisted development | MCP Server | Claude, Cursor, or Windsurf call platform actions via natural language. |
| Interactive terminal work | CLI | Rich tables, formatted output, command completion. |
| Custom dashboard / frontend | REST API | Fetch data from your frontend with Bearer auth. |
Sumérgete
Referencia API REST Full API con todas las 39 acciones, esquemas y ejemplos de curl → Guía de CLI Instalar centeros-cli y administrar todo desde el terminal → MCP Integration Connect Claude, Cursor, o Windsurf a la plataforma → Hardware SDK Conectar robots físicos con pip instalar roboticscenter →







