intentkit 0.6.0.dev13__tar.gz → 0.6.0.dev15__tar.gz

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.0.dev13
+Version: 0.6.0.dev15
 Summary: Intent-based AI Agent Platform - Core Package
 Project-URL: Homepage, https://github.com/crestal-network/intentkit
 Project-URL: Repository, https://github.com/crestal-network/intentkit

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/__init__.py

@@ -3,7 +3,7 @@
 A powerful platform for building AI agents with blockchain and cryptocurrency capabilities.
 """
 
-__version__ = "0.6.0-dev.13"
+__version__ = "0.6.0-dev.15"
 __author__ = "hyacinthus"
 __email__ = "hyacinthus@gmail.com"
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/core/engine.py

@@ -546,12 +546,13 @@ async def stream_agent(message: ChatMessageCreate):
     thread_id = f"{input.agent_id}-{input.chat_id}"
     stream_config = {
         "configurable": {
-            "agent": agent,
+            "agent_id": agent.id,
             "thread_id": thread_id,
             "chat_id": input.chat_id,
             "user_id": input.user_id,
             "app_id": input.app_id,
             "entrypoint": input.author_type,
+            "is_private": is_private,
             "payer": payer if payment_enabled else None,
         },
         "recursion_limit": recursion_limit,

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/core/node.py

@@ -25,6 +25,7 @@ from pydantic import BaseModel
 
 from intentkit.abstracts.graph import AgentError, AgentState
 from intentkit.core.credit import skill_cost
+from intentkit.models.agent import Agent
 from intentkit.models.credit import CreditAccount, OwnerType
 from intentkit.models.skill import Skill
 
@@ -202,7 +203,8 @@ class PostModelNode(RunnableCallable):
             return state_update
         logger.debug(f"last: {messages[-1]}")
         msg = messages[-1]
-        agent = cfg.get("agent")
+        agent_id = cfg.get("agent_id")
+        agent = await Agent.get(agent_id)
         account = await CreditAccount.get_or_create(OwnerType.USER, payer)
         if hasattr(msg, "tool_calls") and msg.tool_calls:
             for tool_call in msg.tool_calls:

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/models/agent_schema.json

@@ -535,6 +535,10 @@
           "title": "System",
           "$ref": "../skills/system/schema.json"
         },
+        "http": {
+          "title": "HTTP Client",
+          "$ref": "../skills/http/schema.json"
+        },
         "web_scraper": {
           "title": "Web Scraper & Content Indexing",
           "$ref": "../skills/web_scraper/schema.json"
@@ -567,6 +571,10 @@
           "title": "Slack",
           "$ref": "../skills/slack/schema.json"
         },
+        "supabase": {
+          "title": "Supabase",
+          "$ref": "../skills/supabase/schema.json"
+        },
         "venice_audio": {
           "title": "Venice Audio",
           "$ref": "../skills/venice_audio/schema.json"

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "intentkit"
-version = "0.6.0-dev.13"
+version = "0.6.0-dev.15"
 description = "Intent-based AI Agent Platform - Core Package"
 authors = [{ name = "hyacinthus", email = "hyacinthus@gmail.com" }]
 requires-python = ">=3.12"

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/base.py

@@ -1,3 +1,4 @@
+import asyncio
 import logging
 from typing import Any, Callable, Dict, Literal, NotRequired, Optional, TypedDict, Union
 
@@ -30,10 +31,33 @@ class SkillConfig(TypedDict):
 
 
 class SkillContext(BaseModel):
-    agent: Agent
-    config: Dict[str, Any]
-    user_id: Optional[str]
+    skill_category: str
+    agent_id: str
+    user_id: Optional[str] = None
+    chat_id: Optional[str] = None
+    app_id: Optional[str] = None
     entrypoint: Literal["web", "twitter", "telegram", "trigger", "api"]
+    is_private: bool
+    payer: Optional[str] = None
+    _agent: Optional[Agent] = None
+
+    @property
+    def agent(self) -> Agent:
+        if self._agent is None:
+            self._agent = asyncio.run(Agent.get(self.agent_id))
+        return self._agent
+
+    @property
+    def config(self) -> Dict[str, Any]:
+        agent = self.agent
+        config = None
+        if agent.skills:
+            config = agent.skills.get(self.skill_category)
+        if not config:
+            raise ValueError(
+                f"Skill {self.skill_category} not found in agent {self.agent_id}"
+            )
+        return config
 
 
 class IntentKitSkill(BaseTool):
@@ -156,19 +180,15 @@ class IntentKitSkill(BaseTool):
     def context_from_config(self, runner_config: RunnableConfig) -> SkillContext:
         if "configurable" not in runner_config:
             raise ValueError("configurable not in runner_config")
-        if "agent" not in runner_config["configurable"]:
-            raise ValueError("agent not in runner_config['configurable']")
-        agent: Agent = runner_config["configurable"].get("agent")
-        config = None
-        if agent.skills:
-            config = agent.skills.get(self.category)
-        if not config:
-            config = getattr(agent, self.category + "_config", {})
-        if not config:
-            config = {}
+        configurable = runner_config["configurable"]
+        if not configurable:
+            raise ValueError("configurable in runnable config is empty")
         return SkillContext(
-            agent=agent,
-            config=config,
-            user_id=runner_config["configurable"].get("user_id"),
-            entrypoint=runner_config["configurable"].get("entrypoint"),
+            skill_category=self.category,
+            agent_id=configurable.get("agent_id"),
+            user_id=configurable.get("user_id"),
+            app_id=configurable.get("app_id"),
+            chat_id=configurable.get("chat_id"),
+            entrypoint=configurable.get("entrypoint"),
+            is_private=configurable.get("is_private"),
         )

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/cryptocompare/fetch_news.py

@@ -57,7 +57,7 @@ class CryptoCompareFetchNews(CryptoCompareBaseTool):
             context = self.context_from_config(config)
 
             # Check rate limit
-            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+            await self.check_rate_limit(context.agent_id, max_requests=5, interval=60)
 
             # Get API key from context
             api_key = context.config.get("api_key")
@@ -93,4 +93,4 @@ class CryptoCompareFetchNews(CryptoCompareBaseTool):
 
         except Exception as e:
             logger.error("Error fetching news: %s", str(e))
-            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e
+            raise type(e)(f"[agent:{context.agent_id}]: {e}") from e

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/cryptocompare/fetch_price.py

@@ -67,7 +67,7 @@ class CryptoCompareFetchPrice(CryptoCompareBaseTool):
             context = self.context_from_config(config)
 
             # Check rate limit
-            await self.check_rate_limit(context.agent.id, max_requests=10, interval=60)
+            await self.check_rate_limit(context.agent_id, max_requests=10, interval=60)
 
             # Get API key from context
             api_key = context.config.get("api_key")
@@ -96,4 +96,4 @@ class CryptoCompareFetchPrice(CryptoCompareBaseTool):
 
         except Exception as e:
             logger.error("Error fetching price: %s", str(e))
-            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e
+            raise type(e)(f"[agent:{context.agent_id}]: {e}") from e

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/cryptocompare/fetch_top_exchanges.py

@@ -73,7 +73,7 @@ class CryptoCompareFetchTopExchanges(CryptoCompareBaseTool):
             context = self.context_from_config(config)
 
             # Check rate limit
-            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+            await self.check_rate_limit(context.agent_id, max_requests=5, interval=60)
 
             # Get API key from context
             api_key = context.config.get("api_key")
@@ -110,4 +110,4 @@ class CryptoCompareFetchTopExchanges(CryptoCompareBaseTool):
 
         except Exception as e:
             logger.error("Error fetching top exchanges: %s", str(e))
-            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e
+            raise type(e)(f"[agent:{context.agent_id}]: {e}") from e

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/cryptocompare/fetch_top_market_cap.py

@@ -66,7 +66,7 @@ class CryptoCompareFetchTopMarketCap(CryptoCompareBaseTool):
             context = self.context_from_config(config)
 
             # Check rate limit
-            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+            await self.check_rate_limit(context.agent_id, max_requests=5, interval=60)
 
             # Get API key from context
             api_key = context.config.get("api_key")
@@ -106,4 +106,4 @@ class CryptoCompareFetchTopMarketCap(CryptoCompareBaseTool):
 
         except Exception as e:
             logger.error("Error fetching top market cap: %s", str(e))
-            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e
+            raise type(e)(f"[agent:{context.agent_id}]: {e}") from e

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/cryptocompare/fetch_top_volume.py

@@ -65,7 +65,7 @@ class CryptoCompareFetchTopVolume(CryptoCompareBaseTool):
             context = self.context_from_config(config)
 
             # Check rate limit
-            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+            await self.check_rate_limit(context.agent_id, max_requests=5, interval=60)
 
             # Get API key from context
             api_key = context.config.get("api_key")
@@ -105,4 +105,4 @@ class CryptoCompareFetchTopVolume(CryptoCompareBaseTool):
 
         except Exception as e:
             logger.error("Error fetching top volume: %s", str(e))
-            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e
+            raise type(e)(f"[agent:{context.agent_id}]: {e}") from e

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/cryptocompare/fetch_trading_signals.py

@@ -68,7 +68,7 @@ class CryptoCompareFetchTradingSignals(CryptoCompareBaseTool):
             context = self.context_from_config(config)
 
             # Check rate limit
-            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+            await self.check_rate_limit(context.agent_id, max_requests=5, interval=60)
 
             # Get API key from context
             api_key = context.config.get("api_key")
@@ -104,4 +104,4 @@ class CryptoCompareFetchTradingSignals(CryptoCompareBaseTool):
 
         except Exception as e:
             logger.error("Error fetching trading signals: %s", str(e))
-            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e
+            raise type(e)(f"[agent:{context.agent_id}]: {e}") from e

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/defillama/base.py

@@ -52,7 +52,7 @@ class DefiLlamaBaseTool(IntentKitSkill):
             Rate limit status and error message if limited
         """
         rate_limit = await self.skill_store.get_agent_skill_data(
-            context.agent.id, self.name, "rate_limit"
+            context.agent_id, self.name, "rate_limit"
         )
         current_time = datetime.now(tz=timezone.utc)
 
