Initial commit
This commit is contained in:
277
templates/tool-definition.json
Normal file
277
templates/tool-definition.json
Normal file
@@ -0,0 +1,277 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$comment": "SAP AI Core Tool Calling Definition Template",
|
||||
|
||||
"single_tool_definition": {
|
||||
"tools": [
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "get_product_info",
|
||||
"description": "Get information about a product including price, availability, and description",
|
||||
"strict": true,
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"product_id": {
|
||||
"type": "string",
|
||||
"description": "The unique product identifier (e.g., 'PROD-12345')"
|
||||
}
|
||||
},
|
||||
"required": ["product_id"],
|
||||
"additionalProperties": false
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"multiple_tools_definition": {
|
||||
"tools": [
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "get_inventory",
|
||||
"description": "Get current inventory quantity for a product",
|
||||
"strict": true,
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"product_id": {
|
||||
"type": "string",
|
||||
"description": "The product identifier"
|
||||
},
|
||||
"warehouse": {
|
||||
"type": "string",
|
||||
"enum": ["US-EAST", "US-WEST", "EU-CENTRAL", "APAC"],
|
||||
"description": "The warehouse location"
|
||||
}
|
||||
},
|
||||
"required": ["product_id"],
|
||||
"additionalProperties": false
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "create_order",
|
||||
"description": "Create a new order for a customer",
|
||||
"strict": true,
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"customer_id": {
|
||||
"type": "string",
|
||||
"description": "The customer identifier"
|
||||
},
|
||||
"product_id": {
|
||||
"type": "string",
|
||||
"description": "The product to order"
|
||||
},
|
||||
"quantity": {
|
||||
"type": "integer",
|
||||
"minimum": 1,
|
||||
"description": "Number of items to order"
|
||||
},
|
||||
"shipping_address": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"street": {"type": "string"},
|
||||
"city": {"type": "string"},
|
||||
"country": {"type": "string"},
|
||||
"postal_code": {"type": "string"}
|
||||
},
|
||||
"required": ["street", "city", "country"]
|
||||
}
|
||||
},
|
||||
"required": ["customer_id", "product_id", "quantity"],
|
||||
"additionalProperties": false
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "get_customer_history",
|
||||
"description": "Get order history for a customer",
|
||||
"strict": true,
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"customer_id": {
|
||||
"type": "string",
|
||||
"description": "The customer identifier"
|
||||
},
|
||||
"limit": {
|
||||
"type": "integer",
|
||||
"minimum": 1,
|
||||
"maximum": 100,
|
||||
"default": 10,
|
||||
"description": "Maximum number of orders to return"
|
||||
}
|
||||
},
|
||||
"required": ["customer_id"],
|
||||
"additionalProperties": false
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"orchestration_request_with_tools": {
|
||||
"config": {
|
||||
"module_configurations": {
|
||||
"llm_module_config": {
|
||||
"model_name": "gpt-4o",
|
||||
"model_version": "latest",
|
||||
"model_params": {
|
||||
"max_tokens": 1000
|
||||
}
|
||||
},
|
||||
"templating_module_config": {
|
||||
"template": [
|
||||
{
|
||||
"role": "system",
|
||||
"content": "You are a helpful sales assistant. Use the available tools to help customers with their orders and product inquiries."
|
||||
},
|
||||
{
|
||||
"role": "user",
|
||||
"content": "{{?user_message}}"
|
||||
}
|
||||
],
|
||||
"tools": [
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "get_product_info",
|
||||
"description": "Get product information",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"product_id": {"type": "string"}
|
||||
},
|
||||
"required": ["product_id"]
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"input_params": {
|
||||
"user_message": "What is the price of product PROD-12345?"
|
||||
}
|
||||
},
|
||||
|
||||
"tool_response_continuation": {
|
||||
"config": {
|
||||
"module_configurations": {
|
||||
"llm_module_config": {
|
||||
"model_name": "gpt-4o",
|
||||
"model_version": "latest"
|
||||
},
|
||||
"templating_module_config": {
|
||||
"template": [
|
||||
{"role": "system", "content": "You are a helpful assistant."},
|
||||
{"role": "user", "content": "What is the inventory for product ABC123?"},
|
||||
{
|
||||
"role": "assistant",
|
||||
"tool_calls": [
|
||||
{
|
||||
"id": "call_abc123",
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "get_inventory",
|
||||
"arguments": "{\"product_id\": \"ABC123\"}"
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"role": "tool",
|
||||
"tool_call_id": "call_abc123",
|
||||
"content": "{\"product_id\": \"ABC123\", \"quantity\": 150, \"warehouse\": \"US-EAST\"}"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"structured_output_json_schema": {
|
||||
"config": {
|
||||
"module_configurations": {
|
||||
"llm_module_config": {
|
||||
"model_name": "gpt-4o",
|
||||
"model_version": "latest",
|
||||
"model_params": {
|
||||
"response_format": {
|
||||
"type": "json_schema",
|
||||
"json_schema": {
|
||||
"name": "product_analysis",
|
||||
"strict": true,
|
||||
"schema": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"product_name": {"type": "string"},
|
||||
"category": {
|
||||
"type": "string",
|
||||
"enum": ["electronics", "clothing", "food", "other"]
|
||||
},
|
||||
"price_range": {
|
||||
"type": "string",
|
||||
"enum": ["budget", "mid-range", "premium"]
|
||||
},
|
||||
"key_features": {
|
||||
"type": "array",
|
||||
"items": {"type": "string"}
|
||||
},
|
||||
"recommendation_score": {
|
||||
"type": "number",
|
||||
"minimum": 0,
|
||||
"maximum": 10
|
||||
}
|
||||
},
|
||||
"required": ["product_name", "category", "recommendation_score"],
|
||||
"additionalProperties": false
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"templating_module_config": {
|
||||
"template": [
|
||||
{"role": "user", "content": "Analyze this product: {{?product_description}}"}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"_documentation": {
|
||||
"tool_calling_workflow": [
|
||||
"1. Send request with tool definitions",
|
||||
"2. Model returns tool_calls with function name and arguments",
|
||||
"3. Execute function externally with provided arguments",
|
||||
"4. Return result in 'tool' role message with matching tool_call_id",
|
||||
"5. Model incorporates result in final response"
|
||||
],
|
||||
"best_practices": [
|
||||
"Use descriptive function names and descriptions",
|
||||
"Enable strict mode for parameter validation",
|
||||
"Define clear parameter types and constraints",
|
||||
"Include examples in descriptions when helpful",
|
||||
"Handle tool call errors gracefully"
|
||||
],
|
||||
"supported_parameter_types": [
|
||||
"string",
|
||||
"integer",
|
||||
"number",
|
||||
"boolean",
|
||||
"array",
|
||||
"object",
|
||||
"enum (via type + enum array)"
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user