|
<< Click to Display Table of Contents >> Navigation: 3. Script Language > AI - Artificial Intelligence Commands > AIU. - OpenAI API > !Tool and Function Management > AIU. - Artificial Intelligence Utility |
MiniRobotLanguage (MRL)
AIU.SetToolChoice
Set the Preferred Tool Choice for the AI
Intention
SetToolChoice Command: Specify Tool Preference
The SetToolChoice Command configures the AI�s preference for using tools (e.g., functions like calculators or search) during response generation.
This allows tailored responses for tasks requiring specific tools.
It�s part of the AIU - OpenAI API suite.
The SetToolChoice Command sets the AI�s tool usage preference for operations like AIU.Chat.
Options include "auto" (AI chooses), "none" (no tools), or a specific tool name (e.g., "calculator"). Tools process tasks via tokens (words or symbols), potentially increasing token usage and cost depending on the tool�s complexity.
Setting tool choice is essential for:
�Precision: Force specific tools for tasks like calculations or data retrieval.
�Simplicity: Disable tools for text-only responses to reduce complexity.
�Cost Control: Manage token usage by limiting tool calls.
Provide a string parameter: "auto", "none", or a specific tool name.
Tool usage impacts token costs. Pricing (as of March 18, 2025, from OpenAI�s pricing page) includes:
�gpt-4o: $5.00/1M input tokens, $15.00/1M output tokens (128K context).
�gpt-4o-mini: $0.15/1M input tokens, $0.60/1M output tokens (128K context).
�gpt-3.5-turbo: $0.50/1M input tokens, $1.50/1M output tokens (16K context).
A tool call might add ~50-100 tokens, increasing costs slightly (e.g., $0.00003-$0.00006 for gpt-4o-mini).
Example Usage
AIU.SetToolChoice|calculator
AIU.Chat|What is 42 * 17?|$$RES
DBP.Calculation Result: $$RES
Sets the tool choice to "calculator" for precise math responses.
Illustration
+-----------------------------------+
� Tool Choice �� Response Example � �
+--------------+--------------------�
� none � � � � � "Estimate: ~700" � �
+--------------+--------------------�
� calculator � � "Exact: 714" � � � �
+-----------------------------------+
Illustration of how tool choice affects response precision.
Syntax
AIU.SetToolChoice|P1
AIU.Set_ToolChoice|P1
Parameter Explanation
P1 - A string specifying the tool choice: "auto", "none", or a tool name (e.g., "calculator"). Required.
Example
AIU.SetToolChoice|auto
AIU.Chat|What�s the weather?|$$WEA
DBP.Weather Info: $$WEA
ENR.
Remarks
- Default is typically "auto"; specific tools depend on model capabilities.
- Tool calls may increase token usage and API costs.
Limitations
- Requires exactly one parameter; omitting or adding extra parameters causes an error.
- Invalid tool names may result in errors or default behavior.
See also:
? AIU.Chat