supervisoragents

package
v0.0.1-dev.7 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 8, 2026 License: Apache-2.0 Imports: 20 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type App

type App struct {
	// App name
	Name *string `fieldmask:"name"`
}

<Databricks> app. Supported app: custom mcp, custom agent..

type Client

type Client struct {
	// contains filtered or unexported fields
}

func NewClient

func NewClient(ctx context.Context, opts ...client.Option) (*Client, error)

func (*Client) CreateExample

func (c *Client) CreateExample(ctx context.Context, req CreateExampleRequest, opts ...call.Option) (*Example, error)

Creates an example for a Supervisor Agent.

func (*Client) CreateSupervisorAgent

func (c *Client) CreateSupervisorAgent(ctx context.Context, req CreateSupervisorAgentRequest, opts ...call.Option) (*SupervisorAgent, error)

Creates a new Supervisor Agent.

func (*Client) CreateTool

func (c *Client) CreateTool(ctx context.Context, req CreateToolRequest, opts ...call.Option) (*Tool, error)

Creates a Tool under a Supervisor Agent. Specify one of "genie_space", "knowledge_assistant", "uc_function", "uc_connection", "app", "volume", "dashboard", "table", "vector_search_index", "catalog", "schema", "supervisor_agent", "databricks_web_search", "skill" in the request body. The legacy values "lakeview_dashboard", "uc_table", and "web_search" are also accepted and remain equivalent to "dashboard", "table", and "databricks_web_search" respectively. The "databricks_web_search" tool_type maps to the `web_search` spec field.

func (*Client) DeleteExample

func (c *Client) DeleteExample(ctx context.Context, req DeleteExampleRequest, opts ...call.Option) error

Deletes an example from a Supervisor Agent.

func (*Client) DeleteSupervisorAgent

func (c *Client) DeleteSupervisorAgent(ctx context.Context, req DeleteSupervisorAgentRequest, opts ...call.Option) error

Deletes a Supervisor Agent.

func (*Client) DeleteTool

func (c *Client) DeleteTool(ctx context.Context, req DeleteToolRequest, opts ...call.Option) error

Deletes a Tool.

func (*Client) GetExample

func (c *Client) GetExample(ctx context.Context, req GetExampleRequest, opts ...call.Option) (*Example, error)

Gets an example from a Supervisor Agent.

func (*Client) GetSupervisorAgent

func (c *Client) GetSupervisorAgent(ctx context.Context, req GetSupervisorAgentRequest, opts ...call.Option) (*SupervisorAgent, error)

Gets a Supervisor Agent.

func (*Client) GetTool

func (c *Client) GetTool(ctx context.Context, req GetToolRequest, opts ...call.Option) (*Tool, error)

Gets a Tool.

func (*Client) ListExamples

func (c *Client) ListExamples(ctx context.Context, req ListExamplesRequest, opts ...call.Option) (*ListExamplesResponse, error)

Lists examples under a Supervisor Agent.

func (*Client) ListExamplesIter

func (c *Client) ListExamplesIter(ctx context.Context, req ListExamplesRequest, opts ...call.Option) iter.Seq2[*Example, error]

ListExamplesIter returns an iterator that iterates over the results of ListExamples.

For example:

for item, err := range c.ListExamplesIter(ctx, ListExamplesRequest{}) {
  if err != nil {
    return err
  }
  fmt.Println(item)
}

Options opts are passed to each ListExamples call made by the iterator under the hood.

Callers who need custom pagination logic should use ListExamples directly.

func (*Client) ListSupervisorAgents

func (c *Client) ListSupervisorAgents(ctx context.Context, req ListSupervisorAgentsRequest, opts ...call.Option) (*ListSupervisorAgentsResponse, error)

Lists Supervisor Agents.

func (*Client) ListSupervisorAgentsIter

func (c *Client) ListSupervisorAgentsIter(ctx context.Context, req ListSupervisorAgentsRequest, opts ...call.Option) iter.Seq2[*SupervisorAgent, error]

