Creating an Agent Tool (Agent as a Tool) in Generative AI Agents
In Generative AI Agents, an agent must have one or more tools. Similar to other tool types, you can configure an Agent tool during or after creating the agent. For both options, creating a tool has the same steps. This section shows you the steps to create an Agent tool in an existing agent.
Before you create an Agent tool, review the Agent Tool Guidelines in Generative AI Agents and complete any tasks that are required.
Navigating to Tools
Creating an Agent Tool
- Select Create tool and then select Agent tool.
-
Enter the following information:
- Name: A name for the tool that starts with a letter or underscore, followed by letters, numbers, hyphens, or underscores. The length can be from 1 to 255 characters.
- Description: A description can help an agent better answer prompts.
-
Select one of the options:
-
Select agent endpoint: Use the menus to perform the following actions:
- Select the agent that this Agent tool can query.
- Select the agent endpoint that's associated with the selected agent. Only a session-based active endpoint can be selected.
If necessary, select Change compartment to find the agent and agent endpoint in another compartment.
- Manually enter endpoint OCID: Manually enter the OCID of an agent endpoint that can be queried by this Agent tool.
In the Agent endpoint ID field, paste the OCID.
If you need help finding the OCID of an agent endpoint, see Getting an Endpoint's Details.
-
- Select Create tool.
Perform one of the following actions:
- If you're creating an agent, go back to Creating an Agent in Generative AI Agents to configure another tool or set up an endpoint.
- If you added the tool to an existing agent, after the tool is active, from the agent's detail page, select Launch chat to chat with the agent using this tool.
- If you created the agent without an endpoint, when you're ready to use the agent, create an endpoint for this agent.