Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Agent Runtime ejecuta su agente en un proceso sin servidor hospedado en Azure Databricks. Ejecuta el servidor de su agente, como DurableAgentServer, en Databricks Apps, por lo que implementa código en lugar de aprovisionar servidores. Para saber cómo encaja Agent Runtime con tu framework y servidor de agentes, consulta Desplegar agentes en Azure Databricks.
Lo que ofrece Agent Runtime
-
Un punto final estable y autenticado: Cada despliegue es una aplicación llamada
agent-bricks-<name>con su propia URL. Los clientes se autentican con un token OAuth de Azure Databricks. Consulta Agentes de consulta desplegados en Azure Databricks. - Identidad del agente: el agente se ejecuta como la entidad de servicio de la aplicación. Ver Identidad del agente.
-
Ejecución duradera: Para los agentes que usan
DurableAgentServer, el despliegue prevé un Runtime Store para que el estado de ejecución sobreviva a los reinicios de los trabajadores y las ejecuciones interrumpidas puedan recuperarse. - Seguimiento: la implementación configura el seguimiento de MLflow para el experimento al que se enlaza el proyecto. Consulte la visión general del seguimiento.
- Escalado: ejecute un agente en 1 a 5 instancias. Consulta Escalado horizontal para aplicaciones Databricks.
Identidad del agente
La identidad de un agente es la entidad de servicio de la aplicación en la que se implementa. El agente utiliza esta identidad para llamar a las APIs de Azure Databricks y ejecutar herramientas que añades con --auth app.
- Cuando despliegas,
agentbricks deployotorga al principal de servicio acceso a los almacenes de memoria, sesión y estado de ejecución que utiliza el agente. - Para dar al agente acceso a otros datos y recursos, conceda a la entidad de servicio de la aplicación los permisos que necesite, igual que haría para cualquier aplicación. Consulte Configuración de la autorización en una aplicación de Databricks.
- Las herramientas que usan
auth = "user"se ejecutan con los permisos del usuario que envió la solicitud en lugar de la entidad de servicio. Consulte Autorización de solicitud de usuario.
Implementar un agente
Despliega un proyecto agente con la CLI de Agent Bricks:
agentbricks --profile <profile> deploy my-agent
agentbricks deploy hace lo siguiente:
- Crea o reutiliza los almacenes de memoria y sesión declarados en
agent.toml, y otorga acceso al principal de servicio de la aplicación a ellos. - Para los agentes que usan
DurableAgentServer, crea o reutiliza el Runtime Store del despliegue. - Configura el seguimiento.
- Despliega la aplicación.
Para ejecutar el agente en más de una instancia, pasa --instances:
agentbricks --profile <profile> deploy my-agent --instances 2
Cuando un agente se ejecuta en más de una instancia, los clientes pueden enviar el ID de sesión en una X-Routing-Key cabecera para enrutar todas las solicitudes de una sesión a la misma instancia.
Gestionar despliegues
| Comando | Description |
|---|---|
agentbricks deployments list |
Haz una lista de los despliegues de tus agentes. |
agentbricks deployments get <app-name> |
Muestra la URL, estado y descripción de un despliegue. |
agentbricks deployments logs <app-name> |
Muestra los registros de un despliegue. |
agentbricks deployments start <app-name> y agentbricks deployments stop <app-name> |
Inicia o detiene un despliegue. |
agentbricks deployments delete <app-name> |
Elimina una implementación. |
Como cada despliegue es una aplicación, también puedes verla y monitorizarla en las aplicaciones Databricks. Consulte Registro y supervisión de aplicaciones de Databricks.
Limitaciones
No puedes cambiar el servidor del agente de un despliegue existente. Para cambiar de servidor, cree un nuevo proyecto con la opción agentbricks init --server que desee e impleméntelo con otro nombre.