🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org
HumanToolkit
class HumanToolkit(BaseToolkit):
A class representing a toolkit for human interaction.
Note:
This toolkit should be called to send a tidy message to the user to keep them informed.
ask_human_via_console
def ask_human_via_console(self, question: str):
Use this tool to ask a question to the user when you are stuck, need clarification, or require a decision to be made. This is a two-way communication channel that will wait for the user's response. You should use it to:
- Clarify ambiguous instructions or requirements.
- Request missing information that you cannot find (e.g., login credentials, file paths).
- Ask for a decision when there are multiple viable options.
- Seek help when you encounter an error you cannot resolve on your own.
Parameters:
- question (str): The question to ask the user.
Returns:
str: The user's response to the question.
send_message_to_user
def send_message_to_user(self, message: str) -> str:
Use this tool to send a tidy message to the user in one short sentence.
This one-way tool keeps the user informed about your progress, decisions, or actions. It does not require a response from user. You should use it to:
- Announce what you are about to do (e.g., "I will now search for papers on GUI Agents.").
- Report the result of an action (e.g., "I have found 15 relevant papers.").
- State a decision (e.g., "I will now analyze the top 10 papers.").
- Give a status update during a long-running task.
Parameters:
- message (str): The tidy and informative message for the user.
get_tools
def get_tools(self):
Returns:
List[FunctionTool]: A list of FunctionTool objects representing the functions in the toolkit.