ListSupervisorAgentsIter returns an iterator that iterates over the results of ListSupervisorAgents.

For example:

for item, err := range c.ListSupervisorAgentsIter(ctx, ListSupervisorAgentsRequest{}) {
  if err != nil {
    return err
  }
  fmt.Println(item)
}

Options opts are passed to each ListSupervisorAgents call made by the iterator under the hood.

Callers who need custom pagination logic should use ListSupervisorAgents directly.

func (*Client) ListTools

func (c *Client) ListTools(ctx context.Context, req ListToolsRequest, opts ...call.Option) (*ListToolsResponse, error)

Lists Tools under a Supervisor Agent.

func (*Client) ListToolsIter

func (c *Client) ListToolsIter(ctx context.Context, req ListToolsRequest, opts ...call.Option) iter.Seq2[*Tool, error]

ListToolsIter returns an iterator that iterates over the results of ListTools.

For example:

for item, err := range c.ListToolsIter(ctx, ListToolsRequest{}) {
  if err != nil {
    return err
  }
  fmt.Println(item)
}

Options opts are passed to each ListTools call made by the iterator under the hood.

Callers who need custom pagination logic should use ListTools directly.

func (*Client) UpdateExample

func (c *Client) UpdateExample(ctx context.Context, req UpdateExampleRequest, opts ...call.Option) (*Example, error)

Updates an example in a Supervisor Agent.

func (*Client) UpdateSupervisorAgent

func (c *Client) UpdateSupervisorAgent(ctx context.Context, req UpdateSupervisorAgentRequest, opts ...call.Option) (*SupervisorAgent, error)

Updates a Supervisor Agent. The fields that are required depend on the paths specified in `update_mask`. Only fields included in the mask will be updated.

func (*Client) UpdateTool

func (c *Client) UpdateTool(ctx context.Context, req UpdateToolRequest, opts ...call.Option) (*Tool, error)

Updates a Tool. Only the `description` field can be updated. To change immutable fields such as tool type, spec, or tool ID, delete the tool and recreate it.

type CreateExampleRequest

type CreateExampleRequest struct {
	// Parent resource where this example will be created. Format:
	// supervisor-agents/{supervisor_agent_id}
	Parent *string
	// The example to create under the parent Supervisor Agent.
	Example *Example
}

Create an example..

type CreateSupervisorAgentRequest

type CreateSupervisorAgentRequest struct {
	// The Supervisor Agent to create.
	SupervisorAgent *SupervisorAgent
}

type CreateToolRequest

type CreateToolRequest struct {
	// Parent resource where this tool will be created. Format:
	// supervisor-agents/{supervisor_agent_id}
	Parent *string
	Tool   *Tool
	// The ID to use for the tool, which will become the final component of the
	// tool's resource name.
	ToolId *string
}

type DeleteExampleRequest

type DeleteExampleRequest struct {
	// The resource name of the example to delete. Format:
	// supervisor-agents/{supervisor_agent_id}/examples/{example_id}
	Name *string
}

Delete an example..

type DeleteSupervisorAgentRequest

type DeleteSupervisorAgentRequest struct {
	// The resource name of the Supervisor Agent. Format:
	// supervisor-agents/{supervisor_agent_id}
	Name *string
}

type DeleteToolRequest

type DeleteToolRequest struct {
	// The resource name of the Tool. Format:
	// supervisor-agents/{supervisor_agent_id}/tools/{tool_id}
	Name *string
}

type Example

type Example struct {
	// Full resource name:
	// supervisor-agents/{supervisor_agent_id}/examples/{example_id}
	Name *string `fieldmask:"name"`
	// The example question.
	Question *string `fieldmask:"question"`
	// Guidelines for answering the question.
	Guidelines []string `fieldmask:"guidelines"`
	// The universally unique identifier (UUID) of the example.
	ExampleId *string `fieldmask:"example_id"`
}

An example associated with a Supervisor Agent. Contains a question and guidelines for how the agent should respond..

