Trait ChatbotToolDeclaration 

pub trait ChatbotToolDeclaration {
    const NAME: &'static str;
    const CATEGORY: ToolCategory;

    // Required methods
    fn offer_requirements(
        user_context: &ChatbotTurnContext,
    ) -> Vec<ToolRequirement>;
    fn get_tool_definition() -> AzureLLMFunctionToolDefinition;
}

What a tool is called and how it is declared to the LLM.

Shared by the tools the server runs (ChatbotTool) and the tools the client answers (ClientChatbotTool): the two differ in who produces the output, not in how the tool is advertised.

Required Associated Constants

const NAME: &'static str

The name the LLM calls this tool by. The registries dispatch on it and Self::get_tool_definition must advertise it, so the two cannot drift apart.

const CATEGORY: ToolCategory

Which configured category of tools this belongs to. A chatbot offers it only if its configuration lists this category; the caller must still be authorized for it.

Required Methods

fn offer_requirements(user_context: &ChatbotTurnContext) -> Vec<ToolRequirement>

What the caller must be allowed to do against the turn itself for this tool to be offered to the LLM at all.

Coarse on purpose: no call has named a target yet, so this asks about the chatbot’s own course (or global permissions for a chatbot with none). The binding check is the tool’s call_requirements, against what the call actually targets. Empty for a tool the chatbot’s own access check already covers.

fn get_tool_definition() -> AzureLLMFunctionToolDefinition

The definition sent to the LLM as part of a chat request. Azure rejects it unless strict is true and the parameter schema forbids additional properties.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl ChatbotToolDeclaration for EditUserAccountTool

const NAME: &'static str = "edit_user_account"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportAccounts

impl ChatbotToolDeclaration for GeneratePasswordResetLinkTool

const NAME: &'static str = "generate_password_reset_link"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportAccounts

impl ChatbotToolDeclaration for ResetExercisesTool

const NAME: &'static str = "reset_exercises"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportLearningProgress

impl ChatbotToolDeclaration for UpdateCertificateTool

const NAME: &'static str = "update_certificate"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportLearningProgress

impl ChatbotToolDeclaration for UpdateCheatingStatusTool

const NAME: &'static str = "update_cheating_status"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportAcademicIntegrity

impl ChatbotToolDeclaration for AskMultipleChoiceQuestionTool

const NAME: &'static str

const CATEGORY: ToolCategory = ToolCategory::Interaction

impl ChatbotToolDeclaration for CertificateLookupTool

const NAME: &'static str = "certificate_lookup"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportLearningProgress

impl ChatbotToolDeclaration for CourseConfigurationTool

const NAME: &'static str = "course_configuration"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportCourses

impl ChatbotToolDeclaration for CourseFinderTool

const NAME: &'static str = "course_finder"

const CATEGORY: ToolCategory = ToolCategory::CourseCatalog

impl ChatbotToolDeclaration for CourseMaterialSearchTool

const NAME: &'static str = "course_material_search"

const CATEGORY: ToolCategory = ToolCategory::CourseMaterial

impl ChatbotToolDeclaration for CourseProgressTool

const NAME: &'static str = "course_progress"

const CATEGORY: ToolCategory = ToolCategory::CourseInfo

impl ChatbotToolDeclaration for CourseStructureTool

const NAME: &'static str = "course_structure"

const CATEGORY: ToolCategory = ToolCategory::CourseInfo

impl ChatbotToolDeclaration for DocumentLookupTool

const NAME: &'static str = "document_lookup"

const CATEGORY: ToolCategory = ToolCategory::CourseMaterial

impl ChatbotToolDeclaration for FindCourseTool

const NAME: &'static str = "find_course"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportCourses

impl ChatbotToolDeclaration for FindUserTool

const NAME: &'static str = "find_user"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportAccounts

impl ChatbotToolDeclaration for UserCourseStateTool

const NAME: &'static str = "user_course_state"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportLearningProgress

impl ChatbotToolDeclaration for UserOverviewTool

const NAME: &'static str = "user_overview"

const CATEGORY: ToolCategory = ToolCategory::AdminSupportAccounts