Search Agent API
출처: 문서
본문
에이전트 검색 API
2.13에 도입 {: .label .label-purple }
이 명령어를 사용하면 이미 만들어 둔 에이전트를 검색할 수 있어요. 요청 본문에는 OpenSearch 검색 쿼리를 자유롭게 넣을 수 있어요.
엔드포인트
GET /_plugins/_ml/agents/_search
POST /_plugins/_ml/agents/_search
예제 요청: 모든 에이전트 검색하기
POST /_plugins/_ml/agents/_search
{
"query": {
"match_all": {}
},
"size": 1000
}
{% include copy-curl.html %}
예제 요청: 특정 타입의 에이전트 검색하기
POST /_plugins/_ml/agents/_search
{
"query": {
"term": {
"type": {
"value": "flow"
}
}
}
}
{% include copy-curl.html %}
예제: 설명으로 에이전트 검색하기
GET _plugins/_ml/agents/_search
{
"query": {
"bool": {
"should": [
{
"match": {
"description": "test agent"
}
}
]
}
},
"size": 1000
}
{% include copy-curl.html %}
예제 응답
{
"took": 2,
"timed_out": false,
"_shards": {
"total": 1,
"successful": 1,
"skipped": 0,
"failed": 0
},
"hits": {
"total": {
"value": 6,
"relation": "eq"
},
"max_score": 0.15019803,
"hits": [
{
"_index": ".plugins-ml-agent",
"_id": "8HXlkI0BfUsSoeNTP_0P",
"_version": 1,
"_seq_no": 17,
"_primary_term": 2,
"_score": 0.13904166,
"_source": {
"created_time": 1707532959502,
"last_updated_time": 1707532959502,
"name": "Test_Agent_For_RagTool",
"description": "this is a test flow agent",
"type": "flow",
"tools": [
{
"description": "A description of the tool",
"include_output_in_agent_response": false,
"type": "RAGTool",
"parameters": {
"inference_model_id": "gnDIbI0BfUsSoeNT_jAw",
"embedding_model_id": "Yg7HZo0B9ggZeh2gYjtu_2",
"input": "${parameters.question}",
"source_field": """["text"]""",
"embedding_field": "embedding",
"index": "my_test_data",
"query_type": "neural",
"prompt": """
Human:You are a professional data analyst. You will always answer question based on the given context first. If the answer is not directly shown in the context, you will analyze the data and find the answer. If you don't know the answer, just say don't know.
Context:
${parameters.output_field}
Human:${parameters.question}
Assistant:"""
}
}
]
}
}
]
}
}
응답 본문 필드
응답 필드에 대한 설명은 Register Agent API 요청 필드를 참고하세요.