type GenieSpace

type GenieSpace struct {
	// Deprecated: use space_id instead. Still REQUIRED for backward compatibility
	// until a future API version removes it.
	Id *string `fieldmask:"id"`
}

type GetExampleRequest

type GetExampleRequest struct {
	// The resource name of the example. Format:
	// supervisor-agents/{supervisor_agent_id}/examples/{example_id}
	Name *string
}

Get an example..

type GetSupervisorAgentRequest

type GetSupervisorAgentRequest struct {
	// The resource name of the Supervisor Agent. Format:
	// supervisor-agents/{supervisor_agent_id}
	Name *string
}

type GetToolRequest

type GetToolRequest struct {
	// The resource name of the Tool. Format:
	// supervisor-agents/{supervisor_agent_id}/tools/{tool_id}
	Name *string
}

type KnowledgeAssistant

type KnowledgeAssistant struct {
	// Deprecated: use knowledge_assistant_id instead.
	ServingEndpointName *string `fieldmask:"serving_endpoint_name"`
	// The ID of the knowledge assistant.
	KnowledgeAssistantId *string `fieldmask:"knowledge_assistant_id"`
}

type ListExamplesRequest

type ListExamplesRequest struct {
	// Parent resource to list from. Format: supervisor-agents/{supervisor_agent_id}
	Parent *string
	// The maximum number of examples to return. If unspecified, at most 100
	// examples will be returned. The maximum value is 100; values above 100 will be
	// coerced to 100.
	PageSize *int
	// A page token, received from a previous `ListExamples` call. Provide this to
	// retrieve the subsequent page. If unspecified, the first page will be
	// returned.
	PageToken *string
}

List examples..

type ListExamplesResponse

type ListExamplesResponse struct {
	Examples      []Example
	NextPageToken *string
}

A list of Supervisor Agent examples..

type ListSupervisorAgentsRequest

type ListSupervisorAgentsRequest struct {
	// The maximum number of supervisor agents to return. If unspecified, at most
	// 100 supervisor agents will be returned. The maximum value is 100; values
	// above 100 will be coerced to 100.
	PageSize *int
	// A page token, received from a previous `ListSupervisorAgents` call. Provide
	// this to retrieve the subsequent page. If unspecified, the first page will be
	// returned.
	PageToken *string
}

type ListSupervisorAgentsResponse

type ListSupervisorAgentsResponse struct {
	SupervisorAgents []SupervisorAgent
	// A token that can be sent as `page_token` to retrieve the next page. If this
	// field is omitted, there are no subsequent pages.
	NextPageToken *string
}

type ListToolsRequest

type ListToolsRequest struct {
	// Parent resource to list from. Format: supervisor-agents/{supervisor_agent_id}
	Parent    *string
	PageSize  *int
	PageToken *string
}

type ListToolsResponse

type ListToolsResponse struct {
	Tools         []Tool
	NextPageToken *string
}

type SupervisorAgent

type SupervisorAgent struct {
	// The resource name of the SupervisorAgent. Format:
	// supervisor-agents/{supervisor_agent_id}
	Name *string `fieldmask:"name"`
	// The display name of the Supervisor Agent, unique at workspace level.
	DisplayName *string `fieldmask:"display_name"`
	// Description of what this agent can do (user-facing).
	Description *string `fieldmask:"description"`
	// Optional natural-language instructions for the supervisor agent.
	Instructions *string `fieldmask:"instructions"`
	// Deprecated: Use supervisor_agent_id instead.
	Id *string `fieldmask:"id"`
	// The universally unique identifier (UUID) of the Supervisor Agent.
	SupervisorAgentId *string `fieldmask:"supervisor_agent_id"`
	// The creator of the Supervisor Agent.
	Creator *string `fieldmask:"creator"`
	// Creation timestamp.
	CreateTime *types.Time `fieldmask:"create_time"`
	// The name of the supervisor agent's serving endpoint.
	EndpointName *string `fieldmask:"endpoint_name"`
	// The MLflow experiment ID.
	ExperimentId *string `fieldmask:"experiment_id"`
}

