Saltar al contenido principal

Resumen de ServerRpc

Ámbito: ServerRpc (operaciones de todo el servidor vinculadas al Client) Para una visión general de RPC y la lista de todas las páginas de RPC, consulta RPC. Esta página resume los métodos de ServerRpc por categoría. Para ver ejemplos de uso, abre las páginas por funcionalidad que aparecen en el índice de RPC.

Conexión, modelos, herramientas y cuentas

Usa ping() y connect() para comprobar e iniciar la conexión, y registerExtensionLaunchProvider() para registrar un proveedor de lanzamiento de extensiones. Desde models() obtienes la lista de modelos, las unidades de precio de tokens y el catálogo integrado, y desde tools() la lista de herramientas disponibles. account() gestiona la cuota, el estado de autenticación, la lista de usuarios con sesión iniciada, el inicio de sesión y el cierre de sesión. providersConfig()->addModel() es un RPC experimental que añade un modelo a la configuración de proveedores guardada en el servidor. Si el proveedor aún no está guardado, el CLI lo crea y providerAdded te lo indica. El cambio es persistente, pero no modifica las sesiones en ejecución. Para ver ejemplos de uso de providersConfig, consulta Configuración y configuración gestionada.

Clasificar trayectorias grabadas (experimental)

taskAnalytics()->classifyTrajectory() clasifica eventos de Copilot grabados o datos ATIF sin crear una sesión. Las herramientas archivadas no se ejecutan y no se añade nada al historial de conversación ni a la telemetría de clasificación. Pasa events en su orden original. También puedes indicar classifiers, maxConcurrentRequests, judge y previousResult. Con validateOnly: true, el runtime omite la inferencia y devuelve solo el resultado de la validación local. Para ver ejemplos de uso, consulta Sesiones, host y entorno.

MCP, conectores y secretos

mcp() ofrece listar, añadir, actualizar y eliminar configuraciones MCP, así como activarlas, detectarlas, buscar en el registro y planificar y aplicar instalaciones. connectors() permite consultar las capacidades, las cuentas y el catálogo de conectores. Las operaciones de conectores en el lado del servidor se centran en listar y actualizar por cuenta. El método experimental secrets()->addFilterValues() registra en el filtro de redacción de la CLI los secretos dinámicos generados por tu host. A partir de ese momento, la CLI enmascara esos valores en los logs y las exportaciones de la sesión. Para ver ejemplos de uso de secrets, consulta MCP y conectores.

Skills, Plugins, Agents, Instructions y Extensions

Cada grupo permite explorar, obtener las rutas disponibles, cambiar la configuración y recargar. commands() ofrece la lista de comandos integrados y hooks() la exploración de hooks antes de iniciar la sesión. Skills y Plugins admiten activar, desactivar y gestionar instalaciones, y Agents también puede obtener información de los agentes integrados. Extensions explora, activa y desactiva extensiones persistidas. Para ver ejemplos de uso, consulta Skills, plugins, agents, instrucciones y extensiones.

Catálogo e instalación

catalog() busca candidatos, obtiene recomendaciones de productos oficiales, selecciona candidatos y obtiene feeds, y las API de Skills, Plugins y MCP permiten revisar planes de instalación, aplicarlos, consultar su estado y cancelarlos. Planificar y aplicar son operaciones separadas. Consulta los ejemplos concretos de instalación en los apartados posteriores.

Sesiones, host y entorno de ejecución

sessions() se encarga de buscar sesiones persistidas, leer eventos, comprobar tamaños, eliminar y purgar, y hacer fork. También puedes crear y cargar workspaces y usar el control remoto. host() inicia el host, publica, lista y retira la publicación de sesiones, gestiona la autenticación, cambia la política de admisión de sesiones y libera el host. Para la API de alto nivel del host AHP, consulta AHP Host. runtime() gestiona el ciclo de vida del runtime. sessions()->hasEvents() comprueba si existe un log de eventos local persistido sin abrir la sesión. Para ver ejemplos de uso, consulta Sesiones, host y entorno.

Tareas del agente en la nube (experimental)

cloudTasks() crea, elimina y obtiene tareas del agente de codificación en la nube, recupera los logs y replays de sesión, cambia el estado de uso compartido y resuelve la sesión que se debe abrir a partir de un ID de tarea. Cada método acepta el tipo Params correspondiente o un array y devuelve un DTO tipado. Cuando ok del resultado de creación es false, consulta reason y message para ver por qué el servicio rechazó la solicitud, y statusCode, errorMessage y errorPayloadJson para la información de fallo de la solicitud HTTP realizada. Para ver ejemplos de uso, consulta Sesiones, host y entorno.

Git, entornos, sandbox y políticas

