PATCH
/
orchestrate
/
agents
/
{id}
Update A Registered Agent.
curl --request PATCH \
  --url http://localhost/api/v1/orchestrate/agents/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "instructions": "<string>",
  "tools": [
    "<string>"
  ],
  "collaborators": [
    "<string>"
  ],
  "llm": "<string>",
  "style": "default",
  "supported_apps": [
    "slack/askhr"
  ],
  "glossary": [
    "<string>"
  ],
  "guidelines": [
    {
      "display_name": "<string>",
      "condition": "<string>",
      "action": "<string>",
      "tool": "<string>"
    }
  ],
  "knowledge_base": [
    "<string>"
  ],
  "hidden": true,
  "display_name": "<string>",
  "structured_output": {},
  "custom_join_tool": "<string>",
  "additional_properties": {
    "starter_prompts": {
      "customize": [
        {
          "id": "<string>",
          "title": "<string>",
          "subtitle": "<string>",
          "prompt": "<string>",
          "state": "<string>"
        }
      ]
    },
    "welcome_content": {
      "welcome_message": "<string>",
      "description": "<string>"
    }
  },
  "tags": [
    "<string>"
  ],
  "voice_configuration_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "chat_with_docs": {
    "enabled": true,
    "vector_index": {
      "embeddings_model_name": "<string>",
      "chunk_size": 400,
      "chunk_overlap": 50,
      "limit": 10
    },
    "generation": {
      "model_id": "<string>",
      "prompt_instruction": "",
      "generated_response_length": "Moderate",
      "display_text_no_results_found": "I searched my knowledge base, but did not find anything related to your query",
      "display_text_connectivity_issue": "I might have information related to your query to share, but am unable to connect to my knowledge base at the moment"
    },
    "query_rewrite": {
      "enabled": true,
      "model_id": "<string>"
    },
    "confidence_thresholds": {
      "retrieval_confidence_threshold": "Low",
      "response_confidence_threshold": "Low"
    },
    "citations": {
      "citation_title": "How do we know?",
      "citations_shown": -1
    },
    "hap_filtering": {
      "output": {
        "enabled": false,
        "threshold": 0.5
      }
    }
  },
  "context_access_enabled": true,
  "context_variables": [
    "<string>"
  ]
}'
"<any>"

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Body

application/json

Schema for updating an existing agent.

Response

200
application/json

Successful Response

The response is of type any.