databricks-agentbricks 0.7.1__tar.gz → 0.8.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/PKG-INFO +179 -41
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/README.md +176 -40
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/pyproject.toml +4 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/app.py +38 -3
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/auth.py +6 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/deploy.py +8 -4
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/dev.py +26 -13
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/cli/endpoint.py +206 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/memory.py +20 -4
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/cli/permissions.py +185 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/sessions.py +4 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/clients/app_probe.py +82 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/apps_client.py +46 -6
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/conversation_store_client.py +10 -4
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/databricks_cli.py +48 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/local_ports.py +14 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/deploy.py +3 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/dev.py +14 -3
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/help.py +78 -5
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/presentation/loadtest.py +162 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/presentation/permissions.py +25 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deploy_service.py +99 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/deploy_state.py +2 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/dev_service.py +17 -10
- databricks_agentbricks-0.7.1/src/databricks_agentbricks/services/invoke_service.py → databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/endpoint_service.py +94 -34
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/transport.py +11 -3
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/__init__.py +1 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/_locustfile.py +305 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/plan.py +77 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/request.py +72 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/runner.py +165 -0
- databricks_agentbricks-0.8.0/src/databricks_agentbricks/services/loadtest/streaming.py +175 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-workflow/SKILL.md +3 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-workflow/references/deployment.md +2 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-workflow/references/state-and-tools.md +27 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/AGENTS.md +2 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/README.md +1 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/pyproject.toml +1 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/AGENTS.md +2 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/README.md +1 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/pyproject.toml +1 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/pyproject.toml +1 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/pyproject.toml +1 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/CHAT_APP.md +7 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/runtime/ui.py +106 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/tests/test_demo_ui.py +30 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/app.js +203 -47
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/index.html +39 -22
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/styles.css +170 -11
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/CHAT_APP.md +7 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/runtime/ui.py +106 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/tests/test_demo_ui.py +30 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/app.js +203 -47
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/index.html +39 -22
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/styles.css +170 -11
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/__init__.py +3 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/_api_client.py +77 -11
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/_pagination.py +6 -6
- databricks_agentbricks-0.8.0/src/databricks_agentkit/_permissions.py +44 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/memory_store.py +69 -7
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/ARCHITECTURE.md +29 -5
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/README.md +34 -7
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/app.py +99 -35
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/auth.py +4 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/execution.py +2 -2
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/lakebase_runtime_store.py +196 -74
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/recovery.py +1 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/store.py +6 -2
- databricks_agentbricks-0.8.0/src/databricks_agentkit/runtime/errors.py +247 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/execution.py +13 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/runtime.py +6 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/store.py +9 -1
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/types.py +2 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/session_store.py +69 -7
- databricks_agentbricks-0.7.1/src/databricks_agentbricks/cli/endpoint.py +0 -81
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/.gitignore +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/NOTICE +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/agent_hint.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/__main__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/doctor.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/experimental.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/init.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/mcp.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/models.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/pipeline.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/prompts.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/sandbox.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/telemetry.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/tools.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/cli/tracing.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/api_client_provider.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/apps_user_auth_client.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/legacy_runtime_store.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/local_tracing_client.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/managed_runtime_store.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/mlflow_trace_client.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/clients/tracing_client.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/errors.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/model_upgrade.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/endpoint.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/group.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/render.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/reporter.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/theme.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/presentation/tracing.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/agent_project.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/app_manifest.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/config.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/resolver.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/projects/types.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/py.typed +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/reporting.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/app_provisioner.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/config.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/model_binding_provisioner.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/names.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/provisioners.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/tool_access.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/deployment/tool_access_provisioner.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/auth.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/invoke/request.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/tracing/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/tracing/targets.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/services/tracing_service.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/skills.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-bricks-migrate/SKILL.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/.env.example +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/.gitignore +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/AGENTKIT_CONTRACT.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/CLAUDE.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/agent.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/mcps.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/tools/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/tools/sample_tool.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/agent/tools/send_message.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/app.yaml +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/runtime/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/runtime/adapter.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/runtime/main.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/test_agent.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/test_runtime.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-langgraph/tests/test_workspace.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/.env.example +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/.gitignore +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/AGENTKIT_CONTRACT.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/CLAUDE.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/agent.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/checkpoints.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/mcps.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/tools/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/tools/sample_tool.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/agent/tools/send_message.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/app.yaml +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/runtime/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/runtime/adapter.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/runtime/main.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_agent.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_checkpoints.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_runtime.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/agent-openai/tests/test_workspace.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/.env.example +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/.gitignore +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/README.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/agent/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/agent/agent.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/app.yaml +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/runtime/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/runtime/main.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-langgraph/tests/test_runtime.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/.env.example +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/.gitignore +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/README.md +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/agent/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/agent/agent.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/app.yaml +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/runtime/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/runtime/main.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/custom-agent-openai/tests/test_runtime.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/sandbox_mcp.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/sandbox_mcp_langgraph.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/runtime/main.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/agentbricks-mark.png +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-langgraph/ui/markdown-it-15.0.2.min.js +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/runtime/main.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/agentbricks-mark.png +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentbricks/templates/ui/agent-openai/ui/markdown-it-15.0.2.min.js +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/client.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/genie.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/history.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/mcp.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/memory.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/responses.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/langgraph/session_store.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/model_upgrades/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/model_upgrades/optimization.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/models.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/genie.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/history.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/mcp.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/memory.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/openai/sessions.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/py.typed +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/cors.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/__init__.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/durability/heartbeat.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/genie.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/mcp_auth.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/model_services.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/prompt_registry.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/session_store_client.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/tool_manifest.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/tracing.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/runtime/workspace.py +0 -0
- {databricks_agentbricks-0.7.1 → databricks_agentbricks-0.8.0}/src/databricks_agentkit/timefmt.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: databricks-agentbricks
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.8.0
|
|
4
4
|
Summary: Agent Bricks CLI and AgentKit SDK for custom agents on Databricks
|
|
5
5
|
Author-email: Databricks <agent-feedback@databricks.com>
|
|
6
6
|
License-File: NOTICE
|
|
@@ -27,6 +27,8 @@ Requires-Dist: langchain>=1.0.0; extra == 'langgraph'
|
|
|
27
27
|
Requires-Dist: langgraph>=1.1.0; extra == 'langgraph'
|
|
28
28
|
Requires-Dist: mlflow>=3.10.1; extra == 'langgraph'
|
|
29
29
|
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.25.0; extra == 'langgraph'
|
|
30
|
+
Provides-Extra: loadtest
|
|
31
|
+
Requires-Dist: locust>=2.31; extra == 'loadtest'
|
|
30
32
|
Provides-Extra: openai
|
|
31
33
|
Requires-Dist: databricks-agents>=1.9.3; extra == 'openai'
|
|
32
34
|
Requires-Dist: databricks-openai>=0.13.0; extra == 'openai'
|
|
@@ -232,10 +234,10 @@ agentbricks deployments wait agent-bricks-my-agent
|
|
|
232
234
|
```
|
|
233
235
|
|
|
234
236
|
`deployments wait` returns within 100 seconds (`--timeout`). Exit 0 means the agent is deployed and
|
|
235
|
-
|
|
236
|
-
of the deploy log; exit 75 means it is still deploying, so run the same command again.
|
|
237
|
-
with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`,
|
|
238
|
-
is a single JSON document. A second `deploy` of the same app is refused while one is still running
|
|
237
|
+
answering requests, and it prints the URL; exit 1 means the deploy failed, and it prints the error
|
|
238
|
+
and the end of the deploy log; exit 75 means it is still deploying, so run the same command again.
|
|
239
|
+
Don't poll with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`,
|
|
240
|
+
whose stdout is a single JSON document. A second `deploy` of the same app is refused while one is still running
|
|
239
241
|
from the project; the deploy's state and background log are in `.agentbricks/deploy-<app>.json` and
|
|
240
242
|
`.agentbricks/deploy-<app>.log`. If the App is busy with another operation, `deploy` retries for
|
|
241
243
|
about two minutes before failing.
|
|
@@ -374,9 +376,9 @@ writers to one path can overwrite each other. `add()`'s `write_mode` argument is
|
|
|
374
376
|
deprecated; use `put()` instead. `memory_store.list(actor_id=..., path=...)` returns the
|
|
375
377
|
memories at one exact path.
|
|
376
378
|
|
|
377
|
-
All `list()` methods return iterators that automatically consume server pages.
|
|
378
|
-
`page_size` and search `limit` values must be between 1 and 100
|
|
379
|
-
also auto-pages. `session.fork(...)` creates an independent copy, optionally through
|
|
379
|
+
All `list()` methods return iterators that automatically consume server pages. Store and content list
|
|
380
|
+
`page_size` and search `limit` values must be between 1 and 100; permission lists accept 1–1000.
|
|
381
|
+
`session.list_items()` also auto-pages. `session.fork(...)` creates an independent copy, optionally through
|
|
380
382
|
a specific item. Deleting a session with descendants requires
|
|
381
383
|
`session.delete(force=True)` to cascade the deletion.
|
|
382
384
|
|
|
@@ -401,9 +403,8 @@ agentbricks dev
|
|
|
401
403
|
agentbricks --profile <profile> deploy my-agent
|
|
402
404
|
```
|
|
403
405
|
|
|
404
|
-
Use the URL `agentbricks dev` prints (port 8000, or `--app-port`).
|
|
405
|
-
|
|
406
|
-
a few seconds while the app starts.
|
|
406
|
+
Use the URL `agentbricks dev` prints (port 8000, or `--app-port`). Agents on different ports can run
|
|
407
|
+
side by side. Requests can fail with HTTP 500 for a few seconds while the app starts.
|
|
407
408
|
|
|
408
409
|
Use `--framework openai` for OpenAI Agents. Templates keep agent code separate from the runtime
|
|
409
410
|
adapter and declare default Session and Memory Store bindings in `agent.toml`.
|
|
@@ -436,9 +437,10 @@ while its record is retained; using the ID for a different request returns `409`
|
|
|
436
437
|
|
|
437
438
|
`agentbricks dev` keeps execution state in process and loses it on restart. For projects with
|
|
438
439
|
`[agent].server = "agentbricks"`, `agentbricks deploy` provisions a persistent Runtime Store for requests,
|
|
439
|
-
status, events, and results.
|
|
440
|
-
|
|
441
|
-
|
|
440
|
+
status, events, and results. Queued work is reserved for the worker that accepted it, so other
|
|
441
|
+
replicas cannot start it through normal claims. Register `@app.recover` to restart interrupted
|
|
442
|
+
app-auth work or take over abandoned queued work after worker failures. Recovery is at-least-once,
|
|
443
|
+
so external side effects must be idempotent. Session and Memory Stores separately preserve agent state.
|
|
442
444
|
|
|
443
445
|
The managed path uses the internal Runtime Store API to create a dedicated database in the
|
|
444
446
|
workspace's shared Lakebase project and give the app SP ownership. The managed runtime initializes its schema and
|
|
@@ -450,8 +452,9 @@ The switch does not migrate existing deployments between backends. Managed clean
|
|
|
450
452
|
the app for retry. Direct app deletion bypasses managed store cleanup.
|
|
451
453
|
|
|
452
454
|
For a tool using `auth = "user"`, the Runtime Store still records token-free invocation state,
|
|
453
|
-
events, and results. The forwarded user credential remains
|
|
454
|
-
is never written to the Runtime Store. A replacement attempt
|
|
455
|
+
events, and results. The forwarded user credential remains in memory on the receiving worker while
|
|
456
|
+
queued and during the first attempt; it is never written to the Runtime Store. A replacement attempt
|
|
457
|
+
after failure recovery, including takeover before execution started, stops with
|
|
455
458
|
`MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because the original request credential is no longer present.
|
|
456
459
|
|
|
457
460
|
Use `server = "custom"` to deploy your own HTTP server without provisioning a Runtime Store.
|
|
@@ -683,6 +686,60 @@ agent = create_agent(model=..., tools=[*your_tools, *memory_tools(actor)])
|
|
|
683
686
|
> `session_store.grant_permission(principal_id)` or `memory_store.grant_permission(principal_id)`;
|
|
684
687
|
> `agentbricks deploy` does this for the deployed app automatically.
|
|
685
688
|
|
|
689
|
+
### Managing store permissions
|
|
690
|
+
|
|
691
|
+
Both store types support `permissions get`, `list`, `grant`, and `revoke`:
|
|
692
|
+
|
|
693
|
+
```sh
|
|
694
|
+
# Inspect your own effective access, or list explicit grants as the creator/admin.
|
|
695
|
+
agentbricks sessions stores permissions get support-agent-sessions
|
|
696
|
+
agentbricks memory stores permissions list memory-stores/<id> --all
|
|
697
|
+
|
|
698
|
+
# Grant a user READ or an app service principal WRITE.
|
|
699
|
+
agentbricks sessions stores permissions grant support-agent-sessions \
|
|
700
|
+
--user teammate@example.com --permission READ
|
|
701
|
+
agentbricks memory stores permissions grant memory-stores/<id> \
|
|
702
|
+
--service-principal <application-id> --permission WRITE
|
|
703
|
+
|
|
704
|
+
# Remove both READ and WRITE grants. --yes skips confirmation.
|
|
705
|
+
agentbricks memory stores permissions revoke memory-stores/<id> \
|
|
706
|
+
--service-principal <application-id> --yes
|
|
707
|
+
```
|
|
708
|
+
|
|
709
|
+
Session stores accept their configured name or `session-stores/<name>`. Memory stores accept an ID
|
|
710
|
+
or `memory-stores/<id>`; permission Get also accepts the display-name lookup supported by store Get
|
|
711
|
+
and rejects ambiguous matches. The global `--profile` and `--output json` options go before
|
|
712
|
+
`sessions` or `memory`. List follows the existing CLI pagination convention: one JSON/piped page
|
|
713
|
+
with `next_page_token`, interactive text pages, or every page with `--all`.
|
|
714
|
+
|
|
715
|
+
Get always returns the authenticated caller's effective permission, including
|
|
716
|
+
`PERMISSION_LEVEL_UNSPECIFIED` for no access (shown as "No access" in text). List reports direct
|
|
717
|
+
grants and excludes implicit ownership and inherited access. Grant/List/Revoke require the store
|
|
718
|
+
creator or a workspace admin, even if the caller has WRITE. Service principals use application/client
|
|
719
|
+
IDs, not numeric SCIM IDs. WRITE includes READ; granting READ preserves existing WRITE. Revoke
|
|
720
|
+
removes both levels of direct grants, is idempotent, and cannot revoke ownership or inherited access.
|
|
721
|
+
A later deploy can restore the app's grants. These APIs require workspace preview/feature enablement.
|
|
722
|
+
|
|
723
|
+
The Python SDK exposes the same operations on both store objects:
|
|
724
|
+
|
|
725
|
+
```python
|
|
726
|
+
# Existing service-principal grants retain the WRITE default.
|
|
727
|
+
session_store.grant_permission("<application-id>")
|
|
728
|
+
memory_store.grant_permission("teammate@example.com", principal_type="USER", permission="READ")
|
|
729
|
+
|
|
730
|
+
permission = session_store.get_permission()
|
|
731
|
+
print(permission.principal.name, permission.principal.principal_type, permission.permission)
|
|
732
|
+
for grant in memory_store.list_permissions(page_size=100):
|
|
733
|
+
print(grant.principal.name, grant.permission)
|
|
734
|
+
|
|
735
|
+
memory_store.revoke_permission("teammate@example.com", principal_type="USER")
|
|
736
|
+
```
|
|
737
|
+
|
|
738
|
+
`get_permission()` returns a `StorePermission`; `list_permissions()` returns an iterator of those
|
|
739
|
+
values and automatically follows every page. Each contains a `Principal` with `name` and
|
|
740
|
+
`principal_type`, plus a `permission` value. Grant/Revoke default to `SERVICE_PRINCIPAL`;
|
|
741
|
+
pass `principal_type="USER"` for user emails.
|
|
742
|
+
|
|
686
743
|
### How sessions and memory are keyed
|
|
687
744
|
|
|
688
745
|
In an agent generated by `agentbricks init`, each invocation picks its session and its memory
|
|
@@ -732,7 +789,7 @@ Memory and session stores are independent resources: deleting one never affects
|
|
|
732
789
|
For projects with `agent.toml`, unbinding either store removes its declaration; the next deploy
|
|
733
790
|
removes the corresponding `AGENT_MEMORY_STORE` or `AGENT_SESSION_STORE` entry from `app.yaml`.
|
|
734
791
|
Unbinding does not delete the store or revoke an existing grant to the App's service principal.
|
|
735
|
-
|
|
792
|
+
Use the permission commands below as the store creator or a workspace admin to revoke access.
|
|
736
793
|
|
|
737
794
|
## Model and prompt upgrades (experimental)
|
|
738
795
|
|
|
@@ -867,6 +924,9 @@ agentbricks [-p <profile>] [-o text|json]
|
|
|
867
924
|
list | get | logs | start | stop | delete
|
|
868
925
|
endpoint
|
|
869
926
|
invoke [APP] --path PATH [--url URL] [--json JSON] [--sse]
|
|
927
|
+
loadtest [APP] --path PATH [--url URL] [--requests FILE] [--sse]
|
|
928
|
+
[--concurrency N] [--max-duration SECONDS] [--max-requests N] [--no-warmup]
|
|
929
|
+
[--report-dir PATH] [--save-responses FILE]
|
|
870
930
|
```
|
|
871
931
|
|
|
872
932
|
## Bring an existing agent
|
|
@@ -967,6 +1027,96 @@ as the session id - put the session id at the top level of the `--json` body for
|
|
|
967
1027
|
also works with a direct App URL and with the generated runtime on localhost. OAuth and session headers are managed by
|
|
968
1028
|
the runtime; arbitrary custom request headers are intentionally not exposed by this command.
|
|
969
1029
|
|
|
1030
|
+
## Load test HTTP endpoints
|
|
1031
|
+
|
|
1032
|
+
`agentbricks endpoint loadtest` repeats HTTP requests with Locust. The load generator runs on the
|
|
1033
|
+
machine where you execute the command; the target can be a deployed Databricks App, localhost, or
|
|
1034
|
+
another HTTP server. Each measured request is one HTTP exchange, including the complete response
|
|
1035
|
+
body or SSE stream. A `202 Accepted` response measures submission, not eventual background work.
|
|
1036
|
+
|
|
1037
|
+
Install the optional dependency and create a JSON array of complete request bodies. A one-element
|
|
1038
|
+
array repeats one body; multiple bodies cycle in order. Omit `--requests` for a bodyless request.
|
|
1039
|
+
`endpoint invoke` retains `--json` for a single request; load testing uses only `--requests`.
|
|
1040
|
+
|
|
1041
|
+
```sh
|
|
1042
|
+
pip install 'databricks-agentbricks[loadtest]'
|
|
1043
|
+
cat > requests.json <<'JSON'
|
|
1044
|
+
[
|
|
1045
|
+
{
|
|
1046
|
+
"id": "{{request_id}}",
|
|
1047
|
+
"session_id": "{{user_id}}",
|
|
1048
|
+
"input": [{"role": "user", "content": "Hello"}],
|
|
1049
|
+
"stream": true
|
|
1050
|
+
}
|
|
1051
|
+
]
|
|
1052
|
+
JSON
|
|
1053
|
+
agentbricks --profile <profile> endpoint loadtest agent-bricks-my-agent \
|
|
1054
|
+
--path /api/invocations --requests requests.json --sse \
|
|
1055
|
+
--concurrency 5 --max-duration 60 --max-requests 200 --report-dir results/loadtest
|
|
1056
|
+
```
|
|
1057
|
+
|
|
1058
|
+
`--concurrency` sets simultaneous users (default: 1). Each sends another request after its previous
|
|
1059
|
+
request finishes. `--max-duration` is in seconds (default: 60); `--max-requests` optionally caps measured
|
|
1060
|
+
requests. Whichever limit is reached first stops dispatch, then in-flight requests drain for up to
|
|
1061
|
+
`--timeout` seconds. Ctrl-C also drains and preserves a partial report. Failed or incomplete
|
|
1062
|
+
requests make the command exit nonzero; cancellation exits 130 or 143 for SIGINT or SIGTERM.
|
|
1063
|
+
|
|
1064
|
+
By default, one real **warm-up** request runs before measurement using the first body. It can incur
|
|
1065
|
+
model/tool costs, mutate state, and warm the endpoint. Its request and latency, including cold-start
|
|
1066
|
+
latency, are excluded from the cap, report counts, and timings. A failed warm-up stops the test.
|
|
1067
|
+
Use `--no-warmup` to send only measured requests, including any cold-start latency. Reports state
|
|
1068
|
+
whether the excluded warm-up ran. Set a suitable `--timeout` for the complete response.
|
|
1069
|
+
|
|
1070
|
+
Request bodies support two identity lifetimes:
|
|
1071
|
+
|
|
1072
|
+
| Placeholder | Lifetime | Example use |
|
|
1073
|
+
| --- | --- | --- |
|
|
1074
|
+
| `{{request_id}}` | Fresh UUID per request, including the excluded warm-up | Agent invocation/idempotency ID |
|
|
1075
|
+
| `{{user_id}}` | Stable UUID per simulated user; warm-up uses its own identity | Agent session ID |
|
|
1076
|
+
| `{{uuid}}` | Alias of the current `{{request_id}}` | Existing request datasets |
|
|
1077
|
+
|
|
1078
|
+
Durable agents need a fresh invocation `id` for every request; a fixed ID can replay cached output.
|
|
1079
|
+
Use `{{request_id}}` for `id` and `{{user_id}}` for a session that should persist across one user's
|
|
1080
|
+
requests. By default, each App user's `X-Routing-Key` matches its generated user identity; an explicit
|
|
1081
|
+
`--routing-key` pins all users to that routing key. Routing and session contents are separate: include
|
|
1082
|
+
`session_id` in the body when the server requires it. Tests run closed-loop, without a think-time pause.
|
|
1083
|
+
|
|
1084
|
+
The final summary includes counts, throughput including drain, successful-only and all-completed
|
|
1085
|
+
latency percentiles, answer-text TTFT, token usage, coverage, incomplete attempts, and generator CPU
|
|
1086
|
+
warnings. With `--output json` before `endpoint`, stdout contains one Agent Bricks summary object;
|
|
1087
|
+
progress stays on stderr. This is the same object saved as `summary.json`.
|
|
1088
|
+
Locust's rounded histogram buckets are used for percentiles; all-completed timings include failures.
|
|
1089
|
+
These bounded tests measure the selected workload and do not establish sustainable capacity or answer quality.
|
|
1090
|
+
|
|
1091
|
+
`--report-dir` writes **all HTML, CSV, and JSON formats together**: `index.html`, native `locust.html`
|
|
1092
|
+
charts, `locust_*.csv` statistics/history/errors, and `summary.json`. There is no format selector.
|
|
1093
|
+
Use a new or empty directory. Reports contain metrics and the target host, without raw request or
|
|
1094
|
+
answer content or credentials. Review the target host before sharing a report.
|
|
1095
|
+
|
|
1096
|
+
For SSE responses, latency includes stream completion. Answer-text TTFT recognizes supported
|
|
1097
|
+
DurableAgentServer, OpenAI Chat Completions, and Responses SSE events, ignoring metadata and tool
|
|
1098
|
+
events. Missing text/token usage is unknown, with coverage reported; token counts are never inferred.
|
|
1099
|
+
Runtime model-message usage is summed across distinct messages; repeated message IDs update that
|
|
1100
|
+
message's total. Chat Completions and Responses usage snapshots replace earlier totals.
|
|
1101
|
+
Recognized error events and truncated supported streams fail the request. This command does not
|
|
1102
|
+
perform background polling, reconnect, or stream replay.
|
|
1103
|
+
|
|
1104
|
+
To save responses, add `--save-responses responses.json`. This exports **every successful measured
|
|
1105
|
+
request**, without sampling; it excludes warm-up, failed requests, and incomplete responses.
|
|
1106
|
+
The new file has mode 0600 and must be outside `--report-dir`, in an existing parent directory.
|
|
1107
|
+
It contains raw request inputs, outputs, and explicit trace IDs returned by an already instrumented
|
|
1108
|
+
agent (`X-MLflow-Trace-ID` or top-level `trace_id`). Keep it private and out of shared report bundles.
|
|
1109
|
+
The export is streamed to disk rather than retaining all results in memory; size grows with the load.
|
|
1110
|
+
|
|
1111
|
+
```json
|
|
1112
|
+
{"schema_version":1,"case_count":1,"observations":[{"case_index":0,"inputs":{},"outputs":"...","trace_id":null}]}
|
|
1113
|
+
```
|
|
1114
|
+
|
|
1115
|
+
`case_index` is zero-based. Supported SSE outputs contain accumulated answer text; JSON outputs use
|
|
1116
|
+
its `output` value when present, otherwise the response body. Bodyless inputs are `null`.
|
|
1117
|
+
Use native MLflow APIs separately for evaluation; load testing does not run scorers, fetch traces,
|
|
1118
|
+
or enable server tracing.
|
|
1119
|
+
|
|
970
1120
|
## Command help
|
|
971
1121
|
|
|
972
1122
|
Use the conventional help flag at any command level. Every command's help includes runnable
|
|
@@ -996,6 +1146,9 @@ agentbricks tools remove mcp system.ai.web_search
|
|
|
996
1146
|
agentbricks tools list
|
|
997
1147
|
```
|
|
998
1148
|
|
|
1149
|
+
`agentbricks tools list` shows integrations you can add. To see the tools an agent already has, open
|
|
1150
|
+
**Tools** under Capabilities in the chat app.
|
|
1151
|
+
|
|
999
1152
|
### Managed tool identity and migration
|
|
1000
1153
|
|
|
1001
1154
|
`agentbricks tools add mcp`, `agentbricks tools add sandbox`, `agentbricks tools add uc-function`,
|
|
@@ -1091,11 +1244,16 @@ generated request-aware agent function.
|
|
|
1091
1244
|
|
|
1092
1245
|
Request-user invocations use the same synchronous, streaming, background, status, event-replay,
|
|
1093
1246
|
and idempotency APIs as app-auth invocations. The Runtime Store records only token-free request
|
|
1094
|
-
state, events, and results. The forwarded credential stays process-local
|
|
1095
|
-
attempt and closes when that attempt completes, fails, or is cancelled.
|
|
1247
|
+
state, events, and results. The forwarded credential stays process-local while queued and during
|
|
1248
|
+
the first attempt, and closes when that attempt completes, fails, or is cancelled. The store
|
|
1249
|
+
enforces affinity to the accepting worker. A replacement attempt after
|
|
1096
1250
|
failure recovery stops with `MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because no user credential is
|
|
1097
1251
|
available; neither the invoke nor recovery handler runs for that attempt.
|
|
1098
1252
|
|
|
1253
|
+
Event reconnection does not resume execution. OBO approval/resume remains unsupported
|
|
1254
|
+
(`MCP_USER_AUTH_HITL_UNSUPPORTED`). Upgrade all replicas before relying on affinity; see the
|
|
1255
|
+
[runtime guide](src/databricks_agentkit/runtime/README.md#deployed-execution) for details.
|
|
1256
|
+
|
|
1099
1257
|
Before deploying user-auth tools from an older project, migrate its request handler and framework
|
|
1100
1258
|
adapter to the current request-auth-aware `DurableAgentServer` template, then explicitly choose `user` or
|
|
1101
1259
|
`app` on **every** managed MCP, sandbox, or Genie entry. Changing `agent.toml` alone does not
|
|
@@ -1220,16 +1378,8 @@ with TOML inspection. Replace `agentbricks mcp list [--schema catalog.schema]` w
|
|
|
1220
1378
|
`agentbricks tools list --kind mcp [--schema catalog.schema]`; the former command is removed. Use
|
|
1221
1379
|
`agentbricks tools list --help` for the new discovery contract.
|
|
1222
1380
|
|
|
1223
|
-
|
|
1224
|
-
|
|
1225
|
-
|
|
1226
|
-
```sh
|
|
1227
|
-
AGENTBRICKS_E2E_PROFILE=<profile> .venv-functional/bin/pytest tests/e2e/tool_discovery_test.py -v
|
|
1228
|
-
```
|
|
1229
|
-
|
|
1230
|
-
The live checks compare default and MCP-filtered discovery with the compatibility service list.
|
|
1231
|
-
Set `AGENTBRICKS_E2E_SCHEMA=catalog.schema` to exercise an additional schema. The installed CLI's local
|
|
1232
|
-
add/review/remove flows and all updated help pages are covered by `tests/functional/cli_smoke_test.py`.
|
|
1381
|
+
The local add/review/remove flows and all updated help pages are covered by the unit tests
|
|
1382
|
+
(`tools_test.py`, `tools_discovery_test.py`, `cli_test.py`).
|
|
1233
1383
|
|
|
1234
1384
|
In managed-server templates, custom Python tools are code-first. Write them with the framework's native
|
|
1235
1385
|
decorator in `agent/tools/`: LangGraph uses `@tool`, while OpenAI Agents uses `@function_tool`. The
|
|
@@ -1358,18 +1508,6 @@ The effective caller needs access to the data, the SQL warehouse, and the select
|
|
|
1358
1508
|
where applicable. Agent Bricks CLI does not grant permissions or promise a service-principal fallback when
|
|
1359
1509
|
caller credentials lack access. An offline add succeeding does not establish runtime access.
|
|
1360
1510
|
|
|
1361
|
-
The opt-in live tests exercise both frameworks against the configured workspace and an existing
|
|
1362
|
-
Genie space. From `integrations/agentbricks`, with both framework extras installed:
|
|
1363
|
-
|
|
1364
|
-
```sh
|
|
1365
|
-
DATABRICKS_CONFIG_PROFILE=my-workspace RUN_AGENTBRICKS_GENIE_TESTS=1 \
|
|
1366
|
-
AGENTBRICKS_GENIE_SPACE_ID=SPACE_ID \
|
|
1367
|
-
uv run pytest tests/integration_tests/genie_tools_test.py
|
|
1368
|
-
```
|
|
1369
|
-
|
|
1370
|
-
By default they ask for the row count of `samples.nyctaxi.trips`. Set `AGENTBRICKS_GENIE_QUESTION` for
|
|
1371
|
-
another dataset and `AGENTBRICKS_GENIE_EXPECTED_VALUE` to assert a known result cell.
|
|
1372
|
-
|
|
1373
1511
|
## Initialize the chat app demo
|
|
1374
1512
|
|
|
1375
1513
|
The chat app is a LangGraph-specific init overlay, not a command that mutates an existing project.
|
|
@@ -191,10 +191,10 @@ agentbricks deployments wait agent-bricks-my-agent
|
|
|
191
191
|
```
|
|
192
192
|
|
|
193
193
|
`deployments wait` returns within 100 seconds (`--timeout`). Exit 0 means the agent is deployed and
|
|
194
|
-
|
|
195
|
-
of the deploy log; exit 75 means it is still deploying, so run the same command again.
|
|
196
|
-
with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`,
|
|
197
|
-
is a single JSON document. A second `deploy` of the same app is refused while one is still running
|
|
194
|
+
answering requests, and it prints the URL; exit 1 means the deploy failed, and it prints the error
|
|
195
|
+
and the end of the deploy log; exit 75 means it is still deploying, so run the same command again.
|
|
196
|
+
Don't poll with `sleep`. Progress lines with the elapsed time go to stderr, also under `-o json`,
|
|
197
|
+
whose stdout is a single JSON document. A second `deploy` of the same app is refused while one is still running
|
|
198
198
|
from the project; the deploy's state and background log are in `.agentbricks/deploy-<app>.json` and
|
|
199
199
|
`.agentbricks/deploy-<app>.log`. If the App is busy with another operation, `deploy` retries for
|
|
200
200
|
about two minutes before failing.
|
|
@@ -333,9 +333,9 @@ writers to one path can overwrite each other. `add()`'s `write_mode` argument is
|
|
|
333
333
|
deprecated; use `put()` instead. `memory_store.list(actor_id=..., path=...)` returns the
|
|
334
334
|
memories at one exact path.
|
|
335
335
|
|
|
336
|
-
All `list()` methods return iterators that automatically consume server pages.
|
|
337
|
-
`page_size` and search `limit` values must be between 1 and 100
|
|
338
|
-
also auto-pages. `session.fork(...)` creates an independent copy, optionally through
|
|
336
|
+
All `list()` methods return iterators that automatically consume server pages. Store and content list
|
|
337
|
+
`page_size` and search `limit` values must be between 1 and 100; permission lists accept 1–1000.
|
|
338
|
+
`session.list_items()` also auto-pages. `session.fork(...)` creates an independent copy, optionally through
|
|
339
339
|
a specific item. Deleting a session with descendants requires
|
|
340
340
|
`session.delete(force=True)` to cascade the deletion.
|
|
341
341
|
|
|
@@ -360,9 +360,8 @@ agentbricks dev
|
|
|
360
360
|
agentbricks --profile <profile> deploy my-agent
|
|
361
361
|
```
|
|
362
362
|
|
|
363
|
-
Use the URL `agentbricks dev` prints (port 8000, or `--app-port`).
|
|
364
|
-
|
|
365
|
-
a few seconds while the app starts.
|
|
363
|
+
Use the URL `agentbricks dev` prints (port 8000, or `--app-port`). Agents on different ports can run
|
|
364
|
+
side by side. Requests can fail with HTTP 500 for a few seconds while the app starts.
|
|
366
365
|
|
|
367
366
|
Use `--framework openai` for OpenAI Agents. Templates keep agent code separate from the runtime
|
|
368
367
|
adapter and declare default Session and Memory Store bindings in `agent.toml`.
|
|
@@ -395,9 +394,10 @@ while its record is retained; using the ID for a different request returns `409`
|
|
|
395
394
|
|
|
396
395
|
`agentbricks dev` keeps execution state in process and loses it on restart. For projects with
|
|
397
396
|
`[agent].server = "agentbricks"`, `agentbricks deploy` provisions a persistent Runtime Store for requests,
|
|
398
|
-
status, events, and results.
|
|
399
|
-
|
|
400
|
-
|
|
397
|
+
status, events, and results. Queued work is reserved for the worker that accepted it, so other
|
|
398
|
+
replicas cannot start it through normal claims. Register `@app.recover` to restart interrupted
|
|
399
|
+
app-auth work or take over abandoned queued work after worker failures. Recovery is at-least-once,
|
|
400
|
+
so external side effects must be idempotent. Session and Memory Stores separately preserve agent state.
|
|
401
401
|
|
|
402
402
|
The managed path uses the internal Runtime Store API to create a dedicated database in the
|
|
403
403
|
workspace's shared Lakebase project and give the app SP ownership. The managed runtime initializes its schema and
|
|
@@ -409,8 +409,9 @@ The switch does not migrate existing deployments between backends. Managed clean
|
|
|
409
409
|
the app for retry. Direct app deletion bypasses managed store cleanup.
|
|
410
410
|
|
|
411
411
|
For a tool using `auth = "user"`, the Runtime Store still records token-free invocation state,
|
|
412
|
-
events, and results. The forwarded user credential remains
|
|
413
|
-
is never written to the Runtime Store. A replacement attempt
|
|
412
|
+
events, and results. The forwarded user credential remains in memory on the receiving worker while
|
|
413
|
+
queued and during the first attempt; it is never written to the Runtime Store. A replacement attempt
|
|
414
|
+
after failure recovery, including takeover before execution started, stops with
|
|
414
415
|
`MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because the original request credential is no longer present.
|
|
415
416
|
|
|
416
417
|
Use `server = "custom"` to deploy your own HTTP server without provisioning a Runtime Store.
|
|
@@ -642,6 +643,60 @@ agent = create_agent(model=..., tools=[*your_tools, *memory_tools(actor)])
|
|
|
642
643
|
> `session_store.grant_permission(principal_id)` or `memory_store.grant_permission(principal_id)`;
|
|
643
644
|
> `agentbricks deploy` does this for the deployed app automatically.
|
|
644
645
|
|
|
646
|
+
### Managing store permissions
|
|
647
|
+
|
|
648
|
+
Both store types support `permissions get`, `list`, `grant`, and `revoke`:
|
|
649
|
+
|
|
650
|
+
```sh
|
|
651
|
+
# Inspect your own effective access, or list explicit grants as the creator/admin.
|
|
652
|
+
agentbricks sessions stores permissions get support-agent-sessions
|
|
653
|
+
agentbricks memory stores permissions list memory-stores/<id> --all
|
|
654
|
+
|
|
655
|
+
# Grant a user READ or an app service principal WRITE.
|
|
656
|
+
agentbricks sessions stores permissions grant support-agent-sessions \
|
|
657
|
+
--user teammate@example.com --permission READ
|
|
658
|
+
agentbricks memory stores permissions grant memory-stores/<id> \
|
|
659
|
+
--service-principal <application-id> --permission WRITE
|
|
660
|
+
|
|
661
|
+
# Remove both READ and WRITE grants. --yes skips confirmation.
|
|
662
|
+
agentbricks memory stores permissions revoke memory-stores/<id> \
|
|
663
|
+
--service-principal <application-id> --yes
|
|
664
|
+
```
|
|
665
|
+
|
|
666
|
+
Session stores accept their configured name or `session-stores/<name>`. Memory stores accept an ID
|
|
667
|
+
or `memory-stores/<id>`; permission Get also accepts the display-name lookup supported by store Get
|
|
668
|
+
and rejects ambiguous matches. The global `--profile` and `--output json` options go before
|
|
669
|
+
`sessions` or `memory`. List follows the existing CLI pagination convention: one JSON/piped page
|
|
670
|
+
with `next_page_token`, interactive text pages, or every page with `--all`.
|
|
671
|
+
|
|
672
|
+
Get always returns the authenticated caller's effective permission, including
|
|
673
|
+
`PERMISSION_LEVEL_UNSPECIFIED` for no access (shown as "No access" in text). List reports direct
|
|
674
|
+
grants and excludes implicit ownership and inherited access. Grant/List/Revoke require the store
|
|
675
|
+
creator or a workspace admin, even if the caller has WRITE. Service principals use application/client
|
|
676
|
+
IDs, not numeric SCIM IDs. WRITE includes READ; granting READ preserves existing WRITE. Revoke
|
|
677
|
+
removes both levels of direct grants, is idempotent, and cannot revoke ownership or inherited access.
|
|
678
|
+
A later deploy can restore the app's grants. These APIs require workspace preview/feature enablement.
|
|
679
|
+
|
|
680
|
+
The Python SDK exposes the same operations on both store objects:
|
|
681
|
+
|
|
682
|
+
```python
|
|
683
|
+
# Existing service-principal grants retain the WRITE default.
|
|
684
|
+
session_store.grant_permission("<application-id>")
|
|
685
|
+
memory_store.grant_permission("teammate@example.com", principal_type="USER", permission="READ")
|
|
686
|
+
|
|
687
|
+
permission = session_store.get_permission()
|
|
688
|
+
print(permission.principal.name, permission.principal.principal_type, permission.permission)
|
|
689
|
+
for grant in memory_store.list_permissions(page_size=100):
|
|
690
|
+
print(grant.principal.name, grant.permission)
|
|
691
|
+
|
|
692
|
+
memory_store.revoke_permission("teammate@example.com", principal_type="USER")
|
|
693
|
+
```
|
|
694
|
+
|
|
695
|
+
`get_permission()` returns a `StorePermission`; `list_permissions()` returns an iterator of those
|
|
696
|
+
values and automatically follows every page. Each contains a `Principal` with `name` and
|
|
697
|
+
`principal_type`, plus a `permission` value. Grant/Revoke default to `SERVICE_PRINCIPAL`;
|
|
698
|
+
pass `principal_type="USER"` for user emails.
|
|
699
|
+
|
|
645
700
|
### How sessions and memory are keyed
|
|
646
701
|
|
|
647
702
|
In an agent generated by `agentbricks init`, each invocation picks its session and its memory
|
|
@@ -691,7 +746,7 @@ Memory and session stores are independent resources: deleting one never affects
|
|
|
691
746
|
For projects with `agent.toml`, unbinding either store removes its declaration; the next deploy
|
|
692
747
|
removes the corresponding `AGENT_MEMORY_STORE` or `AGENT_SESSION_STORE` entry from `app.yaml`.
|
|
693
748
|
Unbinding does not delete the store or revoke an existing grant to the App's service principal.
|
|
694
|
-
|
|
749
|
+
Use the permission commands below as the store creator or a workspace admin to revoke access.
|
|
695
750
|
|
|
696
751
|
## Model and prompt upgrades (experimental)
|
|
697
752
|
|
|
@@ -826,6 +881,9 @@ agentbricks [-p <profile>] [-o text|json]
|
|
|
826
881
|
list | get | logs | start | stop | delete
|
|
827
882
|
endpoint
|
|
828
883
|
invoke [APP] --path PATH [--url URL] [--json JSON] [--sse]
|
|
884
|
+
loadtest [APP] --path PATH [--url URL] [--requests FILE] [--sse]
|
|
885
|
+
[--concurrency N] [--max-duration SECONDS] [--max-requests N] [--no-warmup]
|
|
886
|
+
[--report-dir PATH] [--save-responses FILE]
|
|
829
887
|
```
|
|
830
888
|
|
|
831
889
|
## Bring an existing agent
|
|
@@ -926,6 +984,96 @@ as the session id - put the session id at the top level of the `--json` body for
|
|
|
926
984
|
also works with a direct App URL and with the generated runtime on localhost. OAuth and session headers are managed by
|
|
927
985
|
the runtime; arbitrary custom request headers are intentionally not exposed by this command.
|
|
928
986
|
|
|
987
|
+
## Load test HTTP endpoints
|
|
988
|
+
|
|
989
|
+
`agentbricks endpoint loadtest` repeats HTTP requests with Locust. The load generator runs on the
|
|
990
|
+
machine where you execute the command; the target can be a deployed Databricks App, localhost, or
|
|
991
|
+
another HTTP server. Each measured request is one HTTP exchange, including the complete response
|
|
992
|
+
body or SSE stream. A `202 Accepted` response measures submission, not eventual background work.
|
|
993
|
+
|
|
994
|
+
Install the optional dependency and create a JSON array of complete request bodies. A one-element
|
|
995
|
+
array repeats one body; multiple bodies cycle in order. Omit `--requests` for a bodyless request.
|
|
996
|
+
`endpoint invoke` retains `--json` for a single request; load testing uses only `--requests`.
|
|
997
|
+
|
|
998
|
+
```sh
|
|
999
|
+
pip install 'databricks-agentbricks[loadtest]'
|
|
1000
|
+
cat > requests.json <<'JSON'
|
|
1001
|
+
[
|
|
1002
|
+
{
|
|
1003
|
+
"id": "{{request_id}}",
|
|
1004
|
+
"session_id": "{{user_id}}",
|
|
1005
|
+
"input": [{"role": "user", "content": "Hello"}],
|
|
1006
|
+
"stream": true
|
|
1007
|
+
}
|
|
1008
|
+
]
|
|
1009
|
+
JSON
|
|
1010
|
+
agentbricks --profile <profile> endpoint loadtest agent-bricks-my-agent \
|
|
1011
|
+
--path /api/invocations --requests requests.json --sse \
|
|
1012
|
+
--concurrency 5 --max-duration 60 --max-requests 200 --report-dir results/loadtest
|
|
1013
|
+
```
|
|
1014
|
+
|
|
1015
|
+
`--concurrency` sets simultaneous users (default: 1). Each sends another request after its previous
|
|
1016
|
+
request finishes. `--max-duration` is in seconds (default: 60); `--max-requests` optionally caps measured
|
|
1017
|
+
requests. Whichever limit is reached first stops dispatch, then in-flight requests drain for up to
|
|
1018
|
+
`--timeout` seconds. Ctrl-C also drains and preserves a partial report. Failed or incomplete
|
|
1019
|
+
requests make the command exit nonzero; cancellation exits 130 or 143 for SIGINT or SIGTERM.
|
|
1020
|
+
|
|
1021
|
+
By default, one real **warm-up** request runs before measurement using the first body. It can incur
|
|
1022
|
+
model/tool costs, mutate state, and warm the endpoint. Its request and latency, including cold-start
|
|
1023
|
+
latency, are excluded from the cap, report counts, and timings. A failed warm-up stops the test.
|
|
1024
|
+
Use `--no-warmup` to send only measured requests, including any cold-start latency. Reports state
|
|
1025
|
+
whether the excluded warm-up ran. Set a suitable `--timeout` for the complete response.
|
|
1026
|
+
|
|
1027
|
+
Request bodies support two identity lifetimes:
|
|
1028
|
+
|
|
1029
|
+
| Placeholder | Lifetime | Example use |
|
|
1030
|
+
| --- | --- | --- |
|
|
1031
|
+
| `{{request_id}}` | Fresh UUID per request, including the excluded warm-up | Agent invocation/idempotency ID |
|
|
1032
|
+
| `{{user_id}}` | Stable UUID per simulated user; warm-up uses its own identity | Agent session ID |
|
|
1033
|
+
| `{{uuid}}` | Alias of the current `{{request_id}}` | Existing request datasets |
|
|
1034
|
+
|
|
1035
|
+
Durable agents need a fresh invocation `id` for every request; a fixed ID can replay cached output.
|
|
1036
|
+
Use `{{request_id}}` for `id` and `{{user_id}}` for a session that should persist across one user's
|
|
1037
|
+
requests. By default, each App user's `X-Routing-Key` matches its generated user identity; an explicit
|
|
1038
|
+
`--routing-key` pins all users to that routing key. Routing and session contents are separate: include
|
|
1039
|
+
`session_id` in the body when the server requires it. Tests run closed-loop, without a think-time pause.
|
|
1040
|
+
|
|
1041
|
+
The final summary includes counts, throughput including drain, successful-only and all-completed
|
|
1042
|
+
latency percentiles, answer-text TTFT, token usage, coverage, incomplete attempts, and generator CPU
|
|
1043
|
+
warnings. With `--output json` before `endpoint`, stdout contains one Agent Bricks summary object;
|
|
1044
|
+
progress stays on stderr. This is the same object saved as `summary.json`.
|
|
1045
|
+
Locust's rounded histogram buckets are used for percentiles; all-completed timings include failures.
|
|
1046
|
+
These bounded tests measure the selected workload and do not establish sustainable capacity or answer quality.
|
|
1047
|
+
|
|
1048
|
+
`--report-dir` writes **all HTML, CSV, and JSON formats together**: `index.html`, native `locust.html`
|
|
1049
|
+
charts, `locust_*.csv` statistics/history/errors, and `summary.json`. There is no format selector.
|
|
1050
|
+
Use a new or empty directory. Reports contain metrics and the target host, without raw request or
|
|
1051
|
+
answer content or credentials. Review the target host before sharing a report.
|
|
1052
|
+
|
|
1053
|
+
For SSE responses, latency includes stream completion. Answer-text TTFT recognizes supported
|
|
1054
|
+
DurableAgentServer, OpenAI Chat Completions, and Responses SSE events, ignoring metadata and tool
|
|
1055
|
+
events. Missing text/token usage is unknown, with coverage reported; token counts are never inferred.
|
|
1056
|
+
Runtime model-message usage is summed across distinct messages; repeated message IDs update that
|
|
1057
|
+
message's total. Chat Completions and Responses usage snapshots replace earlier totals.
|
|
1058
|
+
Recognized error events and truncated supported streams fail the request. This command does not
|
|
1059
|
+
perform background polling, reconnect, or stream replay.
|
|
1060
|
+
|
|
1061
|
+
To save responses, add `--save-responses responses.json`. This exports **every successful measured
|
|
1062
|
+
request**, without sampling; it excludes warm-up, failed requests, and incomplete responses.
|
|
1063
|
+
The new file has mode 0600 and must be outside `--report-dir`, in an existing parent directory.
|
|
1064
|
+
It contains raw request inputs, outputs, and explicit trace IDs returned by an already instrumented
|
|
1065
|
+
agent (`X-MLflow-Trace-ID` or top-level `trace_id`). Keep it private and out of shared report bundles.
|
|
1066
|
+
The export is streamed to disk rather than retaining all results in memory; size grows with the load.
|
|
1067
|
+
|
|
1068
|
+
```json
|
|
1069
|
+
{"schema_version":1,"case_count":1,"observations":[{"case_index":0,"inputs":{},"outputs":"...","trace_id":null}]}
|
|
1070
|
+
```
|
|
1071
|
+
|
|
1072
|
+
`case_index` is zero-based. Supported SSE outputs contain accumulated answer text; JSON outputs use
|
|
1073
|
+
its `output` value when present, otherwise the response body. Bodyless inputs are `null`.
|
|
1074
|
+
Use native MLflow APIs separately for evaluation; load testing does not run scorers, fetch traces,
|
|
1075
|
+
or enable server tracing.
|
|
1076
|
+
|
|
929
1077
|
## Command help
|
|
930
1078
|
|
|
931
1079
|
Use the conventional help flag at any command level. Every command's help includes runnable
|
|
@@ -955,6 +1103,9 @@ agentbricks tools remove mcp system.ai.web_search
|
|
|
955
1103
|
agentbricks tools list
|
|
956
1104
|
```
|
|
957
1105
|
|
|
1106
|
+
`agentbricks tools list` shows integrations you can add. To see the tools an agent already has, open
|
|
1107
|
+
**Tools** under Capabilities in the chat app.
|
|
1108
|
+
|
|
958
1109
|
### Managed tool identity and migration
|
|
959
1110
|
|
|
960
1111
|
`agentbricks tools add mcp`, `agentbricks tools add sandbox`, `agentbricks tools add uc-function`,
|
|
@@ -1050,11 +1201,16 @@ generated request-aware agent function.
|
|
|
1050
1201
|
|
|
1051
1202
|
Request-user invocations use the same synchronous, streaming, background, status, event-replay,
|
|
1052
1203
|
and idempotency APIs as app-auth invocations. The Runtime Store records only token-free request
|
|
1053
|
-
state, events, and results. The forwarded credential stays process-local
|
|
1054
|
-
attempt and closes when that attempt completes, fails, or is cancelled.
|
|
1204
|
+
state, events, and results. The forwarded credential stays process-local while queued and during
|
|
1205
|
+
the first attempt, and closes when that attempt completes, fails, or is cancelled. The store
|
|
1206
|
+
enforces affinity to the accepting worker. A replacement attempt after
|
|
1055
1207
|
failure recovery stops with `MCP_USER_AUTH_RECOVERY_UNSUPPORTED` because no user credential is
|
|
1056
1208
|
available; neither the invoke nor recovery handler runs for that attempt.
|
|
1057
1209
|
|
|
1210
|
+
Event reconnection does not resume execution. OBO approval/resume remains unsupported
|
|
1211
|
+
(`MCP_USER_AUTH_HITL_UNSUPPORTED`). Upgrade all replicas before relying on affinity; see the
|
|
1212
|
+
[runtime guide](src/databricks_agentkit/runtime/README.md#deployed-execution) for details.
|
|
1213
|
+
|
|
1058
1214
|
Before deploying user-auth tools from an older project, migrate its request handler and framework
|
|
1059
1215
|
adapter to the current request-auth-aware `DurableAgentServer` template, then explicitly choose `user` or
|
|
1060
1216
|
`app` on **every** managed MCP, sandbox, or Genie entry. Changing `agent.toml` alone does not
|
|
@@ -1179,16 +1335,8 @@ with TOML inspection. Replace `agentbricks mcp list [--schema catalog.schema]` w
|
|
|
1179
1335
|
`agentbricks tools list --kind mcp [--schema catalog.schema]`; the former command is removed. Use
|
|
1180
1336
|
`agentbricks tools list --help` for the new discovery contract.
|
|
1181
1337
|
|
|
1182
|
-
|
|
1183
|
-
|
|
1184
|
-
|
|
1185
|
-
```sh
|
|
1186
|
-
AGENTBRICKS_E2E_PROFILE=<profile> .venv-functional/bin/pytest tests/e2e/tool_discovery_test.py -v
|
|
1187
|
-
```
|
|
1188
|
-
|
|
1189
|
-
The live checks compare default and MCP-filtered discovery with the compatibility service list.
|
|
1190
|
-
Set `AGENTBRICKS_E2E_SCHEMA=catalog.schema` to exercise an additional schema. The installed CLI's local
|
|
1191
|
-
add/review/remove flows and all updated help pages are covered by `tests/functional/cli_smoke_test.py`.
|
|
1338
|
+
The local add/review/remove flows and all updated help pages are covered by the unit tests
|
|
1339
|
+
(`tools_test.py`, `tools_discovery_test.py`, `cli_test.py`).
|
|
1192
1340
|
|
|
1193
1341
|
In managed-server templates, custom Python tools are code-first. Write them with the framework's native
|
|
1194
1342
|
decorator in `agent/tools/`: LangGraph uses `@tool`, while OpenAI Agents uses `@function_tool`. The
|
|
@@ -1317,18 +1465,6 @@ The effective caller needs access to the data, the SQL warehouse, and the select
|
|
|
1317
1465
|
where applicable. Agent Bricks CLI does not grant permissions or promise a service-principal fallback when
|
|
1318
1466
|
caller credentials lack access. An offline add succeeding does not establish runtime access.
|
|
1319
1467
|
|
|
1320
|
-
The opt-in live tests exercise both frameworks against the configured workspace and an existing
|
|
1321
|
-
Genie space. From `integrations/agentbricks`, with both framework extras installed:
|
|
1322
|
-
|
|
1323
|
-
```sh
|
|
1324
|
-
DATABRICKS_CONFIG_PROFILE=my-workspace RUN_AGENTBRICKS_GENIE_TESTS=1 \
|
|
1325
|
-
AGENTBRICKS_GENIE_SPACE_ID=SPACE_ID \
|
|
1326
|
-
uv run pytest tests/integration_tests/genie_tools_test.py
|
|
1327
|
-
```
|
|
1328
|
-
|
|
1329
|
-
By default they ask for the row count of `samples.nyctaxi.trips`. Set `AGENTBRICKS_GENIE_QUESTION` for
|
|
1330
|
-
another dataset and `AGENTBRICKS_GENIE_EXPECTED_VALUE` to assert a known result cell.
|
|
1331
|
-
|
|
1332
1468
|
## Initialize the chat app demo
|
|
1333
1469
|
|
|
1334
1470
|
The chat app is a LangGraph-specific init overlay, not a command that mutates an existing project.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "databricks-agentbricks"
|
|
3
|
-
version = "0.
|
|
3
|
+
version = "0.8.0"
|
|
4
4
|
description = "Agent Bricks CLI and AgentKit SDK for custom agents on Databricks"
|
|
5
5
|
authors = [
|
|
6
6
|
{ name="Databricks", email="agent-feedback@databricks.com" },
|
|
@@ -33,6 +33,9 @@ dependencies = [
|
|
|
33
33
|
]
|
|
34
34
|
|
|
35
35
|
[project.optional-dependencies]
|
|
36
|
+
loadtest = [
|
|
37
|
+
"locust>=2.31",
|
|
38
|
+
]
|
|
36
39
|
# Framework adapters are optional; the CLI, store SDK, and HTTP runtime install by default.
|
|
37
40
|
langgraph = [
|
|
38
41
|
"databricks-langchain==0.21.0",
|