Obtén la información de rama, directorio de trabajo y remotos de Git con git(), y descubre repositorios y propietarios de GitHub con gitHubRepository() y gitHubOwners(). environments() gestiona los entornos de Mission Control, sandbox() y sandboxProxyCa() gestionan el soporte de sandbox y la Proxy CA, contentExclusion() valida las políticas de exclusión, y managedSettings() y userSettings() gestionan la configuración. Usa settings() para eliminar claves individuales de un archivo de configuración y para redactar valores para mostrarlos. gitHubRepository()->getById() resuelve el propietario y el nombre a partir del ID de un repositorio de GitHub, y lookupBranchPullRequest() busca en los repositorios indicados, por orden de prioridad, una pull request del propietario head y la rama indicados. Ambos reciben authInfo tal cual. El resultado de getById() contiene el propietario y el nombre en repository, o null si no se encuentra el repositorio. El status de la búsqueda de pull requests es found, no-token, no-pr o lookup-failed. Los valores desconocidos se conservan como cadenas, así que no lanzan excepciones. pullRequest es un array asociativo cuando se encuentra una pull request y null en caso contrario. Para ver ejemplos de uso de gitHubRepository, consulta Git y GitHub. gitHubFetch() ofrece peticiones autenticadas a la API de GitHub y operaciones con nombre. gitHubRelease() ofrece la búsqueda de releases, snapshots, descargas de assets y comprobaciones de progreso. En Fetch, sessionId selecciona la autenticación de una sesión; si se omite, se usa la autenticación del proceso. Indica authOwnerId para usar una vinculación de autenticación gestionada por el host. En Release, authInfo selecciona credenciales gestionadas por el runtime, y las releases públicas pueden buscarse y descargarse de forma anónima. Elimina tú mismo el path descargado después de usarlo. allocateRequestId(), request() y executeOperation() de Fetch, y abandonRequest(), getSnapshot() y downloadAsset() de Release no pueden llamarse desde Extensions. Actualmente el SDK de Laravel no expone el RPC cancel de ninguno de los dos grupos, así que no puedes cancelar desde el SDK una operación en curso. abandonRequest() descarta un ID de petición de Release sin usar; no detiene una operación en curso. fetch() es una API experimental para peticiones HTTP generales a través del transporte de red compartido. Crea con create() un handle propiedad de la conexión y luego llama a send() con el responseMode obligatorio. Con stream, lee el cuerpo por fragmentos con read(). Con text, obtienes el cuerpo completo como texto UTF-8. Con file, el runtime escribe el cuerpo en destinationPath en el host del runtime. Descarta con cancel() los handles que ya no necesites. Puedes usarla para peticiones sin credenciales y para transmitir archivos.

Modelos locales, inferencia HTTP y sistema de ficheros

azureMl() ofrece información de la memoria de la GPU local, el catálogo de modelos, la resolución y la descarga, además de comprobación de estado, cancelación y eliminación. También puede registrar, eliminar y restaurar la configuración de proveedor de los modelos de Azure ML mediante un lease de familia. llmInference() es una API experimental que retransmite al lado del cliente las peticiones HTTP de la capa de modelos. sessionFs() registra un proveedor de callbacks de sistema de ficheros/SQLite para las sesiones. localModels() es una API experimental con ámbito de conexión para gestionar modelos locales. Configura la gestión, inspecciona y vigila el estado, actualiza el catálogo, prepara, descarga, actualiza, repara y elimina modelos, cancela trabajos y descarta avisos. configure(), inspect() y watch() devuelven resultados tipados que incluyen un LocalModelsView y LocalModelsEvent[]. Puedes pasar un CancellationToken a watch(). Cancelar el token envía una notificación de cancelación JSON-RPC y mantiene la conexión abierta. configure() no envía sessionId cuando es null.

Callbacks de red (experimental)

network()->setProvider() informa al runtime de los callbacks de resolución de proxy y de autenticación Kerberos registrados en el cliente. La opción network del Client los registra automáticamente, así que normalmente no necesitas llamar a este RPC directamente. Los campos de callback de NetworkSetProviderRequest indican que el handler correspondiente está registrado. El RPC no devuelve ningún valor. El runtime debe admitir el RPC network.setProvider. Si no lo admite, el cliente lanza al iniciarse una excepción que te pide actualizar el runtime. Para ver ejemplos de uso, consulta Inferencia HTTP y sistema de ficheros.

RPCs internos y experimentales

Los siguientes RPCs están marcados como internos en el SDK oficial, pero Laravel los expone como @experimental. Pueden cambiar o eliminarse en el futuro, y las restricciones de llamador del runtime siguen aplicándose. Úsalos para crear, listar y eliminar entradas del registro de agentes, abrir una URL de autenticación en el navegador, limpiar salidas grandes de herramientas caducadas y obtener advertencias de concesión de rutas del sandbox. Los resultados de listado no incluyen credenciales de conexión. Para ver ejemplos de uso, consulta Modelos, herramientas y cuentas, Sesiones, host y entorno y Skills, plugins, agents, instrucciones y extensiones.
Última modificación el 20 de noviembre de 2026