type Tool

type Tool struct {
	// Full resource name: supervisor-agents/{supervisor_agent_id}/tools/{tool_id}
	Name *string `fieldmask:"name"`
	// Deprecated: Use tool_id instead.
	Id *string `fieldmask:"id"`
	// Tool type. Must be one of: "genie_space", "knowledge_assistant",
	// "uc_function", "uc_connection", "uc_mcp", "app", "volume", "dashboard",
	// "serving_endpoint", "table", "vector_search_index", "catalog", "schema",
	// "supervisor_agent", "databricks_web_search", "skill". The legacy values
	// "lakeview_dashboard", "uc_table", and "web_search" are also accepted and
	// remain equivalent to "dashboard", "table", and "databricks_web_search"
	// respectively. The "databricks_web_search" tool_type maps to the `web_search`
	// spec field.
	ToolType *string `fieldmask:"tool_type"`
	// Specification for the tool type.
	Spec isTool_Spec
	// Description of what this tool does (user-facing).
	Description *string `fieldmask:"description"`
	// User specified id of the Tool.
	ToolId *string `fieldmask:"tool_id"`
	// contains filtered or unexported fields
}

type Tool_Spec_App

type Tool_Spec_App struct {
	App App `fieldmask:"app"`
}

Tool_Spec_App selects App for Tool.Spec.

type Tool_Spec_GenieSpace

type Tool_Spec_GenieSpace struct {
	GenieSpace GenieSpace `fieldmask:"genie_space"`
}

Tool_Spec_GenieSpace selects GenieSpace for Tool.Spec.

type Tool_Spec_KnowledgeAssistant

type Tool_Spec_KnowledgeAssistant struct {
	KnowledgeAssistant KnowledgeAssistant `fieldmask:"knowledge_assistant"`
}

Tool_Spec_KnowledgeAssistant selects KnowledgeAssistant for Tool.Spec.

type Tool_Spec_UcConnection

type Tool_Spec_UcConnection struct {
	UcConnection UcConnection `fieldmask:"uc_connection"`
}

Tool_Spec_UcConnection selects UcConnection for Tool.Spec.

type Tool_Spec_UcFunction

type Tool_Spec_UcFunction struct {
	UcFunction UcFunction `fieldmask:"uc_function"`
}

Tool_Spec_UcFunction selects UcFunction for Tool.Spec.

type Tool_Spec_Volume

type Tool_Spec_Volume struct {
	Volume Volume `fieldmask:"volume"`
}

Tool_Spec_Volume selects Volume for Tool.Spec.

type UcConnection

type UcConnection struct {
	Name *string `fieldmask:"name"`
}

Databricks UC connection. Supported connection: external mcp server..

type UcFunction

type UcFunction struct {
	// Full uc function name
	Name *string `fieldmask:"name"`
}

type UpdateExampleRequest

type UpdateExampleRequest struct {
	// The resource name of the example to update. Format:
	// supervisor-agents/{supervisor_agent_id}/examples/{example_id}
	Name    *string
	Example *Example
	// Comma-delimited list of fields to update on the example. Allowed values:
	// `question`, `guidelines`. Examples: - `question` - `question,guidelines`
	UpdateMask *types.FieldMask[Example]
}

Update an example..

type UpdateSupervisorAgentRequest

type UpdateSupervisorAgentRequest struct {
	// The SupervisorAgent to update.
	SupervisorAgent *SupervisorAgent
	// Field mask for fields to be updated.
	UpdateMask *types.FieldMask[SupervisorAgent]
}

type UpdateToolRequest

type UpdateToolRequest struct {
	// The Tool to update.
	Tool *Tool
	// Field mask for fields to be updated.
	UpdateMask *types.FieldMask[Tool]
}

type Volume

type Volume struct {
	// Full uc volume name
	Name *string `fieldmask:"name"`
}

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL