AI Agent¶

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentCodePayload¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentCodePayload",
   "type": "object",
   "properties": {
      "source": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Source location of the agent's code.",
         "title": "Source"
      },
      "commit": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Commit"
      },
      "language": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": "python",
         "description": "Language used in the code",
         "title": "Language"
      },
      "source_code_base64": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "description": "Source code encoded in Base64 format.",
         "title": "Source Code Base64"
      },
      "run_time_details": {
         "$ref": "#/$defs/AIAgentRuntimeDetails",
         "description": "Runtime details required for executing the source code."
      }
   },
   "$defs": {
      "AIAgentRuntimeDetails": {
         "properties": {
            "engine": {
               "description": "Python version required by the agent.",
               "title": "Engine",
               "type": "string"
            },
            "cpu_capacity": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "CPU capacity required by the agent.",
               "title": "Cpu Capacity"
            },
            "memory": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Memory required by the agent.",
               "title": "Memory"
            }
         },
         "required": [
            "engine"
         ],
         "title": "AIAgentRuntimeDetails",
         "type": "object"
      }
   },
   "required": [
      "source_code_base64",
      "run_time_details"
   ]
}

Fields:

commit (str | None)
language (str | None)
run_time_details (ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentRuntimeDetails)
source (str | None)
source_code (str | None)

Validators:

accept_multiple_field_names » all fields

field commit: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None)] = None¶

Validated by:

accept_multiple_field_names

field language: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default='python', description='Language used in the code')] = 'python'¶

Language used in the code

Validated by:

accept_multiple_field_names

field run_time_details: Annotated[AIAgentRuntimeDetails, FieldInfo(annotation=NoneType, required=True, description='Runtime details required for executing the source code.')] [Required]¶

Runtime details required for executing the source code.

Validated by:

accept_multiple_field_names

field source: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description="Source location of the agent's code.")] = None¶

Source location of the agent’s code.

Validated by:

accept_multiple_field_names

field source_code: Annotated[str | None, FieldInfo(annotation=NoneType, required=True, alias='source_code_base64', alias_priority=2, description='Source code encoded in Base64 format.')] [Required] (alias 'source_code_base64')¶

Source code encoded in Base64 format.

Validated by:

accept_multiple_field_names

validator accept_multiple_field_names » all fields¶

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentDependencies¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentDependencies",
   "type": "object",
   "properties": {
      "remote_services": {
         "items": {
            "type": "string"
         },
         "title": "Remote Services",
         "type": "array"
      },
      "run_time_packages": {
         "items": {
            "type": "string"
         },
         "title": "Run Time Packages",
         "type": "array"
      }
   },
   "required": [
      "remote_services",
      "run_time_packages"
   ]
}

Fields:

remote_services (list[str])
run_time_packages (list[str])

field remote_services: Annotated[list[str], FieldInfo(annotation=NoneType, required=True)] [Required]¶

field run_time_packages: Annotated[list[str], FieldInfo(annotation=NoneType, required=True)] [Required]¶

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentEndpointPayload¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentEndpointPayload",
   "type": "object",
   "properties": {
      "url": {
         "description": "URL to access the endpoint.",
         "title": "Url",
         "type": "string"
      },
      "headers": {
         "additionalProperties": {
            "type": "string"
         },
         "description": "Headers required to call the endpoint.",
         "title": "Headers",
         "type": "object"
      },
      "method": {
         "description": "Method to call the endpoint.",
         "title": "Method",
         "type": "string"
      }
   },
   "required": [
      "url",
      "headers",
      "method"
   ]
}

Fields:

headers (Dict[str, str])
method (str)
url (str)

field headers: Annotated[Dict[str, str], FieldInfo(annotation=NoneType, required=True, description='Headers required to call the endpoint.')] [Required]¶: Headers required to call the endpoint.

field method: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Method to call the endpoint.')] [Required]¶: Method to call the endpoint.

field url: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='URL to access the endpoint.')] [Required]¶: URL to access the endpoint.

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentParentApplication¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentParentApplication",
   "type": "object",
   "properties": {
      "inventory_id": {
         "description": "Inventory ID of the parent application.",
         "title": "Inventory Id",
         "type": "string"
      },
      "agent_id": {
         "description": "Agent ID of the parent application",
         "title": "Agent Id",
         "type": "string"
      }
   },
   "required": [
      "inventory_id",
      "agent_id"
   ]
}

