The following step-by-step guides you to create Healthcare provider agent on IBM watsonx Orchestrate Agent builder.

​
Before you begin

Before you start following this tutorial, you must set up your IBM watsonx Orchestrate ADK environment, where you build agents and tools. It also provides a convenient interface for managing credentials, sending requests, and handling responses from the service’s APIs. See the Installing the watsonx Orchestrate ADK and Installing the watsonx Orchestrate Developer Edition.

​
Creating the agent and tool files

The following steps guide you to create the agent and tool files in YAML.
  1. In your directory, create a folder with the name healthcare_provider.
  2. Open a text editor, such as Visual Studio Code.
  3. To create the agent, copy the following code:
    [YAML]
    spec_version: v1
kind: native
name: healthcare_agent
description: >
    You are a specialist in healthcare providers. When prompted use the getHealthCareProviders tool to get a list of all healthcare providers matching the users qquery. Display the results are a table

llm: watsonx/meta-llama/llama-3-2-90b-vision-instruct
style: default
tools:
- getHealthCareProviders
  4. Paste the code in the text editor and save the file as healthcare_agent.yaml in the healthcare_provider folder.
  5. To create the tool, copy the following code:
    [YAML]
    servers:
- url: https://find-provider.1sqnxi8zv3dh.us-east.codeengine.appdomain.cloud
paths:
  /:
    get:
      operationId: getHealthCareProviders
      summary: Gets a list of healthcare providers
      description: Gets a list of healthcare providers
      parameters:
        - in: path
          name: location
          schema:
            type: string
          required: false
          description: The city, state or zipcode you want to get healthcare providers
        - in: path
          name: speciality
          schema:
            type: string
            enum: ["General Medicine", "Cardiology", "Pediatrics", "Orthopedics", "ENT", "Multi-specialty"]
          required: false
          description: The speciality of the healthcare provider
      responses:
        '200':
          description: Successfully retrieved list of healthcare providers
          content:
            application/json:
              schema:
                type: object
                properties:
                  providers:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                            type: string
                        contact:
                            type: object
                            properties:
                                email:
                                    type: string
                                phone:
                                    type: string
                        name:
                            type: string
                        provider_id:
                            type: string
                        provider_type:
                            type: string
                        specialty:
                            type: string
                required:
                  - data
  6. Paste the code in the text editor and save the file as get_healthcare_providers.yaml in the healthcare_provider folder.

​
Importing the agent and tool files

The following steps guide you to import the agent and tool files to IBM watsonx Orchestrate Agent builder.
  1. Open the terminal that you commonly use.
  2. Navigate to the folder. For instance, cd ~/Desktop/healthcare_provider.
  3. Run the following commands:
    [BASH]
    orchestrate tools import -k openapi -f ./get_healthcare_providers.yaml
    [BASH]
    orchestrate agents import -f healthcare_agent.yaml

​
Testing the agent

Test the agent in the IBM watsonx Orchestrate chat by following the steps:
  1. Run the command orchestrate chat start.
  2. In the chat, enter the question “What are my healthcare providers?”.
You can continue interacting with your agent.