c63a5cfe-b235-4fbe-8bbb-82a9e02a482a-python 0.1.0a3__py3-none-any.whl

digitalocean_genai_sdk/types/agent_list_response.py

@@ -0,0 +1,198 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .api_model import APIModel
+from .agents.api_meta import APIMeta
+from .agents.api_links import APILinks
+from .api_knowledge_base import APIKnowledgeBase
+from .api_retrieval_method import APIRetrievalMethod
+from .api_deployment_visibility import APIDeploymentVisibility
+
+__all__ = [
+    "AgentListResponse",
+    "Agent",
+    "AgentChatbot",
+    "AgentChatbotIdentifier",
+    "AgentDeployment",
+    "AgentTemplate",
+    "AgentTemplateGuardrail",
+]
+
+
+class AgentChatbot(BaseModel):
+    button_background_color: Optional[str] = None
+
+    logo: Optional[str] = None
+
+    name: Optional[str] = None
+
+    primary_color: Optional[str] = None
+
+    secondary_color: Optional[str] = None
+
+    starting_message: Optional[str] = None
+
+
+class AgentChatbotIdentifier(BaseModel):
+    agent_chatbot_identifier: Optional[str] = None
+
+
+class AgentDeployment(BaseModel):
+    created_at: Optional[datetime] = None
+
+    name: Optional[str] = None
+
+    status: Optional[
+        Literal[
+            "STATUS_UNKNOWN",
+            "STATUS_WAITING_FOR_DEPLOYMENT",
+            "STATUS_DEPLOYING",
+            "STATUS_RUNNING",
+            "STATUS_FAILED",
+            "STATUS_WAITING_FOR_UNDEPLOYMENT",
+            "STATUS_UNDEPLOYING",
+            "STATUS_UNDEPLOYMENT_FAILED",
+            "STATUS_DELETED",
+        ]
+    ] = None
+
+    updated_at: Optional[datetime] = None
+
+    url: Optional[str] = None
+
+    uuid: Optional[str] = None
+
+    visibility: Optional[APIDeploymentVisibility] = None
+
+
+class AgentTemplateGuardrail(BaseModel):
+    priority: Optional[int] = None
+
+    uuid: Optional[str] = None
+
+
+class AgentTemplate(BaseModel):
+    created_at: Optional[datetime] = None
+
+    description: Optional[str] = None
+
+    guardrails: Optional[List[AgentTemplateGuardrail]] = None
+
+    instruction: Optional[str] = None
+
+    k: Optional[int] = None
+
+    knowledge_bases: Optional[List[APIKnowledgeBase]] = None
+
+    long_description: Optional[str] = None
+
+    max_tokens: Optional[int] = None
+
+    model: Optional[APIModel] = None
+
+    name: Optional[str] = None
+
+    short_description: Optional[str] = None
+
+    summary: Optional[str] = None
+
+    tags: Optional[List[str]] = None
+
+    temperature: Optional[float] = None
+
+    template_type: Optional[Literal["AGENT_TEMPLATE_TYPE_STANDARD", "AGENT_TEMPLATE_TYPE_ONE_CLICK"]] = None
+
+    top_p: Optional[float] = None
+
+    updated_at: Optional[datetime] = None
+
+    uuid: Optional[str] = None
+
+
+class Agent(BaseModel):
+    chatbot: Optional[AgentChatbot] = None
+
+    chatbot_identifiers: Optional[List[AgentChatbotIdentifier]] = None
+
+    created_at: Optional[datetime] = None
+
+    deployment: Optional[AgentDeployment] = None
+
+    description: Optional[str] = None
+
+    if_case: Optional[str] = None
+
+    instruction: Optional[str] = None
+    """Agent instruction.
+
+    Instructions help your agent to perform its job effectively. See
+    [Write Effective Agent Instructions](https://docs.digitalocean.com/products/genai-platform/concepts/best-practices/#agent-instructions)
+    for best practices.
+    """
+
+    k: Optional[int] = None
+
+    max_tokens: Optional[int] = None
+    """
+    Specifies the maximum number of tokens the model can process in a single input
+    or output, set as a number between 1 and 512. This determines the length of each
+    response.
+    """
+
+    model: Optional[APIModel] = None
+
+    name: Optional[str] = None
+
+    project_id: Optional[str] = None
+
+    provide_citations: Optional[bool] = None
+
+    region: Optional[str] = None
+
+    retrieval_method: Optional[APIRetrievalMethod] = None
+
+    route_created_at: Optional[datetime] = None
+
+    route_created_by: Optional[str] = None
+
+    route_name: Optional[str] = None
+
+    route_uuid: Optional[str] = None
+
+    tags: Optional[List[str]] = None
+
+    temperature: Optional[float] = None
+    """Controls the model’s creativity, specified as a number between 0 and 1.
+
+    Lower values produce more predictable and conservative responses, while higher
+    values encourage creativity and variation.
+    """
+
+    template: Optional[AgentTemplate] = None
+
+    top_p: Optional[float] = None
+    """
+    Defines the cumulative probability threshold for word selection, specified as a
+    number between 0 and 1. Higher values allow for more diverse outputs, while
+    lower values ensure focused and coherent responses.
+    """
+
+    updated_at: Optional[datetime] = None
+
+    url: Optional[str] = None
+
+    user_id: Optional[str] = None
+
+    uuid: Optional[str] = None
+
+
+class AgentListResponse(BaseModel):
+    agents: Optional[List[Agent]] = None
+
+    links: Optional[APILinks] = None
+
+    meta: Optional[APIMeta] = None

