Tiempo de ejecución del agente

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 de conexión estable y autenticado: cada implementación es una aplicación denominada agent-bricks-<name> con su propia dirección 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 Almacén de Tiempo de Ejecución para que el estado de ejecución sobreviva a los reinicios de los trabajadores y las ejecuciones interrumpidas puedan recuperarse.
  • Tracing: El despliegue configura el tracing de MLflow al experimento al que está vinculado el proyecto. Consulte la visión general del seguimiento.
  • Escalado: Ejecuta un agente a escala en múltiples 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 deploy otorga 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.

Requisitos previos

  • Instale la CLI de Databricks, Python 3.11 o superior, y uv.

  • Instala la CLI de Agent Bricks:

    uv tool install databricks-agentbricks
    
  • Inicia sesión en tu espacio de trabajo. agentbricks login guarda el perfil como predeterminado, de modo que los comandos posteriores puedan omitir --profile:

    databricks auth login --host <workspace-url> --profile <profile>
    agentbricks login --profile <profile>
    
  • Crea un proyecto de agente y accede a su directorio:

    agentbricks init my-agent
    cd my-agent
    

Despliega un agente

Despliegue un proyecto de agente con la CLI de Agent Bricks.

Despliega desde el directorio del proyecto

Para desplegar el agente, ejecute el siguiente comando desde el directorio del proyecto:

agentbricks deploy my-agent

Para desplegar en un espacio de trabajo distinto al predeterminado, pasa --profile <profile>.

El directorio de proyectos contiene agent.toml y app.yaml. Si ejecutas agentbricks deploy desde cualquier otro directorio, carga ese directorio en su lugar. Para desplegar un proyecto desde otro directorio, pasa --source <dir>.

El argumento de agentbricks deploy es el nombre del despliegue, de hasta 17 caracteres. La aplicación se llama agent-bricks-<name>, así que este ejemplo crea agent-bricks-my-agent. El primer despliegue registra el nombre en agent.toml, por lo que los despliegues posteriores desde el proyecto pueden omitirlo.

Un primer despliegue tarda unos minutos. El comando termina cuando el agente responde a las solicitudes.

agentbricks deploy Hace lo siguiente:

  1. 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.
  2. Para los agentes que usan DurableAgentServer, crea o reutiliza el Runtime Store del despliegue.
  3. Configura el seguimiento.
  4. Despliega la aplicación.

Para ejecutar el agente en más de una instancia, pasa --instances:

agentbricks 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.

Implementar sin esperar

Si un script o agente de codificación tiene un tiempo de espera de comando corto, despliegue sin esperar y luego espera el despliegue en un comando separado:

agentbricks deploy my-agent --no-wait
agentbricks deployments wait agent-bricks-my-agent

--no-wait ejecuta las comprobaciones rápidas y luego finaliza el despliegue en un proceso en segundo plano. agentbricks deployments wait Espera hasta 100 segundos por defecto. Para cambiar el límite, pasa --timeout. El comando sale con uno de los siguientes códigos:

  • 0: El agente está desplegado y responde a las solicitudes.
  • 1: El despliegue falló.
  • 75: El agente sigue desplegándose. Vuelve a ejecutar el comando .

Ejecute agentbricks deployments wait desde el directorio del proyecto o pase --source <dir>.

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 wait [<app-name>] Espera a que termine un despliegue. Por defecto usa el despliegue registrado en agent.toml.
agentbricks deployments logs <app-name> Muestra los registros de un despliegue.
agentbricks deployments start <app-name> Inicia un despliegue.
agentbricks deployments stop <app-name> Detener un despliegue. Pide confirmación a menos que pases --yes.
agentbricks deployments delete <app-name> Elimina una implementación. Pide confirmación a menos que pases --yes.

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.

Recursos adicionales