Package com.composum.ai.backend.slingbase.experimential.impl

Class ModifyPageWriteTool

java.lang.Object

com.composum.ai.backend.slingbase.experimential.impl.ModifyPageWriteTool

All Implemented Interfaces:

AITool

public class ModifyPageWriteTool
extends Object
implements AITool

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ModifyPageWriteTool.Config

Constructor Summary

Constructors

Constructor	Description
ModifyPageWriteTool()

Method Summary

Modifier and Type	Method	Description
protected void	activate(ModifyPageWriteTool.Config config)
protected void	deactivate()
String	execute(String arguments, org.apache.sling.api.resource.Resource resource, com.composum.ai.backend.base.service.chat.GPTCompletionCallback.GPTToolExecutionContext context)	Executes the tool call and returns the result to present to the AI.
String	getDescription(Locale locale)	Human readable description.
String	getName(Locale locale)	Human readable name.
String	getToolDeclaration()	The description to use for the OpenAI tool call.
String	getToolName()	Name for the purpose of calling - must match AITool.getToolDeclaration().
boolean	isAllowedFor(org.apache.sling.api.resource.Resource resource)	Whether the tool is enabled for the given resource.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.composum.ai.backend.slingbase.experimential.AITool

makeGPTTool

Constructor Detail

ModifyPageWriteTool

public ModifyPageWriteTool()

Method Detail

getName

@Nonnull
public String getName(@Nullable
                      Locale locale)

Description copied from interface: AITool

Human readable name.

Specified by:

getName in interface AITool

getDescription

@Nonnull
public String getDescription(@Nullable
                             Locale locale)

Description copied from interface: AITool

Human readable description.

Specified by:

getDescription in interface AITool

getToolName

@Nonnull
public String getToolName()

Description copied from interface: AITool

Name for the purpose of calling - must match AITool.getToolDeclaration().

Specified by:

getToolName in interface AITool

getToolDeclaration

@Nonnull
public String getToolDeclaration()

Description copied from interface: AITool

The description to use for the OpenAI tool call. Will be inserted into the OpenAI tools array. E.g.:

       {
         "type": "function",
         "function": {
           "name": "get_delivery_date",
           "description": "Get the delivery date for a customer's order. Call this whenever you need to know the delivery date, for example when a customer asks 'Where is my package'",
           "parameters": {
             "type": "object",
             "properties": {
               "order_id": {
                 "type": "string",
                 "description": "The customer's order ID."
               }
             },
             "required": ["order_id"],
             "additionalProperties": false
           }
         },
         "strict": true
       }
 

Specified by:

getToolDeclaration in interface AITool

See Also:

"https://platform.openai.com/docs/api-reference/chat/create"

isAllowedFor

public boolean isAllowedFor(@Nullable
                            org.apache.sling.api.resource.Resource resource)

Description copied from interface: AITool

Whether the tool is enabled for the given resource.

Specified by:

isAllowedFor in interface AITool

execute

@Nonnull
public String execute(@Nullable
                      String arguments,
                      @Nonnull
                      org.apache.sling.api.resource.Resource resource,
                      @Nullable
                      com.composum.ai.backend.base.service.chat.GPTCompletionCallback.GPTToolExecutionContext context)

Description copied from interface: AITool

Executes the tool call and returns the result to present to the AI. Must only be called if AITool.isAllowedFor(Resource) returned true.

Specified by:

execute in interface AITool

activate

protected void activate(ModifyPageWriteTool.Config config)

deactivate

protected void deactivate()