Remote Agent Resource

Note: This capability is now provided as an installable component. See the Components guide for how to install and use it.

Install: kdeps registry install remoteagent

Usage: run: { component: { name: remoteagent, with: { url: "...", query: "..." } } }

The Remote Agent component invokes a remote kdeps agent over HTTP, sending a query and returning the agent's response.

Component Inputs

Input	Type	Required	Default	Description
url	string	yes	—	Base URL of the remote kdeps agent (e.g. http://host:16394)
query	string	yes	—	Query or request body to send to the agent

Using the Remote Agent Component

run:
  component:
    name: remoteagent
    with:
      url: "https://remote-agent.example.com"
      query: "Translate 'Hello, world!' to French"

Access the result via output('<callerActionId>'). The result includes the agent's response.

---

Result Map

Key	Type	Description
success	bool	true if the remote agent responded successfully.
response	any	The agent's response payload.

---

Expression Support

All fields support KDeps expressions:

run:
  component:
    name: remoteagent
    with:
      url: "{{ env('REMOTE_AGENT_URL') }}"
      query: "{{ get('user_query') }}"

---

Full Example: Multi-Agent Pipeline

# Step 1: Call a remote translation agent
- apiVersion: kdeps.io/v1
  kind: Resource

  metadata:
    actionId: translate
    name: Translate via Remote Agent

  run:
    component:
      name: remoteagent
      with:
        url: "{{ env('TRANSLATOR_AGENT_URL') }}"
        query: "{{ get('text_to_translate') }}"

# Step 2: Use the translation result
- apiVersion: kdeps.io/v1
  kind: Resource

  metadata:
    actionId: respond
    name: Return Translation
    requires:
      - translate

  run:
    apiResponse:
      success: true
      response:
        translation: "{{ output('translate').response }}"

---

See Also

• agent: - In-process delegation within an agency