agenticdb
1.0.0
GenAI 에이전트의 세계는 LangGraph, AWS Bedrock 및 Semantic Kernel과 같은 프레임워크가 각각 자체 사일로에서 작동하여 단편화되어 있습니다. 이러한 상호 운용성 부족으로 인해 다양한 플랫폼, API 또는 레거시 시스템에 걸쳐 에이전트를 통합해야 하는 개발자와 기업에 장애물이 발생합니다.
AgenticDB는 이렇게 흩어져 있는 환경을 통합하는 솔루션으로 등장합니다. GenAI 에이전트 및 애플리케이션 매니페스트를 저장하고 관리하도록 특별히 설계된 데이터베이스입니다. AgenticDB를 사용하면 중앙 저장소에서 에이전트를 쉽게 추가, 검색, 호출 및 평가할 수 있습니다. Docker 기반 에이전트 관리 및 원격 실행과 같은 고급 기능은 다양성을 확장하여 다양한 GenAI 워크플로에 적응할 수 있게 해줍니다.
에이전트 처리 방식을 간소화함으로써 AgenticDB는 시간을 절약할 뿐만 아니라 모든 작업에 적합한 에이전트를 더 쉽게 찾고 활용할 수 있도록 하여 혁신을 촉진합니다. 이는 서로 다른 프레임워크를 연결하여 원활한 협업을 지원하고 GenAI 생태계의 발전을 가속화하는 다리입니다.
AgenticDB를 사용하면 다음을 수행할 수 있습니다.
AgenticDB 서버를 로컬로 시작하려면 다음 명령을 실행하십시오.
python server.py API는 http://127.0.0.1:8000 에서 사용할 수 있습니다.
다음은 제공된 Python 코드의 실제 JSON 응답 형식을 반영하여 README의 모든 컬렉션 삭제 섹션의 업데이트된 버전입니다.
다음 curl 명령을 사용하여 데이터베이스에 에이전트를 추가할 수 있습니다. 이 예에서는 code-gen-chart-agent 라는 새 에이전트를 추가하기 위해 JSON 요청을 보냅니다.
curl -X POST " http://127.0.0.1:8000/agents "
-H " Content-Type: application/json "
-H " Accept: application/json "
-d ' [
{
"metadata": {
"name": "code-gen-chart-agent",
"namespace": "agents",
"description": "Requests for a javascript code generator to plot a chart with supplied free-form data."
},
"spec": {
"type": "agent",
"lifecycle": "dev",
"owner": "[email protected]",
"access_level": "Public",
"category": "Travel Agent",
"url": "https://api.example.com/code-gen-chart-agent/agent",
"parameters": {
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "The request message for the chart code generator agent."
},
"thread": {
"type": "string",
"description": "The id to separate parallel message threads."
}
},
"required": ["message", "thread"],
"additionalProperties": false
},
"output": {
"type": "string",
"description": "The result of the request, including any generated image location."
}
}
}
] '그러면 에이전트 매니페스트가 AgenticDB에 추가되어 향후 검색 및 호출에 사용할 수 있게 됩니다.
자연어 쿼리를 기반으로 에이전트를 검색하려면 다음 curl 명령어를 사용하세요. 이 예에서는 "자연어"와 관련된 에이전트를 검색합니다.
curl -G " http://127.0.0.1:8000/agents "
-H " Accept: application/json "
--data-urlencode " query=Which agents can book travel? "AgenticDB는 유사성 검색을 수행하고 쿼리를 기반으로 일치하는 에이전트 목록을 반환합니다.
유사한 curl 명령을 사용하여 AgenticDB에 에이전트 애플리케이션을 추가할 수도 있습니다. 다음은 주가를 추적하고 차트를 생성하는 "주가 차트 작성 애플리케이션"을 추가하는 예입니다.
curl -X POST " http://127.0.0.1:8000/applications "
-H " Content-Type: application/json "
-H " Accept: application/json "
-d ' [
{
"metadata": {
"name": "Stock Price Charting Application",
"namespace": "production",
"description": "Provides access to daily open, high, low, close stock prices over time and the ability to generate charts for the requested data"
},
"spec": {
"type": "application",
"lifecycle": "dev",
"owner": "[email protected]",
"access_level": "PUBLIC",
"category": "Finance",
"setup": {
"compose": {
"compose_url": "https://ipfs.filebase.io/ipfs/somehash",
"run_command": "gunzip docker-compose.yml.gz && docker compose -f ./docker-compose.yml up -d"
}
},
"url": "http://localhost:3000/agent",
"method": "POST",
"example": "http://localhost:3000/agent ' Content-Type ' : ' application/json ' { ' input ' : ' what was the Nvidia close price on August 22nd 2024 ' , ' thread ' : ' nvidia ' }",
"parameters": {
"type": "object",
"properties": {
"input": {
"type": "string",
"description": "natural language request for stock price data and charting of the data as required"
},
"thread": {
"type": "string",
"description": "thread context id for the request"
}
},
"required": ["input"],
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"content": {
"type": "string",
"description": "the natural language response and the Final Answer to the request with a chart location if requested"
}
},
"description": "the answer to the request"
}
}
}
] ' 단일 DELETE 요청으로 AgenticDB에서 모든 에이전트, 애플리케이션 및 등급 컬렉션을 삭제할 수 있습니다. 이 작업은 agents , applications , ratings 저장된 컬렉션을 제거하려고 시도합니다. 각 컬렉션 삭제는 별도로 처리되며 결과에는 각 컬렉션이 성공적으로 삭제되었는지 여부가 반영됩니다.
curl -X DELETE " http://127.0.0.1:8000/collections " 응답은 JSON 개체 형식으로 각 삭제 시도의 상태를 제공합니다. 컬렉션이 성공적으로 삭제되면 값은 0 이 됩니다. 오류가 있는 경우 값에 해당 오류 메시지가 포함됩니다.
{
"agents" : 0 ,
"applications" : 0 ,
"ratings" : " Failed to delete ratings collection: some_error_message "
}0 agents 컬렉션이 성공적으로 삭제되었음을 나타냅니다.0 applications 컬렉션이 성공적으로 삭제되었음을 나타냅니다."some_error_message" 발생한 실제 오류로 대체). 에이전트와 상호작용한 후 이 curl 명령을 사용하여 에이전트에 대한 평가를 제출할 수 있습니다. placeholder_agent_id 및 placeholder_some_id 실제 상담원 및 등급 ID로 바꾸세요.
curl -X POST " http://127.0.0.1:8000/ratings "
-H " Content-Type: application/json "
-d ' {
"ratings": {
"agent_id": "placeholder_agent_id",
"id": "placeholder_some_id",
"data": {
"score": 4
}
}
} ' 이 curl 명령을 사용하여 상담원 등급을 검색할 수 있습니다. <ratings_id> 실제 등급 ID로 바꾸세요.
curl -X GET " http://127.0.0.1:8000/ratings?ratings_id=<ratings_id> "AgenticDB는 제공된 평가 ID와 관련된 점수 및 피드백을 반환합니다.
