django-agent-studio 0.1.5__py3-none-any.whl → 0.1.6__py3-none-any.whl

django_agent_studio/agents/builder.py

@@ -40,6 +40,7 @@ You have access to tools that allow you to:
 7. **Create multi-agent systems** by adding sub-agent tools
 8. **Switch between agents and systems** in the UI
 9. **Configure agent memory** (enable/disable the remember tool)
+10. **Manage agent specifications** (human-readable behavior descriptions)
 
 ## IMPORTANT: Tool Usage
 
@@ -116,6 +117,28 @@ Agents have a built-in memory system that allows them to remember facts about us
 - Support agents that benefit from knowing user history
 - Any agent where personalization improves the experience
 
+## Agent Specification (Spec)
+
+Every agent can have a **spec** - a human-readable description of its intended behavior, separate from the technical system prompt.
+
+**Why use a spec?**
+- **Human oversight**: Non-technical stakeholders can review and approve agent behavior
+- **Documentation**: Clear record of what the agent should and shouldn't do
+- **Builder context**: You can reference the spec when crafting the system prompt
+
+**What to include in a spec:**
+- Purpose: What is this agent for?
+- Capabilities: What can it do?
+- Constraints: What should it NOT do?
+- Tone/personality: How should it communicate?
+- Edge cases: How should it handle unusual situations?
+
+**Tools:**
+- `get_agent_spec` - View the current spec
+- `update_agent_spec` - Update the spec
+
+**Best practice:** When building an agent, start by writing or reviewing the spec, then craft the system prompt to implement that spec. This ensures alignment between intended and actual behavior.
+
 When helping users:
 - Ask clarifying questions to understand what they want their agent to do
 - Suggest appropriate system prompts based on the agent's purpose
@@ -232,6 +255,34 @@ BUILDER_TOOLS = [
             },
         },
     },
+    {
+        "type": "function",
+        "function": {
+            "name": "get_agent_spec",
+            "description": "Get the agent's specification - a human-readable description of the agent's intended behavior, capabilities, and constraints. The spec is separate from the technical system prompt and is meant for human oversight and documentation.",
+            "parameters": {
+                "type": "object",
+                "properties": {},
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "update_agent_spec",
+            "description": "Update the agent's specification. The spec should describe in plain English: what the agent does, what it should and shouldn't do, its personality/tone, and any important constraints. This is for human oversight - non-technical stakeholders can review and edit this.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "spec": {
+                        "type": "string",
+                        "description": "The agent specification in plain English. Describe the agent's purpose, capabilities, constraints, and expected behavior.",
+                    },
+                },
+                "required": ["spec"],
+            },
+        },
+    },
     {
         "type": "function",
         "function": {
@@ -943,6 +994,23 @@ Knowledge: {len(config.get('knowledge', []))} sources
                 await create_revision(agent, comment=f"Renamed from '{old_name}' to '{agent.name}'")
                 return {"success": True, "message": "Agent name updated"}
 
+            elif tool_name == "get_agent_spec":
+                return {
+                    "spec": agent.spec or "",
+                    "has_spec": bool(agent.spec),
+                    "message": "The agent spec describes intended behavior in plain English, separate from the technical system prompt.",
+                }
+
+            elif tool_name == "update_agent_spec":
+                agent.spec = args["spec"]
+                await sync_to_async(agent.save)()
+                await create_revision(agent, comment="Updated agent specification")
+                return {
+                    "success": True,
+                    "message": "Agent specification updated",
+                    "spec_preview": agent.spec[:200] + "..." if len(agent.spec) > 200 else agent.spec,
+                }
+
             elif tool_name == "update_model_settings":
                 if version:
                     changes = []

{django_agent_studio-0.1.5.dist-info → django_agent_studio-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-agent-studio
-Version: 0.1.5
+Version: 0.1.6
 Summary: Visual agent builder and management studio for Django - build custom GPTs with a two-pane interface
 Author: Chris Barry
 License-Expression: MIT

{django_agent_studio-0.1.5.dist-info → django_agent_studio-0.1.6.dist-info}/RECORD

@@ -3,7 +3,7 @@ django_agent_studio/apps.py,sha256=L89QWn4XOvPBs2z6qHAhaE4uZQpasJntYD75aSd2p_k,6
 django_agent_studio/urls.py,sha256=O_rrobaxpmg8gR0JmeUzQ0TI3E8mGdcz27p4OJlcI8s,743
 django_agent_studio/views.py,sha256=bQxSIeL9-D4MzKwWkeHEFXrzo1CD911qicrt_A8t_6M,3153
 django_agent_studio/agents/__init__.py,sha256=VYL_ato0DtggIo4BGRkyiz9cm1ARPXhhTQFzoG__NVM,800
-django_agent_studio/agents/builder.py,sha256=Kpn16CK_5JuPJT02UO0VsTPhNusY2v4LrWA2Dcvs7WM,80594
+django_agent_studio/agents/builder.py,sha256=f8BLWCheLRNhnUhU6_oDzoCba0nrWCzpz3cCYYT6eHo,83753
 django_agent_studio/agents/dynamic.py,sha256=KhmdAHkYUdfuuBgsKeY-Sf9sjDA-QiBVWHpw0NAgPX0,13939
 django_agent_studio/api/__init__.py,sha256=vtBwuvBENyFFhFqCWyFsI6cYu4N9ZGqSMmHIRhr9a_U,45
 django_agent_studio/api/permissions.py,sha256=MutmA8TxZb4ZwGfeEoolK-QI04Gbcxs7DPNzkXe_Bss,5302
@@ -26,7 +26,7 @@ django_agent_studio/templates/django_agent_studio/base.html,sha256=rpHmr7CAWGwRk
 django_agent_studio/templates/django_agent_studio/builder.html,sha256=L2KX-RLVpnC2mmYsIl_aSeJIc6b63knTYVrDg8aaU1g,61425
 django_agent_studio/templates/django_agent_studio/home.html,sha256=pgwKPjiQe9UxYYLGSsKT-6erEPDUdW9MZ5D-MOjIxK4,4385
 django_agent_studio/templates/django_agent_studio/test.html,sha256=h9aTtTD1eYcgG-n410qMSryHdpXyKny0hjiKYAoGsic,3779
-django_agent_studio-0.1.5.dist-info/METADATA,sha256=_2hWCRBbGlZNCwlNNzIxeaT2jvjPiOhQI9krgm-zoOw,11294
-django_agent_studio-0.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-django_agent_studio-0.1.5.dist-info/top_level.txt,sha256=O1kqZzXPOsJlqnPSAcB2fH5WpJNY8ZNfHEJzX9_SZ0A,20
-django_agent_studio-0.1.5.dist-info/RECORD,,
+django_agent_studio-0.1.6.dist-info/METADATA,sha256=A3evUgzWVKgK5MtOlCRr2-9Fnl9NbTAJ96IKoTKSQpU,11294
+django_agent_studio-0.1.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+django_agent_studio-0.1.6.dist-info/top_level.txt,sha256=O1kqZzXPOsJlqnPSAcB2fH5WpJNY8ZNfHEJzX9_SZ0A,20
+django_agent_studio-0.1.6.dist-info/RECORD,,