digitalocean_genai_sdk/types/agent_retrieve_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["AgentRetrieveResponse"]
+
+
+class AgentRetrieveResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from .api_agent import APIAgent

digitalocean_genai_sdk/types/agent_update_params.py

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import Annotated, TypedDict
+
+from .._utils import PropertyInfo
+from .api_retrieval_method import APIRetrievalMethod
+
+__all__ = ["AgentUpdateParams"]
+
+
+class AgentUpdateParams(TypedDict, total=False):
+    anthropic_key_uuid: str
+
+    description: str
+
+    instruction: str
+    """Agent instruction.
+
+    Instructions help your agent to perform its job effectively. See
+    [Write Effective Agent Instructions](https://docs.digitalocean.com/products/genai-platform/concepts/best-practices/#agent-instructions)
+    for best practices.
+    """
+
+    k: int
+
+    max_tokens: int
+    """
+    Specifies the maximum number of tokens the model can process in a single input
+    or output, set as a number between 1 and 512. This determines the length of each
+    response.
+    """
+
+    model_uuid: str
+    """Identifier for the foundation model."""
+
+    name: str
+
+    openai_key_uuid: Annotated[str, PropertyInfo(alias="open_ai_key_uuid")]
+
+    project_id: str
+
+    provide_citations: bool
+
+    retrieval_method: APIRetrievalMethod
+
+    tags: List[str]
+
+    temperature: float
+    """Controls the model’s creativity, specified as a number between 0 and 1.
+
+    Lower values produce more predictable and conservative responses, while higher
+    values encourage creativity and variation.
+    """
+
+    top_p: float
+    """
+    Defines the cumulative probability threshold for word selection, specified as a
+    number between 0 and 1. Higher values allow for more diverse outputs, while
+    lower values ensure focused and coherent responses.
+    """
+
+    body_uuid: Annotated[str, PropertyInfo(alias="uuid")]

digitalocean_genai_sdk/types/agent_update_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["AgentUpdateResponse"]
+
+
+class AgentUpdateResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from .api_agent import APIAgent

digitalocean_genai_sdk/types/agent_update_status_params.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Annotated, TypedDict
+
+from .._utils import PropertyInfo
+from .api_deployment_visibility import APIDeploymentVisibility
+
+__all__ = ["AgentUpdateStatusParams"]
+
+
+class AgentUpdateStatusParams(TypedDict, total=False):
+    body_uuid: Annotated[str, PropertyInfo(alias="uuid")]
+
+    visibility: APIDeploymentVisibility

digitalocean_genai_sdk/types/agent_update_status_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["AgentUpdateStatusResponse"]
+
+
+class AgentUpdateStatusResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from .api_agent import APIAgent

