Constant Field Values

Contents

com.alibaba.*

  • com.alibaba.cloud.ai.graph.agent.DefaultBuilder
    Modifier and Type
    Constant Field
    Value
    public static final String
    POSSIBLE_LLM_TOOL_NAME_CHANGE_WARNING
    "LLM may have adapted the tool name \'{}\', especially if the name was truncated due to length limits. If this is the case, you can customize the prefixing and processing logic using McpToolNamePrefixGenerator"
  • com.alibaba.cloud.ai.graph.agent.extension.tools.filesystem.EditFileTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DESCRIPTION
    "Performs exact string replacements in files.\n\nUsage:\n- You must use your `read_file` tool at least once before editing.\n- When editing text from read_file output, preserve exact indentation\n- ALWAYS prefer editing existing files. NEVER write new files unless explicitly required.\n- The edit will FAIL if `old_string` is not unique in the file.\n- After editing, verify the changes by using the read_file tool.\n"
  • com.alibaba.cloud.ai.graph.agent.extension.tools.filesystem.GlobTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DESCRIPTION
    "Find files matching a glob pattern.\n\nUsage:\n- Supports standard glob patterns: `*` (any characters), `**` (any directories), `?` (single character)\n- Returns a list of absolute file paths that match the pattern\n\nExamples:\n- `**/*.java` - Find all Java files\n- `*.txt` - Find all text files in root\n- `/src/**/*.xml` - Find all XML files under /src\n"
  • com.alibaba.cloud.ai.graph.agent.extension.tools.filesystem.GrepTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DESCRIPTION
    "Search for a pattern in files.\n\nUsage:\n- The pattern parameter is the text to search for (literal string, not regex)\n- The path parameter filters which directory to search in\n- The glob parameter accepts a glob pattern to filter which files to search\n\nExamples:\n- Search all files: `grep(pattern=\"TODO\")`\n- The search is case-sensitive by default.\n"
  • com.alibaba.cloud.ai.graph.agent.extension.tools.filesystem.ListFilesTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DESCRIPTION
    "Lists all files in the filesystem, filtering by directory.\n\nUsage:\n- The path parameter must be an absolute path, not a relative path\n- The list_files tool will return a list of all files in the specified directory.\n- This is very useful for exploring the file system and finding the right file to read or edit.\n- You should almost ALWAYS use this tool before using the Read or Edit tools.\n"
  • com.alibaba.cloud.ai.graph.agent.extension.tools.filesystem.ReadFileTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DESCRIPTION
    "Reads a file from the filesystem. You can access any file directly by using this tool.\nAssume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- By default, it reads up to 500 lines starting from the beginning of the file\n- **IMPORTANT for large files and codebase exploration**: Use pagination with offset and limit parameters to avoid context overflow\n - First scan: read_file(path, limit=100) to see file structure\n - Read more sections: read_file(path, offset=100, limit=200) for next 200 lines\n - Only omit limit (read full file) when necessary for editing\n- Specify offset and limit: read_file(path, offset=0, limit=100) reads first 100 lines\n- Any lines longer than 2000 characters will be truncated\n- Results are returned using cat -n format, with line numbers starting at 1\n- You have the capability to call multiple tools in a single response. It is always better to speculatively read multiple files as a batch that are potentially useful.\n- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.\n\t\t\t- You should almost ALWAYS use the list_files tool before using this tool to verify the file path.\n"
  • com.alibaba.cloud.ai.graph.agent.extension.tools.filesystem.WriteFileTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DESCRIPTION
    "Writes to a new file in the filesystem.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- The content parameter must be a string\n- The write_file tool will create a new file.\n- When writing to a file, the content will completely replace the existing content.\n"
  • com.alibaba.cloud.ai.graph.agent.flow.agent.LoopAgent
    Modifier and Type
    Constant Field
    Value
    public static final String
    LOOP_STRATEGY
    "loopStrategy"
  • com.alibaba.cloud.ai.graph.agent.tools.ShellTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DEFAULT_TOOL_DESCRIPTION
    "Execute a shell command inside a persistent session. Before running a command, confirm the working directory is correct (e.g., inspect with `ls` or `pwd`) and ensure any parent directories exist. Prefer absolute paths and quote paths containing spaces, such as `cd \"/path/with spaces\"`. Chain multiple commands with `&&` or `;` instead of embedding newlines. Avoid unnecessary `cd` usage unless explicitly required so the session remains stable. Outputs may be truncated when they become very large, and long running commands will be terminated once their configured timeout elapses."
  • com.alibaba.cloud.ai.graph.agent.tools.ToolContextConstants
    Modifier and Type
    Constant Field
    Value
    public static final String
    AGENT_CONFIG_CONTEXT_KEY
    "_AGENT_CONFIG_"
    public static final String
    AGENT_STATE_CONTEXT_KEY
    "_AGENT_STATE_"
    public static final String
    AGENT_STATE_FOR_UPDATE_CONTEXT_KEY
    "_AGENT_STATE_FOR_UPDATE_"
  • com.alibaba.cloud.ai.graph.agent.tools.WriteTodosTool
    Modifier and Type
    Constant Field
    Value
    public static final String
    DEFAULT_TOOL_DESCRIPTION
    "Use this tool to create and manage a structured task list for your current work session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.\n\nOnly use this tool if you think it will be helpful in staying organized. If the user\'s request is trivial and takes less than 3 steps, it is better to NOT use this tool and just do the task directly.\n\n## When to Use This Tool\nUse this tool in these scenarios:\n\n1. Complex multi-step tasks - When a task requires 3 or more distinct steps or actions\n2. Non-trivial and complex tasks - Tasks that require careful planning or multiple operations\n3. User explicitly requests todo list - When the user directly asks you to use the todo list\n4. User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)\n5. The plan may need future revisions or updates based on results from the first few steps\n\n## How to Use This Tool\n1. When you start working on a task - Mark it as in_progress BEFORE beginning work.\n2. After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation.\n3. You can also update future tasks, such as deleting them if they are no longer necessary, or adding new tasks that are necessary. Don\'t change previously completed tasks.\n4. You can make several updates to the todo list at once. For example, when you complete a task, you can mark the next task you need to start as in_progress.\n\n## When NOT to Use This Tool\nIt is important to skip using this tool when:\n1. There is only a single, straightforward task\n2. The task is trivial and tracking it provides no benefit\n3. The task can be completed in less than 3 trivial steps\n4. The task is purely conversational or informational\n\n## Task States and Management\n\n1. **Task States**: Use these states to track progress:\n - pending: Task not yet started\n - in_progress: Currently working on (you can have multiple tasks in_progress at a time if they are not related to each other and can be run in parallel)\n - completed: Task finished successfully\n\n2. **Task Management**:\n - Update task status in real-time as you work\n - Mark tasks complete IMMEDIATELY after finishing (don\'t batch completions)\n - Complete current tasks before starting new ones\n - Remove tasks that are no longer relevant from the list entirely\n - IMPORTANT: When you write this todo list, you should mark your first task (or tasks) as in_progress immediately!.\n - IMPORTANT: Unless all tasks are completed, you should always have at least one task in_progress to show the user that you are working on something.\n\n3. **Task Completion Requirements**:\n - ONLY mark a task as completed when you have FULLY accomplished it\n - If you encounter errors, blockers, or cannot finish, keep the task as in_progress\n - When blocked, create a new task describing what needs to be resolved\n - Never mark a task as completed if:\n - There are unresolved issues or errors\n - Work is partial or incomplete\n - You encountered blockers that prevent completion\n - You couldn\'t find necessary resources or dependencies\n - Quality standards haven\'t been met\n\n4. **Task Breakdown**:\n - Create specific, actionable items\n - Break complex tasks into smaller, manageable steps\n - Use clear, descriptive task names\n\nBeing proactive with task management demonstrates attentiveness and ensures you complete all requirements successfully\nRemember: If you only need to make a few tool calls to complete a task, and it is clear what you need to do, it is better to just do the task directly and NOT call this tool at all.\n"