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

digitalocean_genai_sdk/types/agents/function_create_params.py

@@ -0,0 +1,25 @@
+# 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__ = ["FunctionCreateParams"]
+
+
+class FunctionCreateParams(TypedDict, total=False):
+    body_agent_uuid: Annotated[str, PropertyInfo(alias="agent_uuid")]
+
+    description: str
+
+    faas_name: str
+
+    faas_namespace: str
+
+    function_name: str
+
+    input_schema: object
+
+    output_schema: object

digitalocean_genai_sdk/types/agents/function_create_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__ = ["FunctionCreateResponse"]
+
+
+class FunctionCreateResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from ..api_agent import APIAgent

digitalocean_genai_sdk/types/agents/function_delete_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__ = ["FunctionDeleteResponse"]
+
+
+class FunctionDeleteResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from ..api_agent import APIAgent

digitalocean_genai_sdk/types/agents/function_update_params.py

@@ -0,0 +1,29 @@
+# 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__ = ["FunctionUpdateParams"]
+
+
+class FunctionUpdateParams(TypedDict, total=False):
+    path_agent_uuid: Required[Annotated[str, PropertyInfo(alias="agent_uuid")]]
+
+    body_agent_uuid: Annotated[str, PropertyInfo(alias="agent_uuid")]
+
+    description: str
+
+    faas_name: str
+
+    faas_namespace: str
+
+    function_name: str
+
+    body_function_uuid: Annotated[str, PropertyInfo(alias="function_uuid")]
+
+    input_schema: object
+
+    output_schema: object

digitalocean_genai_sdk/types/agents/function_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__ = ["FunctionUpdateResponse"]
+
+
+class FunctionUpdateResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from ..api_agent import APIAgent

digitalocean_genai_sdk/types/agents/knowledge_base_detach_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__ = ["KnowledgeBaseDetachResponse"]
+
+
+class KnowledgeBaseDetachResponse(BaseModel):
+    agent: Optional["APIAgent"] = None
+
+
+from ..api_agent import APIAgent

digitalocean_genai_sdk/types/agents/version_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__ = ["VersionListParams"]
+
+
+class VersionListParams(TypedDict, total=False):
+    page: int
+    """page number."""
+
+    per_page: int
+    """items per page."""

digitalocean_genai_sdk/types/agents/version_list_response.py

@@ -0,0 +1,118 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from pydantic import Field as FieldInfo
+
+from .api_meta import APIMeta
+from ..._models import BaseModel
+from .api_links import APILinks
+from ..api_retrieval_method import APIRetrievalMethod
+
+__all__ = [
+    "VersionListResponse",
+    "AgentVersion",
+    "AgentVersionAttachedChildAgent",
+    "AgentVersionAttachedFunction",
+    "AgentVersionAttachedGuardrail",
+    "AgentVersionAttachedKnowledgebase",
+]
+
+
+class AgentVersionAttachedChildAgent(BaseModel):
+    agent_name: Optional[str] = None
+
+    child_agent_uuid: Optional[str] = None
+
+    if_case: Optional[str] = None
+
+    is_deleted: Optional[bool] = None
+
+    route_name: Optional[str] = None
+
+
+class AgentVersionAttachedFunction(BaseModel):
+    description: Optional[str] = None
+
+    faas_name: Optional[str] = None
+
+    faas_namespace: Optional[str] = None
+
+    is_deleted: Optional[bool] = None
+
+    name: Optional[str] = None
+
+
+class AgentVersionAttachedGuardrail(BaseModel):
+    is_deleted: Optional[bool] = None
+
+    name: Optional[str] = None
+
+    priority: Optional[int] = None
+
+    uuid: Optional[str] = None
+
+
+class AgentVersionAttachedKnowledgebase(BaseModel):
+    is_deleted: Optional[bool] = None
+
+    name: Optional[str] = None
+
+    uuid: Optional[str] = None
+
+
+class AgentVersion(BaseModel):
+    id: Optional[str] = None
+
+    agent_uuid: Optional[str] = None
+
+    attached_child_agents: Optional[List[AgentVersionAttachedChildAgent]] = None
+
+    attached_functions: Optional[List[AgentVersionAttachedFunction]] = None
+
+    attached_guardrails: Optional[List[AgentVersionAttachedGuardrail]] = None
+
+    attached_knowledgebases: Optional[List[AgentVersionAttachedKnowledgebase]] = None
+
+    can_rollback: Optional[bool] = None
+
+    created_at: Optional[datetime] = None
+
+    created_by_email: Optional[str] = None
+
+    currently_applied: Optional[bool] = None
+
+    description: Optional[str] = None
+
+    instruction: Optional[str] = None
+
+    k: Optional[int] = None
+
+    max_tokens: Optional[int] = None
+
+    api_model_name: Optional[str] = FieldInfo(alias="model_name", default=None)
+
+    name: Optional[str] = None
+
+    provide_citations: Optional[bool] = None
+
+    retrieval_method: Optional[APIRetrievalMethod] = None
+
+    tags: Optional[List[str]] = None
+
+    temperature: Optional[float] = None
+
+    top_p: Optional[float] = None
+
+    trigger_action: Optional[str] = None
+
+    version_hash: Optional[str] = None
+
+
+class VersionListResponse(BaseModel):
+    agent_versions: Optional[List[AgentVersion]] = None
+
+    links: Optional[APILinks] = None
+
+    meta: Optional[APIMeta] = None