digitalocean_genai_sdk/types/agents/__init__.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .api_meta import APIMeta as APIMeta
+from .api_links import APILinks as APILinks
+from .api_key_list_params import APIKeyListParams as APIKeyListParams
+from .version_list_params import VersionListParams as VersionListParams
+from .api_key_create_params import APIKeyCreateParams as APIKeyCreateParams
+from .api_key_list_response import APIKeyListResponse as APIKeyListResponse
+from .api_key_update_params import APIKeyUpdateParams as APIKeyUpdateParams
+from .version_list_response import VersionListResponse as VersionListResponse
+from .version_update_params import VersionUpdateParams as VersionUpdateParams
+from .child_agent_add_params import ChildAgentAddParams as ChildAgentAddParams
+from .function_create_params import FunctionCreateParams as FunctionCreateParams
+from .function_update_params import FunctionUpdateParams as FunctionUpdateParams
+from .api_key_create_response import APIKeyCreateResponse as APIKeyCreateResponse
+from .api_key_delete_response import APIKeyDeleteResponse as APIKeyDeleteResponse
+from .api_key_update_response import APIKeyUpdateResponse as APIKeyUpdateResponse
+from .version_update_response import VersionUpdateResponse as VersionUpdateResponse
+from .child_agent_add_response import ChildAgentAddResponse as ChildAgentAddResponse
+from .function_create_response import FunctionCreateResponse as FunctionCreateResponse
+from .function_delete_response import FunctionDeleteResponse as FunctionDeleteResponse
+from .function_update_response import FunctionUpdateResponse as FunctionUpdateResponse
+from .child_agent_update_params import ChildAgentUpdateParams as ChildAgentUpdateParams
+from .child_agent_view_response import ChildAgentViewResponse as ChildAgentViewResponse
+from .api_key_regenerate_response import APIKeyRegenerateResponse as APIKeyRegenerateResponse
+from .child_agent_delete_response import ChildAgentDeleteResponse as ChildAgentDeleteResponse
+from .child_agent_update_response import ChildAgentUpdateResponse as ChildAgentUpdateResponse
+from .api_link_knowledge_base_output import APILinkKnowledgeBaseOutput as APILinkKnowledgeBaseOutput
+from .knowledge_base_detach_response import KnowledgeBaseDetachResponse as KnowledgeBaseDetachResponse

digitalocean_genai_sdk/types/agents/api_key_create_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["APIKeyCreateParams"]
+
+
+class APIKeyCreateParams(TypedDict, total=False):
+    body_agent_uuid: Annotated[str, PropertyInfo(alias="agent_uuid")]
+
+    name: str

digitalocean_genai_sdk/types/agents/api_key_create_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from ..api_agent_api_key_info import APIAgentAPIKeyInfo
+
+__all__ = ["APIKeyCreateResponse"]
+
+
+class APIKeyCreateResponse(BaseModel):
+    api_key_info: Optional[APIAgentAPIKeyInfo] = None

digitalocean_genai_sdk/types/agents/api_key_delete_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from ..api_agent_api_key_info import APIAgentAPIKeyInfo
+
+__all__ = ["APIKeyDeleteResponse"]
+
+
+class APIKeyDeleteResponse(BaseModel):
+    api_key_info: Optional[APIAgentAPIKeyInfo] = None

digitalocean_genai_sdk/types/agents/api_key_list_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["APIKeyListParams"]
+
+
+class APIKeyListParams(TypedDict, total=False):
+    page: int
+    """page number."""
+
+    per_page: int
+    """items per page."""

digitalocean_genai_sdk/types/agents/api_key_list_response.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .api_meta import APIMeta
+from ..._models import BaseModel
+from .api_links import APILinks
+from ..api_agent_api_key_info import APIAgentAPIKeyInfo
+
+__all__ = ["APIKeyListResponse"]
+
+
+class APIKeyListResponse(BaseModel):
+    api_key_infos: Optional[List[APIAgentAPIKeyInfo]] = None
+
+    links: Optional[APILinks] = None
+
+    meta: Optional[APIMeta] = None

digitalocean_genai_sdk/types/agents/api_key_regenerate_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from ..api_agent_api_key_info import APIAgentAPIKeyInfo
+
+__all__ = ["APIKeyRegenerateResponse"]
+
+
+class APIKeyRegenerateResponse(BaseModel):
+    api_key_info: Optional[APIAgentAPIKeyInfo] = None

