/agents), justo encima de Flujos de trabajo. El encabezado de la página es
Agentes. También está disponible en la paleta de comandos (⌘ K).
Qué es un agente
Un agente combina cinco elementos, que se guardan juntos como una revisión:
Un agente lee sus propios archivos adjuntos para todas las personas que lo ejecutan y, aparte de eso, solo aquello que puede ver el miembro bajo cuya identidad se ejecuta. Solo realiza las acciones seleccionadas para él. Hive trata el texto de la personalidad y de la tarea como contenido no fiable, por lo que nada en las instrucciones de un agente puede ampliar sus permisos ni añadir una acción.
Adjuntar archivos como conocimiento
En el paso 2 del editor de agentes, Conocimientos y herramientas, la fila Archivos muestra los archivos de la Biblioteca que lee el agente (consulte Cómo se organiza el editor). Para añadir uno:- Seleccione + Añadir archivos y elija archivos que ya estén en su Biblioteca, o abra Subir archivos en el mismo selector para subir otros nuevos.
- Abra Google Drive, OneDrive o SharePoint en el mismo selector para añadir un archivo desde su propia cuenta conectada: busque sus archivos de Drive y OneDrive por nombre, empezando por los que se hayan modificado más recientemente, o explore un sitio de SharePoint, sus bibliotecas de documentos y sus carpetas. Consulte Archivos de Google Drive, OneDrive y SharePoint.
- Arrastre archivos desde su equipo hasta la fila Archivos o hasta el cuadro de redacción de Crear. Un contorno discontinuo con el texto Suelte archivos para añadirlos a este agente muestra dónde se añadirán.
Archivos de Google Drive, OneDrive y SharePoint
Un archivo que añade desde Google Drive, OneDrive o SharePoint se copia en su Biblioteca y después se adjunta como un archivo subido (Adjunto · Guarde para conservarlo). El agente lee la copia, nunca el archivo original, de modo que una ejecución nunca tiene que esperar al original ni falla por su causa. Necesita el rol de Operador o superior, y la cuenta debe ser una que usted haya conectado personalmente en Integraciones; si no hay ninguna conectada, el selector lo indica. En la fila Archivos, cada copia indica de dónde procede y cuándo la comprobó Hive por última vez, por ejemplo: Copiado de Google Drive · comprobado hace 2 h. Solo la persona que la añadió puede actualizarla:- Seleccione Actualizar en el archivo para comprobar el original en ese momento.
- Cuando abre el agente en Agent Studio, Hive comprueba sus copias si ha pasado más de una hora desde la última comprobación.
- Cuando despliega el agente, Hive vuelve a comprobar sus copias.
Quién puede leer los archivos de un agente
Los archivos y las carpetas adjuntos a un agente forman parte de él. Cuando lo comparte, todas las personas que pueden ejecutarlo tienen acceso a esos archivos al ejecutarlo en su página de ejecución, en Ask y en Continuar en el chat, incluso a los archivos que solo usted puede abrir en la Biblioteca:- En sus ejecuciones. El agente lee sus archivos adjuntos en su página de ejecución, en un chat de Ask donde alguien lo selecciona y en Continuar en el chat. Hive los lee con los permisos de acceso a la Biblioteca de quien guardó la última versión del agente.
- Imágenes. Cuando el modelo del agente lee imágenes (un modelo de visión), una imagen adjunta en formato JPEG, PNG, GIF o WebP le llega como imagen en su página de ejecución, en Ask y en Probar dentro del editor. Un modelo que no lee imágenes recibe, en su lugar, la descripción de la imagen que genera Hive (consulte Cómo lee Hive los archivos que elige).
- En sus chats. La persona que ejecuta el agente puede abrir desde ese chat un archivo que el agente haya utilizado, en modo de solo lectura: seleccione el nombre del archivo en Fuentes. Un PDF o una imagen se abre en una pestaña nueva; cualquier otro archivo se descarga.
- En ningún otro lugar. Los archivos no se añaden a la Biblioteca, a las búsquedas ni a Drive de quien ejecuta el agente, y esa persona no puede abrirlos fuera de un chat con el agente. Solo puede abrir el original en Google Drive, OneDrive o SharePoint si ese servicio se lo permite.
- Eliminar un archivo del agente y guardarlo revoca el acceso de inmediato: las nuevas ejecuciones ya no lo leen, ya no se puede abrir desde los chats del agente y se ocultan las respuestas anteriores de sus chats que lo utilizaron. El resultado de una ejecución en su propia página de ejecución sigue siendo visible para quien la ejecutó.
- Si la persona que guardó la última versión del agente abandona el espacio de trabajo o ya no puede abrir alguno de sus archivos, los archivos del agente solo se leen para quienes pueden abrirlos en su propia Biblioteca, hasta que alguien que pueda abrirlos todos vuelva a guardar el agente.
- Como antes, alguien a quien su espacio de trabajo impide acceder a la Biblioteca no puede usar los archivos de un agente. Un cliente de IA conectado al servidor MCP de Hive no puede ejecutar agentes ni abrir sus chats, por lo que nunca lee los archivos de un agente de esta forma.
Dónde se ejecutan los agentes
Todos los agentes desplegados están disponibles en Ask, en su propia página de ejecución y en los flujos de trabajo. No tiene que elegir dónde aparecen. El enlace público es independiente: se activa desde Enlace público en el editor.Ask Hive
Elija el agente en el selector de agentes del cuadro de redacción de Ask en lugar de Hive, la opción predeterminada.
Su propia página de ejecución
Complete el formulario del agente, ejecútelo, lea la respuesta y consulte sus ejecuciones anteriores.
Programaciones
Ejecute el agente de forma periódica con un prompt y una zona horaria fijos.
Flujos de trabajo
Añada un agente desplegado a un flujo de trabajo desde la Biblioteca de agentes del constructor.
Enlaces públicos
Comparta un agente fuera del espacio de trabajo, si su espacio de trabajo tiene activada esta opción.
Qué puede usar un agente según dónde se ejecute
Las habilidades obligatorias de su espacio de trabajo se suman a las
instrucciones del agente en cada uno de estos contextos, excepto en un enlace público.
Utilizar un agente en flujos de trabajo
Despliegue el agente. Sus revisiones desplegadas aparecerán en la Biblioteca de agentes del constructor de flujos de trabajo, en Agentes dentro del menú Añadir paso y en el panel Añadir un paso. Un paso de flujo de trabajo conserva la revisión con la que se añadió; cuando despliegue una más reciente, el paso ofrecerá Actualizar a la revisión N. Un paso de flujo de trabajo solo lee archivos y carpetas de la Biblioteca o enlaces de Google Docs como conocimiento y fuentes de ejecución, por lo que la Biblioteca de agentes muestra deshabilitado cualquier agente con otro tipo de conocimiento, habilidades, subagentes o una operación de conector que escriba datos, o con otras fuentes, e indica qué debe cambiar. El acceso web, Datos propios de la persona (incluidos los datos de Hive) y las aplicaciones conectadas de solo lectura funcionan en un paso: consulte Web, datos de Hive y aplicaciones conectadas. Sus acciones seleccionadas se ejecutan en el paso. Un agente creado antes de que existieran los pasos de flujo de trabajo debe volver a crearse a partir de una plantilla reutilizable. Consulte Pasos de la Biblioteca de agentes.Ejecutar un agente directamente
Cada agente desplegado tiene su propia página de ejecución en/agents/<agent id>/run. Ábrala con Ejecutar en
el menú ⋯ de la tarjeta del agente, o con Ejecutar este agente y ver sus ejecuciones en el panel Probar
del editor. Puede usarla si tiene el rol de Operador o superior y acceso de ejecución al agente: no necesita
poder editar el agente, y la página nunca muestra sus versiones en borrador.
La página muestra el nombre y la descripción del agente, seguidos de su formulario:
- Campos: las entradas que solicita el agente.
- Fuentes: los archivos y carpetas de la Biblioteca, u otras fuentes, que el agente lee para esta ejecución. Cuando una fuente admite archivos de la Biblioteca, puede añadir un archivo que aún no esté en ella con Subir a la Biblioteca en su selector; Hive lo selecciona por usted una vez subido. Necesita el rol de Operador o superior. Cada archivo puede tener hasta 25 MB y debe ser de un tipo que acepte la Biblioteca. Se guarda en la raíz de su Biblioteca y sigue las reglas de uso compartido de la Biblioteca, como cualquier otro archivo subido.
- Cuentas: cuáles de sus cuentas conectadas usa el agente cuando trabaja con aplicaciones conectadas.
- Instrucciones de ejecución (opcional): una nota para esta ejecución.
- Preguntas iniciales de conversación: las preguntas iniciales del agente, que aparecen en Instrucciones de ejecución (opcional). Seleccione una para añadirla a las instrucciones de ejecución; esto no inicia la ejecución.
Archivos que una ejecución escribe en su Biblioteca
Un agente con una plantilla de archivo de Word o Excel puede escribir el documento o libro que promete, como una carta de encargo o una propuesta, como un archivo nuevo en su Biblioteca cuando usted lo ejecuta desde su página de ejecución:- Su archivo. El archivo es suyo y se escribe en su nombre: en el nivel superior de su Biblioteca o en una de las carpetas adjuntas al agente que sea privada para usted y a la que pueda añadir archivos. Nunca se utiliza una carpeta compartida con otra persona ni una carpeta de la Base de conocimientos, por lo que lo que el agente haya leído para usted nunca acaba en un lugar donde el autor del agente o un colega pueda abrirlo.
- Sobre la plantilla del agente. Un archivo de Word se escribe sobre la plantilla de Word del agente y un libro sobre su plantilla de Excel, siempre que usted pueda abrir esa plantilla. Una plantilla privada solo se utiliza para un archivo que siga siendo privado para usted; de lo contrario, el archivo adopta el diseño propio de su espacio de trabajo. En una de las plantillas iniciales de Hive, el encabezado y el pie de página muestran el nombre de su firma en lugar de «[Company name]» y «[Firm name]»: el nombre que figura en el registro de su firma o, en su defecto, el nombre de su espacio de trabajo. Si Hive no conoce ninguno de los dos, los marcadores de posición permanecen en el archivo para que usted los rellene.
- Solo archivos nuevos. Una ejecución nunca modifica, sustituye, mueve ni elimina un archivo que ya esté en su Biblioteca. Escribe como máximo tres archivos, cada uno de ellos un borrador para que usted lo revise.
- En el resultado. Cada archivo aparece en Artefactos en el resultado de la ejecución, con la opción Abrir, que lo abre en su Biblioteca; la respuesta también incluye un enlace al archivo.
- Con registro. Cada archivo que escribe una ejecución queda registrado en el registro de auditoría como «La ejecución del agente ha creado un archivo en la Biblioteca», junto con el agente, la ejecución y el archivo.
Historial de ejecuciones
Debajo del formulario, Historial de ejecuciones muestra las ejecuciones del agente, de más reciente a más antigua:- Usted ve sus propias ejecuciones. Los administradores del espacio de trabajo ven las de todo el equipo y pueden filtrar por persona.
- Cada ejecución indica quién la inició: Usted en sus propias ejecuciones, el nombre del miembro en las de otra persona, o Miembro del espacio de trabajo si la persona ya no pertenece al espacio de trabajo. La lista Ejecuciones recientes de la página del agente en Agent Studio muestra lo mismo, en cada fila y en Iniciada por al abrir una ejecución.
- Filtre por estado. Cargar más muestra ejecuciones anteriores.
- Incluye las ejecuciones iniciadas en esta página, en Ask, mediante una programación, mediante un flujo de trabajo y las ejecuciones antiguas iniciadas con Ejecutar ahora.
- Cada ejecución tiene su propio enlace, por lo que una notificación sobre una ejecución la abre aquí.
- Una ejecución detenida por un límite aparece como bloqueada, con el motivo: el espacio de trabajo se ha quedado sin créditos, se ha alcanzado el límite mensual de un miembro o del agente, el espacio de trabajo es de solo lectura o tiene un pago vencido, o la política de modelos no permite el modelo del agente. Consulte Créditos y uso.
- La consulta y el inicio de la respuesta solo se muestran en sus propias ejecuciones. En la ejecución de otra persona, un administrador ve quién la ejecutó, cuándo, cómo se inició y su estado, pero no la consulta, la respuesta, sus gráficos ni sus pasos. Esto se aplica a la página de ejecución, al historial de ejecuciones y a las ejecuciones recientes de la página del agente. La respuesta de un agente en un chat de Ask forma parte de ese chat, por lo que cualquier persona que pueda abrirlo la ve, incluidos los administradores que puedan leer los chats de los miembros.
- Una ejecución cuyo chat de Ask se haya eliminado es de solo lectura: puede abrirla y leer su respuesta, pero no continuarla.
Explorar y organizar agentes
La lista muestra los agentes de los que usted es propietario y los que se han compartido con usted. Los administradores también pueden ver los agentes de todo el espacio de trabajo.- Ordenar por Más populares, Actualizados recientemente o A – Z.
- Cada tarjeta muestra cuántas veces se ha ejecutado el agente en los últimos 30 días y cuándo se ejecutó por última vez. Se cuentan todas las formas de ejecución: Ejecutar ahora, programaciones y activadores, su propia página, Ask y pasos de flujos de trabajo. Para usted se cuentan las ejecuciones que ha iniciado; para un administrador, las de todos. Más populares ordena según esas mismas ejecuciones.
- Cada tarjeta indica el propietario del agente: Usted, o el miembro que lo creó. Un agente que Hive haya configurado para usted en su espacio de trabajo (consulte Sugerencias para su espacio de trabajo) muestra Hive como propietario, nunca el nombre de una persona.
- Filtrar por estado: En producción, Borrador, En pausa o Archivado.
- Buscar agentes por nombre y descripción. Fije los que más utilice para que aparezcan en Agentes fijados.
- Importar agente incorpora un agente exportado como un nuevo borrador. Explorar plantillas le permite empezar con un agente prediseñado por Hive (consulte Plantillas de Hive). + Crear agente abre el editor, donde puede escribir o dictar lo que debe hacer el agente (consulte Crear un nuevo agente).
- Cuando una pestaña aún no contiene agentes, lo indica y ofrece Crear agente si su rol permite crearlos. Si una búsqueda o un filtro no encuentra resultados, se le pide que lo borre.
Acciones rápidas en la tarjeta de un agente
Cada tarjeta de agente tiene un menú ⋯, para que pueda realizar acciones sobre el agente sin abrirlo:Estados del agente
Quién puede hacer qué
Agent Studio respeta los roles de su espacio de trabajo (consulte Roles y permisos):- Crear un agente: Responsable de departamento, Administrador o Propietario. Las demás personas ven «Solo un responsable, administrador o propietario puede crear agentes». En Starter, un espacio de trabajo puede tener 3 agentes sin archivar, contando los de todos sus miembros; Team y los planes superiores no tienen un límite fijo. Al alcanzar el límite, se impide crear o copiar otro agente, y un espacio de trabajo que supere el límite de su plan (por ejemplo, tras cambiar a un plan inferior) no puede desplegar ningún agente hasta que archive algunos.
- Ejecutar un agente: Operador o superior, con acceso de ejecución a ese agente.
- Eliminar un agente: Responsable de departamento o superior.
- Gestionar la configuración de agentes del espacio de trabajo: Administrador o superior.
- Compartir: un agente es privado para su propietario hasta que lo comparte con colaboradores específicos. Compartir un agente nunca comparte las cuentas conectadas de su propietario. Sí permite que quienes puedan ejecutarlo utilicen los archivos adjuntos del agente al ejecutarlo desde su página de ejecución, en Ask y en Continuar en el chat, y que los abran desde sus chats, sin añadirlos a su Biblioteca: consulte Quién puede leer los archivos de un agente. Su nombre e icono siguen apareciendo en las respuestas que haya dado en un chat de Ask, para todas las personas con las que se comparta el chat; consulte Usar un agente en Ask.
Seguridad integrada
Las acciones de un agente siguen estas reglas:- Las acciones seleccionadas siguen el nivel de la cuenta. Una acción seleccionada del agente se ejecuta desde la cuenta propia del miembro, y el nivel de esa cuenta —respetando cualquier límite del espacio de trabajo— determina cómo: con Actuar, se ejecuta de inmediato; con Crear borrador, queda pendiente en una tarjeta de aprobación; con Leer, no realiza ninguna acción y la respuesta lo indica. Esto se aplica independientemente de cómo se haya iniciado la ejecución: por un miembro, una programación, un evento de aplicación o una señal. Consulte Qué hacen los agentes y los flujos de trabajo por sí solos.
- A dónde envía una acción. Una acción cuyo destinatario, canal, número de teléfono o enlace no proceda de las instrucciones del agente ni de lo que el miembro haya escrito en Hive para esa ejecución, como una dirección que el agente haya encontrado en un correo que ha leído, queda pendiente de la aprobación de ese miembro en una tarjeta en lugar de ejecutarse: en el chat o en Revisar decisión en su página Señales. La entrada guardada de una programación no se considera texto propio de ninguna persona. Escriba usted mismo en las instrucciones las direcciones, los canales y los enlaces que el agente puede usar: Describirlo y el chat Crear nunca añaden ninguno que usted no haya guardado o escrito en su descripción, y así lo indican (consulte Crear un agente). Consulte A dónde envía una acción.
- Acciones activadas o desactivadas. Establezca Qué puede hacer en Solo lee y responde, dentro de Avanzado en el paso 3, Entradas y salida, y el agente no realizará ninguna acción.
- Solo las acciones seleccionadas. Un agente solo realiza las acciones seleccionadas para sus aplicaciones adjuntas. Hive rechaza cualquier otra acción antes de que llegue a una cuenta. Un agente configurado antes de que se eligieran acciones por aplicación no realiza ninguna hasta que usted las seleccione.
- Herramientas MCP para todas las personas que lo ejecutan. Una herramienta MCP seleccionada se ejecuta con la conexión propia de quien la ejecuta al mismo servidor. A quien no tenga una se le indica que conecte el servidor (o, cuando Hive no haya podido cargar sus herramientas, se le informa de ello); a quien tenga dos conexiones al servidor se le indica que desconecte una. Si el servidor ha cambiado una herramienta desde que se marcó, esta se rechaza con una nota que pide al autor que vuelva a marcarla en Agent Studio, y la respuesta señala las herramientas marcadas únicamente para la conexión propia de su autor. Solo se pueden marcar nuevas herramientas de servidores que la persona que edita haya conectado.
- Presupuestos. Límites estrictos de tiempo de ejecución, llamadas al modelo, pasos de acción, escrituras externas y tokens. Una ejecución realiza, como máximo, tantos turnos como permita su presupuesto de llamadas al modelo, y nunca más de 16. Los agentes nuevos comienzan con los valores predeterminados de Hive (8 llamadas al modelo); un agente creado a partir de una plantilla que encadena varias herramientas comienza con más; seleccionar la primera acción de un agente permite una escritura externa por ejecución; y los agentes creados anteriormente conservan los presupuestos con los que se guardaron. Una vez agotado el presupuesto de escritura, Hive rechaza las acciones adicionales. Una acción que espera aprobación por su destino de envío no consume presupuesto de escritura, pero cuenta como uno de los pasos de acción de la ejecución. Además, se aplica el límite de tokens por ejecución de su plan, también en Ask.
- Límites del espacio de trabajo. El límite de acciones por hora y los límites de gasto siguen aplicándose a las acciones. Las acciones que estos límites impiden se rechazan, y el agente explica el motivo.
- Créditos. El trabajo del modelo de un agente, tanto si se ejecuta aquí como mediante una programación o cuando alguien le hace una consulta en Ask, consume créditos de IA: en Business, los del miembro que lo ejecuta (en una ejecución programada, el propietario de la programación; en un enlace público, quien lo publica), sin límite mensual por agente más allá de los créditos y el límite de recarga del propio miembro; en un plan anterior, los del fondo compartido del espacio de trabajo, hasta un límite mensual por agente de 2.000 créditos en Starter y Team y 10.000 en Business y Enterprise. Si ha aumentado el presupuesto de tokens de un agente por encima del valor predeterminado, una ejecución cuyo coste Hive estime en más de £5 (500 créditos en un plan anterior) le pedirá confirmación antes de comenzar; un agente con el presupuesto predeterminado nunca la pide. El cuadro de diálogo Desplegar muestra el coste máximo estimado de cada ejecución antes de que el agente entre en funcionamiento: en libras en Business y en créditos en un plan anterior. Una ejecución programada o iniciada por un evento que se haya quedado sin créditos espera hasta 72 horas a que haya créditos, y la tarjeta del agente en Agent Studio muestra 1 ejecución en espera de créditos (o el número correspondiente), o ¿Ejecutar cuando vuelva a haber créditos? cuando una ejecución lleva 72 horas esperando (consulte En espera de créditos).
- Fallos repetidos. Una acción que falla tres veces en una hora en la misma cuenta se pausa solo en esa cuenta, y el agente indica hasta cuándo. Volver a conectar la cuenta levanta la pausa. Consulte Cuando una acción falla repetidamente.
- Contenido externo. Un agente iniciado por un evento de aplicación (un correo nuevo, una operación nueva) lee lo que ha escrito alguien ajeno a su espacio de trabajo y sigue actuando. Una acción que enviaría información a una dirección, un canal o un enlace extraídos de ese contenido espera aprobación, pero una acción sobre un registro existente, como responder en un ticket de soporte, enviar o anular una factura o eliminar un contacto, no se retiene de este modo. Seleccione solo las acciones que esté dispuesto a permitir que realice sobre ese contenido y mantenga un presupuesto de escritura reducido.
- Interruptor de emergencia. Cuando un administrador activa el interruptor de emergencia, los agentes dejan de actuar, al igual que todo lo demás. Una ejecución o prueba ya en curso se detiene antes de realizar una acción, acceder a algo fuera de Hive (una búsqueda web o una aplicación conectada) o guardar su respuesta. Hasta entonces, puede realizar más llamadas al modelo, que se cobran como de costumbre, pero nada de lo que produzca se guarda ni se entrega. Pausar, archivar o retirar el despliegue del agente, o eliminar a la persona que inició la ejecución (o asignarle un rol inferior a Operador), detiene una ejecución en curso en esos mismos puntos.
- Registros. Las acciones completadas se registran en el registro de auditoría.
Los agentes reutilizables de los miembros están desactivados de forma predeterminada. Solo los verá si Hive los ha activado para su espacio de trabajo. Los enlaces públicos de agentes están disponibles para todos los espacios de trabajo: consulte Enlaces públicos de agentes.
Límites de un vistazo
Consulte la referencia de límites para conocer todos los límites.
Contenido relacionado
Crear un agente
Describa, configure, pruebe y despliegue su primer agente.
Publicar y evaluar
Análisis, comentarios, programaciones y enlaces públicos.