digitalocean_genai_sdk/types/agents/version_update_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__ = ["VersionUpdateParams"]
+
+
+class VersionUpdateParams(TypedDict, total=False):
+    body_uuid: Annotated[str, PropertyInfo(alias="uuid")]
+
+    version_hash: str

digitalocean_genai_sdk/types/agents/version_update_response.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["VersionUpdateResponse", "AuditHeader"]
+
+
+class AuditHeader(BaseModel):
+    actor_id: Optional[str] = None
+
+    actor_ip: Optional[str] = None
+
+    actor_uuid: Optional[str] = None
+
+    context_urn: Optional[str] = None
+
+    origin_application: Optional[str] = None
+
+    user_id: Optional[str] = None
+
+    user_uuid: Optional[str] = None
+
+
+class VersionUpdateResponse(BaseModel):
+    audit_header: Optional[AuditHeader] = None
+    """An alternative way to provide auth information. for internal use only."""
+
+    version_hash: Optional[str] = None

digitalocean_genai_sdk/types/api_agent.py

@@ -0,0 +1,263 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .api_model import APIModel
+from .api_knowledge_base import APIKnowledgeBase
+from .api_retrieval_method import APIRetrievalMethod
+from .api_agent_api_key_info import APIAgentAPIKeyInfo
+from .api_openai_api_key_info import APIOpenAIAPIKeyInfo
+from .api_deployment_visibility import APIDeploymentVisibility
+from .api_anthropic_api_key_info import APIAnthropicAPIKeyInfo
+
+__all__ = [
+    "APIAgent",
+    "APIKey",
+    "Chatbot",
+    "ChatbotIdentifier",
+    "Deployment",
+    "Function",
+    "Guardrail",
+    "Template",
+    "TemplateGuardrail",
+]
+
+
+class APIKey(BaseModel):
+    api_key: Optional[str] = None
+
+
+class Chatbot(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 ChatbotIdentifier(BaseModel):
+    agent_chatbot_identifier: Optional[str] = None
+
+
+class Deployment(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 Function(BaseModel):
+    api_key: Optional[str] = None
+
+    created_at: Optional[datetime] = None
+
+    created_by: Optional[str] = None
+
+    description: Optional[str] = None
+
+    faas_name: Optional[str] = None
+
+    faas_namespace: Optional[str] = None
+
+    input_schema: Optional[object] = None
+
+    name: Optional[str] = None
+
+    output_schema: Optional[object] = None
+
+    updated_at: Optional[datetime] = None
+
+    url: Optional[str] = None
+
+    uuid: Optional[str] = None
+
+
+class Guardrail(BaseModel):
+    agent_uuid: Optional[str] = None
+
+    created_at: Optional[datetime] = None
+
+    default_response: Optional[str] = None
+
+    description: Optional[str] = None
+
+    guardrail_uuid: Optional[str] = None
+
+    is_attached: Optional[bool] = None
+
+    is_default: Optional[bool] = None
+
+    metadata: Optional[object] = None
+
+    name: Optional[str] = None
+
+    priority: Optional[int] = None
+
+    type: Optional[
+        Literal[
+            "GUARDRAIL_TYPE_UNKNOWN",
+            "GUARDRAIL_TYPE_JAILBREAK",
+            "GUARDRAIL_TYPE_SENSITIVE_DATA",
+            "GUARDRAIL_TYPE_CONTENT_MODERATION",
+        ]
+    ] = None
+
+    updated_at: Optional[datetime] = None
+
+    uuid: Optional[str] = None
+
+
+class TemplateGuardrail(BaseModel):
+    priority: Optional[int] = None
+
+    uuid: Optional[str] = None
+
+
+class Template(BaseModel):
+    created_at: Optional[datetime] = None
+
+    description: Optional[str] = None
+
+    guardrails: Optional[List[TemplateGuardrail]] = 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 APIAgent(BaseModel):
+    anthropic_api_key: Optional[APIAnthropicAPIKeyInfo] = None
+
+    api_key_infos: Optional[List[APIAgentAPIKeyInfo]] = None
+
+    api_keys: Optional[List[APIKey]] = None
+
+    chatbot: Optional[Chatbot] = None
+
+    chatbot_identifiers: Optional[List[ChatbotIdentifier]] = None
+
+    child_agents: Optional[List["APIAgent"]] = None
+
+    created_at: Optional[datetime] = None
+
+    deployment: Optional[Deployment] = None
+
+    description: Optional[str] = None
+
+    functions: Optional[List[Function]] = None
+
+    guardrails: Optional[List[Guardrail]] = 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
+
+    knowledge_bases: Optional[List[APIKnowledgeBase]] = None
+
+    max_tokens: Optional[int] = None
+
+    model: Optional[APIModel] = None
+
+    name: Optional[str] = None
+
+    openai_api_key: Optional[APIOpenAIAPIKeyInfo] = None
+
+    parent_agents: Optional[List["APIAgent"]] = 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
+
+    template: Optional[Template] = None
+
+    top_p: Optional[float] = None
+
+    updated_at: Optional[datetime] = None
+
+    url: Optional[str] = None
+
+    user_id: Optional[str] = None
+
+    uuid: Optional[str] = None

digitalocean_genai_sdk/types/api_agent_api_key_info.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["APIAgentAPIKeyInfo"]
+
+
+class APIAgentAPIKeyInfo(BaseModel):
+    created_at: Optional[datetime] = None
+
+    created_by: Optional[str] = None
+
+    deleted_at: Optional[datetime] = None
+
+    name: Optional[str] = None
+
+    secret_key: Optional[str] = None
+
+    uuid: Optional[str] = None

digitalocean_genai_sdk/types/api_agreement.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["APIAgreement"]
+
+
+class APIAgreement(BaseModel):
+    description: Optional[str] = None
+
+    name: Optional[str] = None
+
+    url: Optional[str] = None
+
+    uuid: Optional[str] = None

digitalocean_genai_sdk/types/api_anthropic_api_key_info.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["APIAnthropicAPIKeyInfo"]
+
+
+class APIAnthropicAPIKeyInfo(BaseModel):
+    created_at: Optional[datetime] = None
+
+    created_by: Optional[str] = None
+
+    deleted_at: Optional[datetime] = None
+
+    name: Optional[str] = None
+
+    updated_at: Optional[datetime] = None
+
+    uuid: Optional[str] = None

digitalocean_genai_sdk/types/api_deployment_visibility.py

@@ -0,0 +1,9 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["APIDeploymentVisibility"]
+
+APIDeploymentVisibility: TypeAlias = Literal[
+    "VISIBILITY_UNKNOWN", "VISIBILITY_DISABLED", "VISIBILITY_PLAYGROUND", "VISIBILITY_PUBLIC", "VISIBILITY_PRIVATE"
+]

digitalocean_genai_sdk/types/api_indexing_job.py

@@ -0,0 +1,43 @@
+# 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
+
+__all__ = ["APIIndexingJob"]
+
+
+class APIIndexingJob(BaseModel):
+    completed_datasources: Optional[int] = None
+
+    created_at: Optional[datetime] = None
+
+    data_source_uuids: Optional[List[str]] = None
+
+    finished_at: Optional[datetime] = None
+
+    knowledge_base_uuid: Optional[str] = None
+
+    phase: Optional[
+        Literal[
+            "BATCH_JOB_PHASE_UNKNOWN",
+            "BATCH_JOB_PHASE_PENDING",
+            "BATCH_JOB_PHASE_RUNNING",
+            "BATCH_JOB_PHASE_SUCCEEDED",
+            "BATCH_JOB_PHASE_FAILED",
+            "BATCH_JOB_PHASE_ERROR",
+            "BATCH_JOB_PHASE_CANCELLED",
+        ]
+    ] = None
+
+    started_at: Optional[datetime] = None
+
+    tokens: Optional[int] = None
+
+    total_datasources: Optional[int] = None
+
+    updated_at: Optional[datetime] = None
+
+    uuid: Optional[str] = None