Documentation
¶
Index ¶
- type App
- type Client
- func (c *Client) CreateExample(ctx context.Context, req CreateExampleRequest, opts ...call.Option) (*Example, error)
- func (c *Client) CreateSupervisorAgent(ctx context.Context, req CreateSupervisorAgentRequest, opts ...call.Option) (*SupervisorAgent, error)
- func (c *Client) CreateTool(ctx context.Context, req CreateToolRequest, opts ...call.Option) (*Tool, error)
- func (c *Client) DeleteExample(ctx context.Context, req DeleteExampleRequest, opts ...call.Option) error
- func (c *Client) DeleteSupervisorAgent(ctx context.Context, req DeleteSupervisorAgentRequest, opts ...call.Option) error
- func (c *Client) DeleteTool(ctx context.Context, req DeleteToolRequest, opts ...call.Option) error
- func (c *Client) GetExample(ctx context.Context, req GetExampleRequest, opts ...call.Option) (*Example, error)
- func (c *Client) GetSupervisorAgent(ctx context.Context, req GetSupervisorAgentRequest, opts ...call.Option) (*SupervisorAgent, error)
- func (c *Client) GetTool(ctx context.Context, req GetToolRequest, opts ...call.Option) (*Tool, error)
- func (c *Client) ListExamples(ctx context.Context, req ListExamplesRequest, opts ...call.Option) (*ListExamplesResponse, error)
- func (c *Client) ListExamplesIter(ctx context.Context, req ListExamplesRequest, opts ...call.Option) iter.Seq2[*Example, error]
- func (c *Client) ListSupervisorAgents(ctx context.Context, req ListSupervisorAgentsRequest, opts ...call.Option) (*ListSupervisorAgentsResponse, error)
- func (c *Client) ListSupervisorAgentsIter(ctx context.Context, req ListSupervisorAgentsRequest, opts ...call.Option) iter.Seq2[*SupervisorAgent, error]
- func (c *Client) ListTools(ctx context.Context, req ListToolsRequest, opts ...call.Option) (*ListToolsResponse, error)
- func (c *Client) ListToolsIter(ctx context.Context, req ListToolsRequest, opts ...call.Option) iter.Seq2[*Tool, error]
- func (c *Client) UpdateExample(ctx context.Context, req UpdateExampleRequest, opts ...call.Option) (*Example, error)
- func (c *Client) UpdateSupervisorAgent(ctx context.Context, req UpdateSupervisorAgentRequest, opts ...call.Option) (*SupervisorAgent, error)
- func (c *Client) UpdateTool(ctx context.Context, req UpdateToolRequest, opts ...call.Option) (*Tool, error)
- type CreateExampleRequest
- type CreateSupervisorAgentRequest
- type CreateToolRequest
- type DeleteExampleRequest
- type DeleteSupervisorAgentRequest
- type DeleteToolRequest
- type Example
- type GenieSpace
- type GetExampleRequest
- type GetSupervisorAgentRequest
- type GetToolRequest
- type KnowledgeAssistant
- type ListExamplesRequest
- type ListExamplesResponse
- type ListSupervisorAgentsRequest
- type ListSupervisorAgentsResponse
- type ListToolsRequest
- type ListToolsResponse
- type SupervisorAgent
- type Tool
- type Tool_Spec_App
- type Tool_Spec_GenieSpace
- type Tool_Spec_KnowledgeAssistant
- type Tool_Spec_UcConnection
- type Tool_Spec_UcFunction
- type Tool_Spec_Volume
- type UcConnection
- type UcFunction
- type UpdateExampleRequest
- type UpdateSupervisorAgentRequest
- type UpdateToolRequest
- type Volume
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 (*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 ¶
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 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 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 ¶
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 ListToolsResponse ¶
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]
}