@@ -67,7 +67,7 @@ class DefiLlamaBaseTool(IntentKitSkill):
 
             rate_limit["count"] += 1
             await self.skill_store.save_agent_skill_data(
-                context.agent.id, self.name, "rate_limit", rate_limit
+                context.agent_id, self.name, "rate_limit", rate_limit
             )
             return False, None
 
@@ -76,7 +76,7 @@ class DefiLlamaBaseTool(IntentKitSkill):
             "reset_time": (current_time + timedelta(minutes=interval)).isoformat(),
         }
         await self.skill_store.save_agent_skill_data(
-            context.agent.id, self.name, "rate_limit", new_rate_limit
+            context.agent_id, self.name, "rate_limit", new_rate_limit
         )
         return False, None
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/enso/base.py

@@ -32,7 +32,7 @@ class EnsoBaseTool(IntentKitSkill):
         Returns:
             Optional[EvmServerAccount]: The account object if available.
         """
-        client: CdpClient = await get_cdp_client(context.agent.id, self.skill_store)
+        client: CdpClient = await get_cdp_client(context.agent_id, self.skill_store)
         return await client.get_account()
 
     async def get_wallet_provider(
@@ -46,7 +46,7 @@ class EnsoBaseTool(IntentKitSkill):
         Returns:
             Optional[CdpEvmServerWalletProvider]: The wallet provider if available.
         """
