Volver a Wiki

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 →

[T24] [

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 →

[T25] [

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 →

[T26]

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]T27) o pídale a su administrador de organización que lo invite.

2 de la Comisión

Obtenga un token de acceso personal

Instale el CLI con T0, luego ejecute T1 seguido de T2. Guarde el token T3 de forma segura.

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: T4 devuelve el catálogo completo.

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 →