Tool
Una tarjeta plegable para una llamada a herramienta, con el estado, lo que entró y lo que volvió.
ActualizadoInstalación
Copia y pega el siguiente código en tu proyecto.
Actualiza las rutas de importación para que coincidan con la estructura de tu proyecto.
Anatomía
Una llamada arranca cerrada. El nombre y el estado son lo que se lee de un vistazo; los payloads quedan para quien quiera revisarlos. Pasá
defaultOpen a las llamadas que valga la pena mostrar, como una que falló.Tool.Input y Tool.Output aceptan cualquier value: un string se imprime tal cual, cualquier otra cosa se formatea como JSON. Pasale children a Tool.Output cuando el resultado merece markup de verdad.Composición
Usá la siguiente composición para construir un
Tool:Estados
status va en la raíz y define el indicador del header: pending espera con un punto, running gira, complete tilda, error marca el problema, y awaiting-approval y denied cubren las llamadas que necesitan el visto bueno del usuario. Combiná error con <Tool.Output error /> para que el payload se lea como la falla que es.Input
{
"to": "contact@ignaciofigueroa.dev",
"subject": "Hi"
}Output
422 Unprocessable Entity: recipient domain is not verified
Aprobación
Algunas llamadas no deberían correr hasta que el usuario lo diga. Usá
status="awaiting-approval": la tarjeta se abre sola, el borde toma el tono de advertencia y los lectores de pantalla escuchan "Waiting for approval". Poné un Confirmation adentro de Tool.Content y avanzá el estado con la respuesta: a running si aprueba, a denied si no. Una llamada rechazada deja su nombre tachado, así la conversación muestra lo que no pasó.Referencia de API
Tool
| Prop | Type | Default | Description |
|---|---|---|---|
status | 'pending' | 'awaiting-approval' | 'running' | 'complete' | 'error' | 'denied' | 'complete' | Estado de la llamada |
defaultOpen | boolean | false | Estado abierto cuando no se controla |
open | boolean | - | Estado abierto controlado |
onOpenChange | (open: boolean) => void | - | Se llama al cambiar el estado |
className | string | - | Clases CSS adicionales |
Tool.Header
| Prop | Type | Default | Description |
|---|---|---|---|
name | string | - | Nombre de la herramienta |
description | string | - | Una línea debajo del nombre |
statusLabels | Partial<Record<Status, string>> | - | Etiquetas de lector de pantalla por estado |
className | string | - | Clases CSS adicionales |
Tool.Content
| Prop | Type | Default | Description |
|---|---|---|---|
className | string | - | Clases CSS adicionales |
Tool.Input
| Prop | Type | Default | Description |
|---|---|---|---|
label | string | 'Input' | Etiqueta sobre el bloque |
value | unknown | - | Se imprime tal cual si es string, como JSON si no |
children | ReactNode | - | Reemplaza value si se pasa |
className | string | - | Clases CSS adicionales |
Tool.Output
| Prop | Type | Default | Description |
|---|---|---|---|
label | string | 'Output' | Etiqueta sobre el bloque |
value | unknown | - | Se imprime tal cual si es string, como JSON si no |
error | boolean | false | Tonos destructivos para una llamada fallida |
children | ReactNode | - | Reemplaza value si se pasa |
className | string | - | Clases CSS adicionales |
¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.