Hacer que un asistente calcule con archivos¶

Un asistente puede responder preguntas sobre un archivo CSV o Excel ejecutando código sobre él: totales, recuentos, comparaciones, un gráfico o un archivo depurado para descargar. Lo hace en un ordenador propio, que empieza de nuevo en cada respuesta, no tiene internet y desaparece después de la respuesta. Para ello el asistente necesita tres herramientas. Esta página explica dónde encontrarlas y cómo dárselas a un asistente, y qué ves cuando tu organización no puede ejecutar código. Lo que hacen los miembros en el chat está en Analizar una hoja de cálculo.

Las preguntas sobre una hoja de cálculo corresponden a estas herramientas, no a un almacén de datos: un almacén de datos guarda registros que una aplicación escribe y lee, no un archivo sobre el que alguien tiene una pregunta.

Las tres herramientas¶

Dale las tres a un asistente. Con solo Ejecutar código sí calcula, y los gráficos y tablas aparecen en el texto de su respuesta, pero las imágenes y archivos que crea el código no llegan a la respuesta.

Quién puede hacer qué¶

• Ver las herramientas en la Sala de máquinas puede quien puede cambiar la toolbox: los administradores de la organización y un rol propio con el derecho a cambiar la toolbox.
• Dar las herramientas a un asistente puede quien puede cambiar ese asistente.
• Usarlas puede cualquiera que pueda chatear con el asistente. Una regla que prohíbe estas herramientas a alguien también vale cuando esa persona chatea con el asistente.

Dónde encontrar las herramientas¶

Las tres herramientas son solo para asistentes: una persona no puede usarlas ella misma en AI Toolbox. Forman parte de la toolbox de cada organización, sin que nadie tenga que activarlas antes. Las encuentras en la pestaña Herramientas de cada asistente, y en la Sala de máquinas como Solo asistentes; en Para quién, elige Solo asistentes para ver solo esas herramientas. No tienen el interruptor También para personas, porque una persona no puede usarlas.

Puedes ponerlas en un grupo en la Sala de máquinas para mantenerlas juntas; en la pestaña Herramientas de un asistente activas cada una por separado.

Dar las herramientas a un asistente¶

1. Abre los ajustes del asistente y elige la pestaña Herramientas.
2. Busca ordenador o código y elige Activar en Ejecutar código, Escribir un archivo en el ordenador y Leer o exportar un archivo del ordenador. Cada elección guarda enseguida una nueva versión del asistente.
3. Comprueba en la pestaña Ajustes que Permitir subir archivos en los mensajes del chat está activado; si no, nadie puede enviar archivos al asistente.

Un empleado virtual del asistente puede usar las mismas herramientas con los archivos que recibe su ejecución.

Dos avisos en la pestaña Herramientas¶

Encima de las herramientas puede aparecer uno de estos avisos. Guardar sigue siendo posible; solo dicen lo que el asistente no puede hacer entonces.

• El asistente puede ejecutar código, pero no devolver archivos. El asistente tiene Ejecutar código sin Leer o exportar un archivo del ordenador. Elige el botón del aviso para activar esa herramienta.
• Nadie puede enviar archivos a este asistente. Permitir subir archivos en los mensajes del chat está desactivado. Elige Ir a Configuración y actívalo, salvo que el asistente solo deba calcular con lo que hay en la conversación.

Cuando las herramientas no están disponibles¶

Si tu organización no puede ejecutar código, las tres herramientas aparecen en gris en la pestaña Herramientas, con no disponible en lugar de Activar, y una línea que dice por qué:

El mismo motivo aparece en Configuración de la organización, en el aviso de que tu organización no crea archivos de Word, Excel ni PowerPoint, con cuándo lo intentó OS por última vez. OS vuelve a comprobarlo cada día. Una vez permitidos los ordenadores, puedes activar las herramientas enseguida; pueden pasar hasta un día aproximadamente antes de que funcionen en el chat.

Si tu organización pierde los ordenadores cuando un asistente ya tiene las herramientas, siguen activadas y la tarjeta dice No funciona ahora: tu organización ya no puede ejecutar código. El chat muestra por qué. Desactivar sigue funcionando. Quien intenta activar una herramienta cuando no es posible recibe Ejecutar código no está disponible: tu organización no puede ejecutar código.

Lo que cuesta¶

Una respuesta en la que el asistente ejecutó código consume, además de los tokens del modelo, tiempo de ordenador: los segundos que estuvo funcionando su ordenador. Ese tiempo cuenta para el consumo de tu organización y para su presupuesto mensual, como todo consumo. Una respuesta sin código no consume tiempo de ordenador. OS aún no muestra el tiempo de ordenador: ni en el chat ni en una página propia.

Lo que queda registrado¶

• Activar queda en el registro de auditoría de tu organización, como un cambio en el asistente, con la versión que escribió.
• Cada ordenador lo registra Artific Core: cuándo se creó y cuándo desapareció, cuánto tiempo funcionó, y por cada paso qué tipo de paso fue, cuánto duró y con qué código de salida. Los comandos mismos, su salida y los nombres de archivo no figuran allí; solo están en el chat y en la pestaña Registros de sesión del asistente. OS no registra nada por respuesta, para que nada quede registrado dos veces.

Datos y red¶

El ordenador no tiene internet, y OS nunca lo activa. El código que escribe el modelo no puede, por tanto, enviar un archivo a ningún sitio, diga lo que diga una celda. Un archivo del chat se copia a un ordenador en la región donde tu organización recibe ordenadores; si tu política no permite esa región, cada paso se rechaza y el chat lo dice.

Por la API¶

• GET /api/v1/organisations/{id}/assistants/tool-choices devuelve unavailable en cada una de las tres herramientas: null, not_permitted o no_computers.
• Un guardado del asistente que añade una de las tres cuando tu organización no puede ejecutar código recibe 422; el campo type del error es el motivo.
• GET /api/v1/organisations/{id}/toolbox/elements?offered_to=agents incluye las tres herramientas, con fixed: false, para quien puede cambiar la toolbox.