Fields:

agent_id (str)
inventory_id (str)

field agent_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Agent ID of the parent application')] [Required]¶: Agent ID of the parent application

field inventory_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Inventory ID of the parent application.')] [Required]¶: Inventory ID of the parent application.

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentRuntimeDetails¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentRuntimeDetails",
   "type": "object",
   "properties": {
      "engine": {
         "description": "Python version required by the agent.",
         "title": "Engine",
         "type": "string"
      },
      "cpu_capacity": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "CPU capacity required by the agent.",
         "title": "Cpu Capacity"
      },
      "memory": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Memory required by the agent.",
         "title": "Memory"
      }
   },
   "required": [
      "engine"
   ]
}

Fields:

cpu_capacity (str | None)
engine (str)
memory (str | None)

field cpu_capacity: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='CPU capacity required by the agent.')] = None¶: CPU capacity required by the agent.

field engine: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Python version required by the agent.')] [Required]¶: Python version required by the agent.

field memory: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Memory required by the agent.')] = None¶: Memory required by the agent.

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentSchema¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentSchema",
   "type": "object",
   "properties": {
      "title": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Title for schema.",
         "title": "Title"
      },
      "type": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Type of schema.",
         "title": "Type"
      },
      "properties": {
         "type": "object",
         "description": "Properties for schema.",
         "title": "Properties"
      },
      "required": {
         "anyOf": [
            {
               "items": {},
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Required for schema.",
         "title": "Required"
      }
   },
   "required": [
      "properties"
   ]
}

Fields:

properties (dict)
required (list | None)
title (str | None)
type (str | None)

field properties: Annotated[dict, FieldInfo(annotation=NoneType, required=True, description='Properties for schema.')] [Required]¶: Properties for schema.

field required: Annotated[list | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Required for schema.')] = None¶: Required for schema.

field title: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Title for schema.')] = None¶: Title for schema.

field type: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Type of schema.')] = None¶: Type of schema.

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentTool¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentTool",
   "type": "object",
   "properties": {
      "inventory_id": {
         "description": "Inventory ID of the tool where the application is used.",
         "title": "Inventory Id",
         "type": "string"
      },
      "tool_id": {
         "description": "Tool ID of the tool where the application is used.",
         "title": "Tool Id",
         "type": "string"
      }
   },
   "required": [
      "inventory_id",
      "tool_id"
   ]
}

Fields:

inventory_id (str)
tool_id (str)

field inventory_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Inventory ID of the tool where the application is used.')] [Required]¶: Inventory ID of the tool where the application is used.

field tool_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Tool ID of the tool where the application is used.')] [Required]¶: Tool ID of the tool where the application is used.

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentUsedInApplication¶

Bases: BaseModel

Show JSON schema

{
   "title": "AIAgentUsedInApplication",
   "type": "object",
   "properties": {
      "inventory_id": {
         "description": "Inventory ID of the application where the agent is used.",
         "title": "Inventory Id",
         "type": "string"
      },
      "agent_asset_id": {
         "description": "Agent ID of the application where the agent is used.",
         "title": "Agent Asset Id",
         "type": "string"
      }
   },
   "required": [
      "inventory_id",
      "agent_asset_id"
   ]
}

Fields:

agent_asset_id (str)
inventory_id (str)

field agent_asset_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Agent ID of the application where the agent is used.')] [Required]¶: Agent ID of the application where the agent is used.

field inventory_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Inventory ID of the application where the agent is used.')] [Required]¶: Inventory ID of the application where the agent is used.

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AgentRegistrationPayload¶

Bases: BaseModel

Show JSON schema