-        client: CdpClient = await get_cdp_client(context.agent.id, self.skill_store)
+        client: CdpClient = await get_cdp_client(context.agent_id, self.skill_store)
         return await client.get_wallet_provider()
 
     def get_chain_provider(self, context: SkillContext) -> Optional[ChainProvider]:

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/enso/networks.py

@@ -86,7 +86,7 @@ class EnsoGetNetworks(EnsoBaseTool):
                     )
 
                 await self.skill_store.save_agent_skill_data(
-                    context.agent.id,
+                    context.agent_id,
                     "enso_get_networks",
                     "networks",
                     networks_memory,

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/enso/route.py

@@ -184,7 +184,7 @@ class EnsoRouteShortcut(EnsoBaseTool):
         """
 
         context: SkillContext = self.context_from_config(config)
-        agent_id = context.agent.id
+        agent_id = context.agent_id
         api_token = self.get_api_token(context)
         account = await self.get_account(context)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/enso/tokens.py

@@ -158,7 +158,7 @@ class EnsoGetTokens(EnsoBaseTool):
         url = f"{base_url}/api/v1/tokens"
 
         context: SkillContext = self.context_from_config(config)
-        agent_id = context.agent.id
+        agent_id = context.agent_id
         api_token = self.get_api_token(context)
         main_tokens = self.get_main_tokens(context)
         headers = {

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/firecrawl/clear.py

@@ -49,7 +49,7 @@ class FirecrawlClearIndexedContent(FirecrawlBaseTool):
             str: Confirmation message
         """
         context = self.context_from_config(config)
-        agent_id = context.agent.id if context and context.agent else None
+        agent_id = context.agent_id
 
         if not agent_id:
             return "Error: Agent ID not available for clearing content."

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/firecrawl/crawl.py

@@ -302,21 +302,13 @@ class FirecrawlCrawl(FirecrawlBaseTool):
                                                     "language", ""
                                                 ),
                                                 "source_type": "firecrawl_crawl",
