bring back prompt targets

docs/source/resources/includes/arch_config_full_reference.yaml

@@ -1,22 +1,26 @@
+
 # Arch Gateway configuration version
 version: v0.3.0
 
+
 # External HTTP agents - API type is controlled by request path (/v1/responses, /v1/messages, /v1/chat/completions)
 agents:
-  - id: weather_agent
+  - id: weather_agent  # Example agent for weather
     url: http://host.docker.internal:10510
 
-  - id: flight_agent
+  - id: flight_agent   # Example agent for flights
     url: http://host.docker.internal:10520
 
+
 # MCP filters applied to requests/responses (e.g., input validation, query rewriting)
 filters:
-  - id: input_guards
+  - id: input_guards  # Example filter for input validation
     url: http://host.docker.internal:10500
     # type: mcp (default)
     # transport: streamable-http (default)
     # tool: input_guards (default - same as filter id)
 
+
 # LLM provider configurations with API keys and model routing
 model_providers:
   - model: openai/gpt-4o
@@ -32,6 +36,7 @@ model_providers:
   - model: mistral/ministral-3b-latest
     access_key: $MISTRAL_API_KEY
 
+
 # Model aliases - use friendly names instead of full provider model names
 model_aliases:
   fast-llm:
@@ -40,7 +45,8 @@ model_aliases:
   smart-llm:
     target: gpt-4o
 
-# HTTP listeners - entry points for agent routing and direct LLM access
+
+# HTTP listeners - entry points for agent routing, prompt targets, and direct LLM access
 listeners:
   # Agent listener for routing requests to multiple agents
   - type: agent
@@ -60,6 +66,14 @@ listeners:
     address: 0.0.0.0
     port: 12000
 
+  # Prompt listener for function calling (for prompt_targets)
+  - type: prompt
+    name: prompt_function_listener
+    address: 0.0.0.0
+    port: 10000
+    # This listener is used for prompt_targets and function calling
+
+
 # Reusable service endpoints
 endpoints:
   app_server:
@@ -69,6 +83,27 @@ endpoints:
   mistral_local:
     endpoint: 127.0.0.1:8001
 
+
+# Prompt targets for function calling and API orchestration
+prompt_targets:
+  - name: get_current_weather
+    description: Get current weather at a location.
+    parameters:
+      - name: location
+        description: The location to get the weather for
+        required: true
+        type: string
+        format: City, State
+      - name: days
+        description: the number of days for the request
+        required: true
+        type: int
+    endpoint:
+      name: app_server
+      path: /weather
+      http_method: POST
+
+
 # OpenTelemetry tracing configuration
 tracing:
   # Random sampling percentage (1-100)