digitalocean_genai_sdk/types/agents/api_key_update_params.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["APIKeyUpdateParams"]
+
+
+class APIKeyUpdateParams(TypedDict, total=False):
+    path_agent_uuid: Required[Annotated[str, PropertyInfo(alias="agent_uuid")]]
+
+    body_agent_uuid: Annotated[str, PropertyInfo(alias="agent_uuid")]
+
+    body_api_key_uuid: Annotated[str, PropertyInfo(alias="api_key_uuid")]
+
+    name: str

digitalocean_genai_sdk/types/agents/api_key_update_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+from ..api_agent_api_key_info import APIAgentAPIKeyInfo
+
+__all__ = ["APIKeyUpdateResponse"]
+
+
+class APIKeyUpdateResponse(BaseModel):
+    api_key_info: Optional[APIAgentAPIKeyInfo] = None

digitalocean_genai_sdk/types/agents/api_link_knowledge_base_output.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["APILinkKnowledgeBaseOutput"]
+
+
+class APILinkKnowledgeBaseOutput(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from ..api_agent import APIAgent

digitalocean_genai_sdk/types/agents/api_links.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["APILinks", "Pages"]
+
+
+class Pages(BaseModel):
+    first: Optional[str] = None
+
+    last: Optional[str] = None
+
+    next: Optional[str] = None
+
+    previous: Optional[str] = None
+
+
+class APILinks(BaseModel):
+    pages: Optional[Pages] = None

digitalocean_genai_sdk/types/agents/api_meta.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["APIMeta"]
+
+
+class APIMeta(BaseModel):
+    page: Optional[int] = None
+
+    pages: Optional[int] = None
+
+    total: Optional[int] = None

digitalocean_genai_sdk/types/agents/child_agent_add_params.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["ChildAgentAddParams"]
+
+
+class ChildAgentAddParams(TypedDict, total=False):
+    path_parent_agent_uuid: Required[Annotated[str, PropertyInfo(alias="parent_agent_uuid")]]
+
+    body_child_agent_uuid: Annotated[str, PropertyInfo(alias="child_agent_uuid")]
+
+    if_case: str
+
+    body_parent_agent_uuid: Annotated[str, PropertyInfo(alias="parent_agent_uuid")]
+    """A unique identifier for the parent agent."""
+
+    route_name: str

digitalocean_genai_sdk/types/agents/child_agent_add_response.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ChildAgentAddResponse"]
+
+
+class ChildAgentAddResponse(BaseModel):
+    child_agent_uuid: Optional[str] = None
+
+    parent_agent_uuid: Optional[str] = None
+    """A unique identifier for the parent agent."""

digitalocean_genai_sdk/types/agents/child_agent_delete_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ChildAgentDeleteResponse"]
+
+
+class ChildAgentDeleteResponse(BaseModel):
+    child_agent_uuid: Optional[str] = None
+
+    parent_agent_uuid: Optional[str] = None

digitalocean_genai_sdk/types/agents/child_agent_update_params.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["ChildAgentUpdateParams"]
+
+
+class ChildAgentUpdateParams(TypedDict, total=False):
+    path_parent_agent_uuid: Required[Annotated[str, PropertyInfo(alias="parent_agent_uuid")]]
+
+    body_child_agent_uuid: Annotated[str, PropertyInfo(alias="child_agent_uuid")]
+
+    if_case: str
+
+    body_parent_agent_uuid: Annotated[str, PropertyInfo(alias="parent_agent_uuid")]
+    """A unique identifier for the parent agent."""
+
+    route_name: str
+
+    uuid: str

digitalocean_genai_sdk/types/agents/child_agent_update_response.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ChildAgentUpdateResponse"]
+
+
+class ChildAgentUpdateResponse(BaseModel):
+    child_agent_uuid: Optional[str] = None
+
+    parent_agent_uuid: Optional[str] = None
+    """A unique identifier for the parent agent."""
+
+    rollback: Optional[bool] = None
+
+    uuid: Optional[str] = None

digitalocean_genai_sdk/types/agents/child_agent_view_response.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ChildAgentViewResponse"]
+
+
+class ChildAgentViewResponse(BaseModel):
+    children: Optional[List["APIAgent"]] = None
+
+
+from ..api_agent import APIAgent