-                                                "indexed_at": str(
-                                                    context.agent.id
-                                                    if context and context.agent
-                                                    else "unknown"
-                                                ),
+                                                "indexed_at": str(context.agent_id),
                                             },
                                         )
                                         documents.append(document)
 
                                 # Get agent ID for indexing
-                                agent_id = (
-                                    context.agent.id
-                                    if context and context.agent
-                                    else None
-                                )
+                                agent_id = context.agent_id
                                 if agent_id and documents:
                                     # Index all documents
                                     total_chunks, was_merged = await index_documents(

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/firecrawl/query.py

@@ -54,10 +54,10 @@ class FirecrawlQueryIndexedContent(FirecrawlBaseTool):
                 raise ValueError("Configuration is required but not provided")
 
             context = self.context_from_config(config)
-            if not context or not context.agent or not context.agent.id:
+            if not context or not context.agent_id:
                 raise ValueError("Agent ID is required but not found in configuration")
 
-            agent_id = context.agent.id
+            agent_id = context.agent_id
 
             logger.info(f"[{agent_id}] Starting Firecrawl query operation: '{query}'")
 
@@ -111,8 +111,8 @@ class FirecrawlQueryIndexedContent(FirecrawlBaseTool):
             try:
                 if config:
                     context = self.context_from_config(config)
-                    if context and context.agent and context.agent.id:
-                        agent_id = context.agent.id
+                    if context and context.agent_id:
+                        agent_id = context.agent_id
             except Exception:
                 pass
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/firecrawl/scrape.py

@@ -255,18 +255,12 @@ class FirecrawlScrape(FirecrawlBaseTool):
                                 "description": metadata.get("description", ""),
                                 "language": metadata.get("language", ""),
                                 "source_type": "firecrawl_scrape",
-                                "indexed_at": str(
-                                    context.agent.id
-                                    if context and context.agent
-                                    else "unknown"
-                                ),
+                                "indexed_at": str(context.agent_id),
                             },
                         )
 
                         # Get agent ID for indexing
