persona-sdk-python 0.2.4__tar.gz → 0.2.6__tar.gz

{persona_sdk_python-0.2.4 → persona_sdk_python-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: persona-sdk-python
-Version: 0.2.4
+Version: 0.2.6
 Summary: Async Python SDK for the Persona AI platform
 Project-URL: Homepage, https://persona.applica.guru
 Project-URL: Repository, https://bitbucket.org/applicaguru/persona-sdk-python
@@ -123,7 +123,7 @@ The `PersonaSdk` instance exposes one client per resource:
 
 | Attribute | Description |
 |-----------|-------------|
-| `sdk.agents` | Agent management (CRUD, voices) |
+| `sdk.agents` | Agent management (CRUD, voices, AI instructions, architect) |
 | `sdk.projects` | Project management and subscriptions |
 | `sdk.sessions` | Sessions, messages, usage |
 | `sdk.knowledge_bases` | Knowledge bases, documents, chunk search |
@@ -134,24 +134,20 @@ The `PersonaSdk` instance exposes one client per resource:
 | `sdk.credentials` | OAuth credentials and authorization |
 | `sdk.service_prices` | Service pricing |
 
-Each API method is fully async. Always close the SDK when done:
+Each API method is fully async. Always close the SDK when done to release the
+underlying HTTP connection pool:
 
 ```python
-sdk = PersonaSdk(...)
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_your_api_key",
+)
 try:
     agents = await sdk.agents.list()
 finally:
     await sdk.close()
 ```
 
-Or use it as an async context manager pattern:
-
-```python
-sdk = PersonaSdk(...)
-async with sdk.client._client:  # internal httpx client
-    ...
-```
-
 ## CRUD example
 
 ```python
@@ -172,6 +168,26 @@ await sdk.agents.update(agent["id"], fetched)
 await sdk.agents.delete(agent["id"])
 ```
 
+## AI System Instructions Generation
+
+Generate system instructions for an agent using the project's AI architect:
+
+```python
+# Generate from a description
+instructions = await sdk.agents.generate_system_instructions(
+    "Create a customer support agent that handles billing inquiries"
+)
+
+# Multi-turn refinement with session ID
+instructions = await sdk.agents.generate_system_instructions(
+    "Add a rule to always ask for the order number first",
+    session_id="my-session-id",
+)
+
+# Get the project's architect agent configuration
+architect = await sdk.agents.get_architect()
+```
+
 ## Pagination
 
 List endpoints accept `keyword`, `page`, and `size`:

{persona_sdk_python-0.2.4 → persona_sdk_python-0.2.6}/README.md

@@ -99,7 +99,7 @@ The `PersonaSdk` instance exposes one client per resource:
 
 | Attribute | Description |
 |-----------|-------------|
-| `sdk.agents` | Agent management (CRUD, voices) |
+| `sdk.agents` | Agent management (CRUD, voices, AI instructions, architect) |
 | `sdk.projects` | Project management and subscriptions |
 | `sdk.sessions` | Sessions, messages, usage |
 | `sdk.knowledge_bases` | Knowledge bases, documents, chunk search |
@@ -110,24 +110,20 @@ The `PersonaSdk` instance exposes one client per resource:
 | `sdk.credentials` | OAuth credentials and authorization |
 | `sdk.service_prices` | Service pricing |
 
-Each API method is fully async. Always close the SDK when done:
+Each API method is fully async. Always close the SDK when done to release the
+underlying HTTP connection pool:
 
 ```python
-sdk = PersonaSdk(...)
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_your_api_key",
+)
 try:
     agents = await sdk.agents.list()
 finally:
     await sdk.close()
 ```
 
-Or use it as an async context manager pattern:
-
-```python
-sdk = PersonaSdk(...)
-async with sdk.client._client:  # internal httpx client
-    ...
-```
-
 ## CRUD example
 
 ```python
@@ -148,6 +144,26 @@ await sdk.agents.update(agent["id"], fetched)
 await sdk.agents.delete(agent["id"])
 ```
 
+## AI System Instructions Generation
+
+Generate system instructions for an agent using the project's AI architect:
+
+```python
+# Generate from a description
+instructions = await sdk.agents.generate_system_instructions(
+    "Create a customer support agent that handles billing inquiries"
+)
+
+# Multi-turn refinement with session ID
+instructions = await sdk.agents.generate_system_instructions(
+    "Add a rule to always ask for the order number first",
+    session_id="my-session-id",
+)
+
+# Get the project's architect agent configuration
+architect = await sdk.agents.get_architect()
+```
+
 ## Pagination
 
 List endpoints accept `keyword`, `page`, and `size`:

{persona_sdk_python-0.2.4 → persona_sdk_python-0.2.6}/persona_sdk/api/agents.py

@@ -25,3 +25,15 @@ class AgentsApi:
 
     async def get_voices(self, synthesizer_type: str) -> dict:
         return await self._client.get(f"/values/synthesizers/{synthesizer_type}/voices")
+
+    async def generate_system_instructions(self, prompt: str, session_id: str = None) -> str:
+        """Generate system instructions using the project's AI architect agent."""
+        body = {"prompt": prompt}
+        if session_id:
+            body["sessionId"] = session_id
+        result = await self._client.post("/agents/system-instructions", json=body)
+        return result.get("instructions", "")
+
+    async def get_architect(self) -> dict:
+        """Get or create the project's architect agent configuration."""
+        return await self._client.get("/agents/architect")

{persona_sdk_python-0.2.4 → persona_sdk_python-0.2.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "persona-sdk-python"
-version = "0.2.4"
+version = "0.2.6"
 description = "Async Python SDK for the Persona AI platform"
 readme = "README.md"
 requires-python = ">=3.10"