Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.galileo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Module

Resolve Galileo context for Agent Control calls. This module produces generic Agent Control targets from Galileo state. It does not import the Agent Control SDK; callers wire the two SDKs together explicitly. For Agent Control telemetry ingestion, use galileo.handlers.agent_control.

AgentControlTargetUnresolvedError

Raised when no Agent Control target can be resolved from available inputs.

AgentControlTarget

A target identifier that can be passed to Agent Control. Arguments
  • target_type: Opaque Agent Control target type. Agent Control treats this value as deployer-defined; Galileo currently auto-resolves only log_stream targets.
  • target_id: Opaque Agent Control target ID.
  • project_id: Galileo project ID for logs, debugging, and audit context only. Agent Control resolves project ownership from target_type and target_id.

get_agent_control_target

def get_agent_control_target(*,
                             target_type: str=LOG_STREAM_TARGET_TYPE,
                             target_id: str | None=None,
                             log_stream_id: str | None=None,
                             project_id: str | None=None) -> AgentControlTarget
Resolve an Agent Control target from explicit inputs or Galileo context. Resolution order:
  1. Explicit target_id.
  2. Explicit log_stream_id for log_stream targets.
  3. GALILEO_LOG_STREAM_ID for log_stream targets.
  4. An already-initialized galileo_context logger.
This helper does not resolve log stream names over the network. If only a log stream name is available, resolve it with the Galileo SDK first and pass the resulting ID explicitly.