{
   "title": "AgentRegistrationPayload",
   "type": "object",
   "properties": {
      "display_name": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unique name for displaying the agent.",
         "title": "Display Name"
      },
      "agent_name": {
         "description": "Unique name for the agent",
         "title": "Agent Name",
         "type": "string"
      },
      "description": {
         "description": "Short description about the agent.",
         "title": "Description",
         "type": "string"
      },
      "inventory_id": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Inventory ID in which the asset needs to be created.",
         "title": "Inventory Id"
      },
      "summary": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Summary of the agent.",
         "title": "Summary"
      },
      "service_provider_type": {
         "anyOf": [
            {
               "$ref": "#/$defs/ServiceProviderType"
            },
            {
               "type": "null"
            }
         ],
         "default": "custom",
         "description": "Service provider type. Allowed values are: ['wml', 'custom']."
      },
      "framework": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/Framework"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "description": "Specify the framework used by the agent.",
         "title": "Framework"
      },
      "category": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/Categories"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "description": "Specify the category under which the agent will be classified. Allowed values are ['Search', 'Guardrails', 'Query', 'RAG', 'Evaluation', 'Other'].",
         "title": "Category"
      },
      "agent_type": {
         "anyOf": [
            {
               "$ref": "#/$defs/CustomToolType"
            },
            {
               "type": "null"
            }
         ],
         "default": "endpoint",
         "description": "Type of the agent. Allowed agent types are: ['code', 'endpoint']."
      },
      "development_implementation_url": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Development Implementation Url"
      },
      "validation_implementation_url": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Validation Implementation Url"
      },
      "implementation_url": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Implementation Url"
      },
      "reusable": {
         "default": false,
         "description": "Specify the agent will be reusable.",
         "title": "Reusable",
         "type": "boolean"
      },
      "version": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Version"
      },
      "parent_applications": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/AIAgentParentApplication"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of parent applications",
         "title": "Parent Applications"
      },
      "tools": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/AIAgentTool"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of tools used in this applications",
         "title": "Tools"
      },
      "used_in_applications": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/AIAgentUsedInApplication"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of applications where this application is used.",
         "title": "Used In Applications"
      },
      "code": {
         "anyOf": [
            {
               "$ref": "#/$defs/AIAgentCodePayload"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Code-related information for the agent."
      },
      "endpoint": {
         "anyOf": [
            {
               "$ref": "#/$defs/AIAgentEndpointPayload"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Endpoint-related information for the agent."
      },
      "dependencies": {
         "anyOf": [
            {
               "$ref": "#/$defs/AIAgentDependencies"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Dependencies required by this agent."
      },
      "metrics": {
         "anyOf": [
            {
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Metrics and their respective values.",
         "title": "Metrics"
      },
      "benchmark_test": {
         "anyOf": [
            {
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Benchmark test details.",
         "title": "Benchmark Test"
      },
      "pricing": {
         "anyOf": [
            {
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Type of currency and its corresponding price.",
         "title": "Pricing"
      },
      "schema": {
         "anyOf": [
            {
               "$ref": "#/$defs/AIAgentSchema"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Schema information for this agent."
      },
      "environment_variables": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Environment variables required by this agent.",
         "title": "Environment Variables"
      }
   },
   "$defs": {
      "AIAgentCodePayload": {
         "properties": {
            "source": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Source location of the agent's code.",
               "title": "Source"
            },
            "commit": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Commit"
            },
            "language": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": "python",
               "description": "Language used in the code",
               "title": "Language"
            },
            "source_code_base64": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "description": "Source code encoded in Base64 format.",
               "title": "Source Code Base64"
            },
            "run_time_details": {
               "$ref": "#/$defs/AIAgentRuntimeDetails",
               "description": "Runtime details required for executing the source code."
            }
         },
         "required": [
            "source_code_base64",
            "run_time_details"
         ],
         "title": "AIAgentCodePayload",
         "type": "object"
      },
      "AIAgentDependencies": {
         "properties": {
            "remote_services": {
               "items": {
                  "type": "string"
               },
               "title": "Remote Services",
               "type": "array"
            },
            "run_time_packages": {
               "items": {
                  "type": "string"
               },
               "title": "Run Time Packages",
               "type": "array"
            }
         },
         "required": [
            "remote_services",
            "run_time_packages"
         ],
         "title": "AIAgentDependencies",
         "type": "object"
      },
      "AIAgentEndpointPayload": {
         "properties": {
            "url": {
               "description": "URL to access the endpoint.",
               "title": "Url",
               "type": "string"
            },
            "headers": {
               "additionalProperties": {
                  "type": "string"
               },
               "description": "Headers required to call the endpoint.",
               "title": "Headers",
               "type": "object"
            },
            "method": {
               "description": "Method to call the endpoint.",
               "title": "Method",
               "type": "string"
            }
         },
         "required": [
            "url",
            "headers",
            "method"
         ],
         "title": "AIAgentEndpointPayload",
         "type": "object"
      },
      "AIAgentParentApplication": {
         "properties": {
            "inventory_id": {
               "description": "Inventory ID of the parent application.",
               "title": "Inventory Id",
               "type": "string"
            },
            "agent_id": {
               "description": "Agent ID of the parent application",
               "title": "Agent Id",
               "type": "string"
            }
         },
         "required": [
            "inventory_id",
            "agent_id"
         ],
         "title": "AIAgentParentApplication",
         "type": "object"
      },
      "AIAgentRuntimeDetails": {
         "properties": {
            "engine": {
               "description": "Python version required by the agent.",
               "title": "Engine",
               "type": "string"
            },
            "cpu_capacity": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "CPU capacity required by the agent.",
               "title": "Cpu Capacity"
            },
            "memory": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Memory required by the agent.",
               "title": "Memory"
            }
         },
         "required": [
            "engine"
         ],
         "title": "AIAgentRuntimeDetails",
         "type": "object"
      },
      "AIAgentSchema": {
         "properties": {
            "title": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Title for schema.",
               "title": "Title"
            },
            "type": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Type of schema.",
               "title": "Type"
            },
            "properties": {
               "type": "object",
               "description": "Properties for schema.",
               "title": "Properties"
            },
            "required": {
               "anyOf": [
                  {
                     "items": {},
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Required for schema.",
               "title": "Required"
            }
         },
         "required": [
            "properties"
         ],
         "title": "AIAgentSchema",
         "type": "object"
      },
      "AIAgentTool": {
         "properties": {
            "inventory_id": {
               "description": "Inventory ID of the tool where the application is used.",
               "title": "Inventory Id",
               "type": "string"
            },
            "tool_id": {
               "description": "Tool ID of the tool where the application is used.",
               "title": "Tool Id",
               "type": "string"
            }
         },
         "required": [
            "inventory_id",
            "tool_id"
         ],
         "title": "AIAgentTool",
         "type": "object"
      },
      "AIAgentUsedInApplication": {
         "properties": {
            "inventory_id": {
               "description": "Inventory ID of the application where the agent is used.",
               "title": "Inventory Id",
               "type": "string"
            },
            "agent_asset_id": {
               "description": "Agent ID of the application where the agent is used.",
               "title": "Agent Asset Id",
               "type": "string"
            }
         },
         "required": [
            "inventory_id",
            "agent_asset_id"
         ],
         "title": "AIAgentUsedInApplication",
         "type": "object"
      },
      "Categories": {
         "enum": [
            "Search",
            "Guardrails",
            "Query",
            "RAG",
            "Evaluation",
            "Other"
         ],
         "title": "Categories",
         "type": "string"
      },
      "CustomToolType": {
         "enum": [
            "code",
            "endpoint"
         ],
         "title": "CustomToolType",
         "type": "string"
      },
      "Framework": {
         "enum": [
            "langchain",
            "langgraph"
         ],
         "title": "Framework",
         "type": "string"
      },
      "ServiceProviderType": {
         "enum": [
            "wml",
            "custom"
         ],
         "title": "ServiceProviderType",
         "type": "string"
      }
   },
   "required": [
      "agent_name",
      "description"
   ]
}

Fields:

agent_name (str)
agent_type (ibm_watsonx_gov.tools.utils.constants.CustomToolType | None)
benchmark_test (dict | None)
category (list[ibm_watsonx_gov.tools.utils.constants.Categories] | None)
code (ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentCodePayload | None)
dependencies (ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentDependencies | None)
description (str)
development_implementation_url (str | None)
display_name (str | None)
endpoint (ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentEndpointPayload | None)
environment_variables (list[str] | None)
framework (list[ibm_watsonx_gov.tools.utils.constants.Framework] | None)
implementation_url (str | None)
inventory_id (str | None)
metrics (dict | None)
parent_applications (list[ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentParentApplication] | None)
pricing (dict | None)
reusable (bool)
schema_ (ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentSchema | None)
service_provider_type (ibm_watsonx_gov.agent_catalog.utils.constants.ServiceProviderType | None)
summary (str | None)
tools (list[ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentTool] | None)
used_in_applications (list[ibm_watsonx_gov.agent_catalog.entities.ai_agent.AIAgentUsedInApplication] | None)
validation_implementation_url (str | None)
version (str | None)

Validators:

check_required_fields » all fields
validate_post_payload » all fields

field agent_name: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Unique name for the agent')] [Required]¶

Unique name for the agent

Validated by:

check_required_fields
validate_post_payload

field agent_type: ")] = CustomToolType.ENDPOINT¶

Type of the agent. Allowed agent types are: [‘code’, ‘endpoint’].

Validated by:

check_required_fields
validate_post_payload

field benchmark_test: Annotated[dict | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Benchmark test details.')] = None¶

Benchmark test details.

Validated by:

check_required_fields
validate_post_payload

field category: ")] [Optional]¶

Specify the category under which the agent will be classified. Allowed values are [‘Search’, ‘Guardrails’, ‘Query’, ‘RAG’, ‘Evaluation’, ‘Other’].

Validated by:

check_required_fields
validate_post_payload

field code: Annotated[AIAgentCodePayload | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Code-related information for the agent.')] = None¶

Code-related information for the agent.

Validated by:

check_required_fields
validate_post_payload

field dependencies: Annotated[AIAgentDependencies | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Dependencies required by this agent.')] = None¶

Dependencies required by this agent.

Validated by:

check_required_fields
validate_post_payload

field description: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Short description about the agent.')] [Required]¶

Short description about the agent.

Validated by:

check_required_fields
validate_post_payload

field development_implementation_url: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None)] = None¶

Validated by:

check_required_fields
validate_post_payload

field display_name: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Unique name for displaying the agent.')] = None¶

Unique name for displaying the agent.

Validated by:

check_required_fields
validate_post_payload

field endpoint: Annotated[AIAgentEndpointPayload | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Endpoint-related information for the agent.')] = None¶

Endpoint-related information for the agent.

Validated by:

check_required_fields
validate_post_payload

field environment_variables: Annotated[list[str] | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Environment variables required by this agent.')] = None¶

Environment variables required by this agent.

Validated by:

check_required_fields
validate_post_payload

field framework: ')] [Optional]¶

Specify the framework used by the agent.

Validated by:

check_required_fields
validate_post_payload

field implementation_url: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None)] = None¶

Validated by:

check_required_fields
validate_post_payload

field inventory_id: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Inventory ID in which the asset needs to be created.')] = None¶

Inventory ID in which the asset needs to be created.

Validated by:

check_required_fields
validate_post_payload

field metrics: Annotated[dict | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Metrics and their respective values.')] = None¶

Metrics and their respective values.

Validated by:

check_required_fields
validate_post_payload

field parent_applications: Annotated[list[AIAgentParentApplication] | None, FieldInfo(annotation=NoneType, required=False, default=None, description='List of parent applications')] = None¶

List of parent applications

Validated by:

check_required_fields
validate_post_payload

field pricing: Annotated[dict | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Type of currency and its corresponding price.')] = None¶

Type of currency and its corresponding price.

Validated by:

check_required_fields
validate_post_payload

field reusable: Annotated[bool, FieldInfo(annotation=NoneType, required=False, default=False, description='Specify the agent will be reusable.')] = False¶

Specify the agent will be reusable.

Validated by:

check_required_fields
validate_post_payload

field schema_: Annotated[AIAgentSchema | None, FieldInfo(annotation=NoneType, required=False, default=None, alias='schema', alias_priority=2, description='Schema information for this agent.')] = None (alias 'schema')¶

Schema information for this agent.

Validated by:

check_required_fields
validate_post_payload

field service_provider_type: ")] = ServiceProviderType.CUSTOM¶

Service provider type. Allowed values are: [‘wml’, ‘custom’].

Validated by:

check_required_fields
validate_post_payload

field summary: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None, description='Summary of the agent.')] = None¶

Summary of the agent.

Validated by:

check_required_fields
validate_post_payload

field tools: Annotated[list[AIAgentTool] | None, FieldInfo(annotation=NoneType, required=False, default=None, description='List of tools used in this applications')] = None¶

List of tools used in this applications

Validated by:

check_required_fields
validate_post_payload

field used_in_applications: Annotated[list[AIAgentUsedInApplication] | None, FieldInfo(annotation=NoneType, required=False, default=None, description='List of applications where this application is used.')] = None¶

List of applications where this application is used.

Validated by:

check_required_fields
validate_post_payload

field validation_implementation_url: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None)] = None¶

Validated by:

check_required_fields
validate_post_payload

field version: Annotated[str | None, FieldInfo(annotation=NoneType, required=False, default=None)] = None¶

Validated by:

check_required_fields
validate_post_payload

validator check_required_fields » all fields¶

validator validate_post_payload » all fields¶

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.AgentUpdatePayload¶

Bases: BaseModel

Show JSON schema

{
   "title": "AgentUpdatePayload",
   "type": "object",
   "properties": {
      "payload": {
         "description": "List of patch payloads used to perform the patch operation.",
         "items": {
            "$ref": "#/$defs/PatchPayload"
         },
         "title": "Payload",
         "type": "array"
      }
   },
   "$defs": {
      "PatchOperationTypes": {
         "enum": [
            "add",
            "remove",
            "replace"
         ],
         "title": "PatchOperationTypes",
         "type": "string"
      },
      "PatchPayload": {
         "properties": {
            "op": {
               "$ref": "#/$defs/PatchOperationTypes",
               "description": "Type of operation to be performed."
            },
            "path": {
               "description": "Path of the field on which the operation needs to be performed.",
               "title": "Path",
               "type": "string"
            },
            "value": {
               "description": "The value to be applied during the specified operation on the given field path.",
               "title": "Value"
            }
         },
         "required": [
            "op",
            "path",
            "value"
         ],
         "title": "PatchPayload",
         "type": "object"
      }
   },
   "required": [
      "payload"
   ]
}

Fields:

payload (list[ibm_watsonx_gov.agent_catalog.entities.ai_agent.PatchPayload])

Validators:

validate_ai_agent_patch_payload » all fields

field payload: Annotated[list[PatchPayload], FieldInfo(annotation=NoneType, required=True, description='List of patch payloads used to perform the patch operation.')] [Required]¶

List of patch payloads used to perform the patch operation.

Validated by:

validate_ai_agent_patch_payload

validator validate_ai_agent_patch_payload » all fields¶

pydantic model ibm_watsonx_gov.agent_catalog.entities.ai_agent.PatchPayload¶

Bases: BaseModel

Show JSON schema

{
   "title": "PatchPayload",
   "type": "object",
   "properties": {
      "op": {
         "$ref": "#/$defs/PatchOperationTypes",
         "description": "Type of operation to be performed."
      },
      "path": {
         "description": "Path of the field on which the operation needs to be performed.",
         "title": "Path",
         "type": "string"
      },
      "value": {
         "description": "The value to be applied during the specified operation on the given field path.",
         "title": "Value"
      }
   },
   "$defs": {
      "PatchOperationTypes": {
         "enum": [
            "add",
            "remove",
            "replace"
         ],
         "title": "PatchOperationTypes",
         "type": "string"
      }
   },
   "required": [
      "op",
      "path",
      "value"
   ]
}

Fields:

op (ibm_watsonx_gov.tools.utils.constants.PatchOperationTypes)
path (str)
value (Any)

Validators:

validate_patch_payload » all fields

field op: Annotated[PatchOperationTypes, FieldInfo(annotation=NoneType, required=True, description='Type of operation to be performed.')] [Required]¶

Type of operation to be performed.

Validated by:

validate_patch_payload

field path: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Path of the field on which the operation needs to be performed.')] [Required]¶

Path of the field on which the operation needs to be performed.

Validated by:

validate_patch_payload

field value: Annotated[Any, FieldInfo(annotation=NoneType, required=True, description='The value to be applied during the specified operation on the given field path.')] [Required]¶

The value to be applied during the specified operation on the given field path.

Validated by:

validate_patch_payload

validator validate_patch_payload » all fields¶