> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen de ServerRpc

> Resumen de los métodos de ServerRpc de Laravel Copilot SDK agrupados por categoría, con enlaces a las páginas de ejemplos de uso de cada funcionalidad.

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-settings.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-sessions.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-mcp.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-skills-plugins.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/ahp.md). `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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-sessions.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-sessions.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-git.md).

`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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-inference.md).

## 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](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-models.md), [Sesiones, host y entorno](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-sessions.md) y [Skills, plugins, agents, instrucciones y extensiones](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-skills-plugins.md).


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Resumen de SessionRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [MCP](https://kawax.biz/es/packages/laravel-copilot-sdk/mcp.md)
- [Inferencia HTTP y sistema de ficheros](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-inference.md)
- [MCP y conectores](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-mcp.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.