Development guidelines
This document provides guidelines for naming, describing, and instructing agents and tools within the ADK (Agent Development Kit). Following these guidelines ensures that your agents and tools are easily identifiable, understandable, and effective in their roles.
Naming agents and tools
Assign clear and unique names to each agent and tool you create. These names should reflect their capabilities and functions, making it easier for users to identify them within watsonx Orchestrate. These names are also used as unique identifiers for the agents and tools inside watsonx Orchestrate and do not accept special characters like spaces.
Good example:
Bad example:
Writing descriptions for agents
Agent descriptions complement the agent names by providing detailed information about their purpose, capabilities, and usage. A well-written description helps users understand the agent’s role and potential applications.
The Agent description has another important use. Supervisor agents use the description of collaborator agents when determining where to route a users request. Therefore the description should also describe the tools and knowledge available to a given agent.
Writing descriptions for tools
A good tool description helps agents identify and use the tool effectively. It should include a general overview of the tool’s purpose, as well as details about its inputs and outputs.
Example:
Writing instructions for agents
Instructions are crucial for training agents to perform their tasks effectively. When setting instructions, consider configuring the agent’s persona, context, and reasoning for using tools and collaborating with other agents.
Instructions for agent persona
Define the agent’s role and how it should interact with users. This helps ensure consistent and effective communication.
Instructions for agent context
Provide background information relevant to the agent’s usage. This helps the agent understand the environment in which it operates.
Instructions for agent reasoning
Guide the agent’s decision-making process by providing detailed instructions on how to act in specific scenarios. The more descriptive the instructions, the better the agent’s performance.
Depending on your case, you can give direct instructions to your agent to help their reasoning by using the following structure:
-
For tools
[TEXT] -
For agents collaborators
[TEXT]