15 Getting Started with Select AI Agent Framework

To use Select AI Agent Framework, complete the prerequisites and create the agent objects that the framework uses at run time. Select AI Agent Framework provides procedures to create agents, tools, tasks, and teams, and you can run a team either with the Select AI agent framework action or with DBMS_CLOUD_AI_AGENT.RUN_TEAM.

Use the following order to create and run a Select AI agent team.

1. Complete prerequisites

   Review the Select AI prerequisites and the Select AI Agent Framework prerequisites before you configure agent objects. See Prerequisites for Using Select AI Agent Framework for more information.

2. Create PL/SQL functions

   Create any PL/SQL functions that your custom tools can call. Select AI Agent Framework tools can use custom PL/SQL functions or built-in tool types such as SQL, RAG, WEBSEARCH, or NOTIFICATION. See Example: Create a Product Return Agent for more information.

3. Create an agent

   Use DBMS_CLOUD_AI_AGENT.CREATE_AGENT to create the agent that performs the work. Define the agent name, specify the AI profile that the agent uses, and provide the role instructions that guide the agent's behavior. See Example: Create an Agent for more information.

4. Create tools

   Use DBMS_CLOUD_AI_AGENT.CREATE_TOOL to register the tools that the agent can call. A tool defines what the agent can do during task processing, such as calling a PL/SQL function or using a built-in capability. See Example: Create Built-In Tools for more information.

5. Create tasks

   Use DBMS_CLOUD_AI_AGENT.CREATE_TASK to define the task instructions for the agent. A task specifies the instructions the agent follows and the tools available for that task. See Example: Create a Task for more information.

6. Create a team

   Use DBMS_CLOUD_AI_AGENT.CREATE_TEAM to associate one or more agents with their tasks and set the process type for the workflow. A team defines how the agent-task pairs work together to accomplish the request. See Example: Create an Agent Team for more information.

7. Run the team

   Run the Select AI agent framework team by using either of the following methods:

   • Use the Select AI action: SELECT AI agent framework prompt.

   • Call DBMS_CLOUD_AI_AGENT.RUN_TEAM and provide the prompt and other parameters in the function call.

   Both methods route the prompt to the selected agent team and return the team's reply. See How Do I Use Select AI Agent Framework and Example: Create a Movie Analysis Agent with Built-In Tools for more information.

8. Review agent history and logs for troubleshooting

   After you run the team, review the Select AI Agent Framework views and history views for troubleshooting and diagnostics. Use the DBMS_CLOUD_AI_AGENT views to inspect agents, tools, tasks, teams, and execution history. See DBMS_CLOUD_AI_AGENT Views for more information. To investigate a recent run, query history and conversation views such as USER_AI_AGENT_TEAM_HISTORY, USER_AI_AGENT_TASK_HISTORY, and USER_CLOUD_AI_CONVERSATION_PROMPTS to review team runs, task runs, prompts, responses, and agent thoughts. See Example: View Agent Prompts and Responses from the Latest Team Run for more information.

Topics:

• Prerequisites for Using Select AI Agent Framework
  Before you use Select AI Agent Framework, you must have privileges to use the DBMS_CLOUD_AI_AGENT package and all other privileges that are required for Select AI.
• Create an Agent Team and Supporting Objects
  Before you create an agent team, create the agent objects that define the team's behavior and workflow. These objects include agents, tools, and tasks. An agent defines the role and AI profile used to process requests. Tools provide capabilities that an agent can use during task processing, and tasks define the instructions and tools required to complete work.
• How Do I Use Select AI Agent Framework
  You can use Select AI Agent Framework by using the agent action or the DBMS_CLOUD_AI_AGENT.RUN_TEAM function.