-                        agent_id = (
-                            context.agent.id if context and context.agent else None
-                        )
+                        agent_id = context.agent_id
                         if agent_id:
                             # Index the document
                             total_chunks, was_merged = await index_documents(

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_animagine_xl.py

@@ -137,7 +137,7 @@ class ImageGenerationAnimagineXL(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_arthemy_comics.py

@@ -137,7 +137,7 @@ class ImageGenerationArthemyComics(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_arthemy_real.py

@@ -137,7 +137,7 @@ class ImageGenerationArthemyReal(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_braindance.py

@@ -137,7 +137,7 @@ class ImageGenerationBrainDance(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_cyber_realistic_xl.py

@@ -137,7 +137,7 @@ class ImageGenerationCyberRealisticXL(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_flux_1_dev.py

@@ -137,7 +137,7 @@ class ImageGenerationFlux1Dev(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

{intentkit-0.6.0.dev13 → intentkit-0.6.0.dev15}/skills/heurist/image_generation_sdxl.py

@@ -136,7 +136,7 @@ class ImageGenerationSDXL(HeuristBaseTool):
             # Store the image URL
             image_url = response.text.strip('"')
             # Generate a key with agent ID as prefix
-            image_key = f"{context.agent.id}/heurist/{job_id}"
+            image_key = f"{context.agent_id}/heurist/{job_id}"
             # Store the image and get the CDN URL
             stored_url = await store_image(image_url, image_key)
 

intentkit-0.6.0.dev15/skills/http/README.md

@@ -0,0 +1,78 @@
+# HTTP Client Skills
+
+This skill category provides HTTP client functionality for making web requests using the httpx async client library.
+
+## Available Skills
+
+### http_get
+Make HTTP GET requests to fetch data from web APIs and websites.
+
+**Parameters:**
+- `url` (string, required): The URL to send the GET request to
+- `headers` (dict, optional): Custom headers to include in the request
+- `params` (dict, optional): Query parameters to include in the request
+- `timeout` (float, optional): Request timeout in seconds (default: 30)
+
+**Example usage:**
+```
+Fetch data from https://api.example.com/users with timeout of 10 seconds
+```
+
+### http_post
+Make HTTP POST requests to send data to web APIs and submit forms.
+
+**Parameters:**
+- `url` (string, required): The URL to send the POST request to
+- `data` (dict or string, optional): The data to send in the request body
+- `headers` (dict, optional): Custom headers to include in the request
+- `params` (dict, optional): Query parameters to include in the request
+- `timeout` (float, optional): Request timeout in seconds (default: 30)
+
+**Example usage:**
+```
+Send a POST request to https://api.example.com/users with JSON data {"name": "John", "email": "john@example.com"}
+```
+
+### http_put
+Make HTTP PUT requests to update or replace data on web APIs.
+
+**Parameters:**
+- `url` (string, required): The URL to send the PUT request to
+- `data` (dict or string, optional): The data to send in the request body
+- `headers` (dict, optional): Custom headers to include in the request
+- `params` (dict, optional): Query parameters to include in the request
+- `timeout` (float, optional): Request timeout in seconds (default: 30)
+
+**Example usage:**
+```
+Update user data at https://api.example.com/users/123 with {"name": "Jane Doe"}
+```
+
+## Features
+
+- **Async Support**: All HTTP operations are asynchronous using httpx
+- **Automatic JSON Handling**: Dictionary data is automatically sent as JSON with proper Content-Type headers
+- **Error Handling**: Comprehensive error handling for timeouts, HTTP errors, and connection issues
+- **Flexible Data Types**: Support for both JSON (dict) and raw string data in POST/PUT requests
+- **Custom Headers**: Support for custom headers in all request types
+- **Query Parameters**: Support for URL query parameters
+- **Configurable Timeouts**: Customizable request timeouts
+
+## Configuration
+
+Each skill can be configured with one of three states:
+- `disabled`: Skill is not available
+- `public`: Available to both agent owner and all users
+- `private`: Available only to the agent owner
+
+## Natural Language Usage
+
+These skills are designed to work seamlessly with natural language instructions:
+
+- "Get the weather data from the API"
+- "Send a POST request to create a new user"
+- "Update the user profile using PUT request"
+- "Fetch the latest news from the RSS feed"
+- "Submit the form data to the webhook"
+
+The AI agent will automatically select the appropriate HTTP method and construct the proper request based on your natural language description.