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.
Uso de estas herramientas
- Llame primero a la herramienta de lectura o consulta de estado correspondiente.
- Revise el destino y los argumentos obligatorios.
- Ejecute una única acción prevista, con confirmación humana explícita cuando sea necesaria.
- Después, compruebe el estado o vuelva a leer el recurso afectado.
Los parámetros de entrada 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 específicos. Los identificadores son valores que devuelven las herramientas utilizadas anteriormente; no los invente.
app_users
Los usuarios de la aplicación generada.
Lea el recurso devuelto y utilice los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores admitidos |
|---|
| projectId | No | cadena de texto |
| 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
manage_app_user
Invite, actualice o elimine 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 admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| action | Sí | invite, update, remove |
| email | No | cadena de texto; longitud mínima 3; longitud máxima 254 |
| name | No | cadena de texto; longitud mínima 1; longitud máxima 128 |
| role | No | cadena de texto; longitud mínima 1; longitud máxima 32 |
| disabled | No | booleano |
| profileId | No | cadena de texto; 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
app_permissions
Los permisos de la aplicación generada.
Lea el recurso devuelto y utilice los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores admitidos |
|---|
| projectId | No | cadena de texto |
| 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
set_app_permission_default
Establezca 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 admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| permission | Sí | cadena de texto; 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 en formato legible 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 utilice los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| profileId | No | cadena de texto; longitud mínima 1; longitud máxima 256 |
| group | No | cadena de texto; longitud mínima 1; longitud máxima 128 |
| entitySlug | No | cadena de texto; 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
manage_app_grant
Conceda o revoque 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 admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| action | Sí | assign, revoke |
| permission | Sí | cadena de texto; longitud mínima 1; longitud máxima 128 |
| profileId | No | cadena de texto; longitud mínima 1; longitud máxima 256 |
| group | No | cadena de texto; longitud mínima 1; longitud máxima 128 |
| entitySlug | No | cadena de texto; longitud mínima 1; longitud máxima 63 |
| resources | No | arreglo de cadenas de texto |
| 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
app_organizations
Las organizaciones de la aplicación generada.
Lea el recurso devuelto y utilice los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| entitySlug | No | cadena de texto; 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
manage_app_organization
Cambie el nombre de una organización o gestione 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 admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| action | Sí | rename, add-member, update-member, remove-member |
| entitySlug | Sí | cadena de texto; longitud mínima 1; longitud máxima 63 |
| title | No | cadena de texto; longitud mínima 1; longitud máxima 256 |
| email | No | cadena de texto; longitud mínima 3; longitud máxima 254 |
| name | No | cadena de texto; longitud mínima 1; longitud máxima 128 |
| owner | No | booleano |
| profileId | No | cadena de texto; longitud mínima 1; longitud máxima 256 |
| groups | No | arreglo de cadenas de texto |
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 en formato legible 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 utilice los valores actuales al planificar la siguiente acción.
| Argumento | Obligatorio | Tipo o valores admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| entitySlug | Sí | cadena de texto; longitud mínima 1; longitud máxima 63 |
| group | No | cadena de texto; 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 en formato legible por máquina incluyen esquemas de argumentos anidados.
manage_app_group
Cree, modifique o elimine un grupo, o gestione 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 admitidos |
|---|
| projectId | No | cadena de texto |
| scope | No | ephemeral, production |
| action | Sí | create, update, delete, add-members, remove-members |
| entitySlug | Sí | cadena de texto; longitud mínima 1; longitud máxima 63 |
| group | Sí | cadena de texto; longitud mínima 1; longitud máxima 128 |
| title | No | cadena de texto; longitud mínima 1; longitud máxima 256 |
| bundles | No | arreglo de objetos |
| profileIds | No | arreglo de cadenas de texto |
| 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 en formato legible por máquina incluyen esquemas de argumentos anidados.