Usuarios, permisos y organizaciones de la aplicación
En esta página
Elija entre vista previa y producción de manera consciente. Una entidad de organización representa a la organización del cliente; el slug identifica ese ámbito en los argumentos de las herramientas que lo admiten.
Usar estas herramientas
- Llame primero a la herramienta de lectura o de consulta de estado correspondiente.
- Revise el destino y los argumentos obligatorios.
- Ejecute una sola acción prevista, con confirmación humana explícita cuando sea necesaria.
- Después, consulte el estado o vuelva a leer el recurso afectado.
Los parámetros que se indican a continuación describen el contrato público. La lista actual de herramientas del servidor conectado es la referencia definitiva. Algunas herramientas requieren un host, un destino, un modo de inferencia o un plan concretos. Los identificadores son valores que devuelven las herramientas llamadas antes; no los invente.
app_users
Los usuarios de la aplicación generada.
Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
all | No | booleano |
Operación: solo lectura.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
manage_app_user
Invitar, actualizar o eliminar a un usuario de la aplicación.
Eliminar o deshabilitar a un usuario puede impedirle el acceso. Revise el ámbito y el perfil seleccionado antes de confirmar cambios destructivos.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
action | Sí | invite, update, remove |
email | No | cadena; longitud mínima 3; longitud máxima 254 |
name | No | cadena; longitud mínima 1; longitud máxima 128 |
role | No | cadena; longitud mínima 1; longitud máxima 32 |
disabled | No | booleano |
profileId | No | cadena; longitud mínima 1; longitud máxima 256 |
confirm | No | booleano |
Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
app_permissions
Los permisos de la aplicación generada.
Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
Operación: solo lectura.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
set_app_permission_default
Establecer quién recibe un permiso de forma predeterminada.
Cambia quién recibe un permiso de forma predeterminada. Después, haga una prueba con un usuario que tenga acceso permitido y otro que tenga acceso denegado.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
permission | Sí | cadena; longitud mínima 1; longitud máxima 128 |
defaultClass | No | none, user, member, owner |
entityScoped | No | booleano |
Operación: puede cambiar el estado o iniciar trabajo.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
app_grants
Quién tiene cada permiso en la aplicación generada.
Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
profileId | No | cadena; longitud mínima 1; longitud máxima 256 |
group | No | cadena; longitud mínima 1; longitud máxima 128 |
entitySlug | No | cadena; longitud mínima 1; longitud máxima 63 |
Operación: solo lectura.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
manage_app_grant
Conceder o revocar un permiso en la aplicación generada.
Conceda o revoque únicamente el permiso previsto y solo para los destinatarios previstos. Utilice entitySlug para delimitar el ámbito de una organización del cliente.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
action | Sí | assign, revoke |
permission | Sí | cadena; longitud mínima 1; longitud máxima 128 |
profileId | No | cadena; longitud mínima 1; longitud máxima 256 |
group | No | cadena; longitud mínima 1; longitud máxima 128 |
entitySlug | No | cadena; longitud mínima 1; longitud máxima 63 |
resources | No | lista de cadenas |
mode | No | blanket, resources, all |
Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
app_organizations
Las organizaciones de la aplicación generada.
Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
entitySlug | No | cadena; longitud mínima 1; longitud máxima 63 |
Operación: solo lectura.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
manage_app_organization
Cambiar el nombre de una organización o gestionar sus miembros.
Gestiona los títulos y los miembros de las organizaciones del cliente. Confirme que la entidad de organización y el usuario sean los previstos.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
action | Sí | rename, add-member, update-member, remove-member |
entitySlug | Sí | cadena; longitud mínima 1; longitud máxima 63 |
title | No | cadena; longitud mínima 1; longitud máxima 256 |
email | No | cadena; longitud mínima 3; longitud máxima 254 |
name | No | cadena; longitud mínima 1; longitud máxima 128 |
owner | No | booleano |
profileId | No | cadena; longitud mínima 1; longitud máxima 256 |
groups | No | lista de cadenas |
Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
app_groups
Los grupos de una organización en la aplicación generada.
Lea el recurso devuelto y use los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
entitySlug | Sí | cadena; longitud mínima 1; longitud máxima 63 |
group | No | cadena; longitud mínima 1; longitud máxima 128 |
Operación: solo lectura.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.
manage_app_group
Crear, modificar o eliminar un grupo, o gestionar sus miembros.
La pertenencia a grupos y los conjuntos de permisos afectan al acceso de los usuarios. Compruebe el grupo y el ámbito antes de modificarlo o eliminarlo.
| Argumento | Obligatorio | Tipo o valores aceptados |
|---|---|---|
projectId | No | cadena |
scope | No | ephemeral, production |
action | Sí | create, update, delete, add-members, remove-members |
entitySlug | Sí | cadena; longitud mínima 1; longitud máxima 63 |
group | Sí | cadena; longitud mínima 1; longitud máxima 128 |
title | No | cadena; longitud mínima 1; longitud máxima 256 |
bundles | No | lista de objetos |
profileIds | No | lista de cadenas |
confirm | No | booleano |
Operación: puede cambiar el estado o iniciar trabajo; puede tener efectos destructivos.
Configuraciones disponibles: stdio, proyecto en la nube, inferencia en la nube; stdio, proyecto en la nube, inferencia delegada; stdio, proyecto local, inferencia en la nube; stdio, proyecto local, inferencia delegada; HTTP alojado.
Los contratos de herramientas legibles por máquina incluyen esquemas de argumentos anidados.