{"id":24623241,"url":"https://github.com/oscarcitoz/agent-config","last_synced_at":"2026-02-26T03:40:13.963Z","repository":{"id":273749365,"uuid":"920517953","full_name":"oscarcitoz/agent-config","owner":"oscarcitoz","description":"Kotlin microservice for managing agents, configurations, and tools. Integrates with AI systems like OpenAI and Amazon Bedrock. Uses PostgreSQL and supports agent retrieval by ID or similarity (via Vector DB).","archived":false,"fork":false,"pushed_at":"2025-01-22T19:02:42.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-22T19:22:15.383Z","etag":null,"topics":["agent-management","ai-integration","kotlin","microservice","openai","postgresql","tool-management","vector-db"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oscarcitoz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-22T09:45:09.000Z","updated_at":"2025-01-22T19:02:47.000Z","dependencies_parsed_at":"2025-01-22T19:22:24.188Z","dependency_job_id":"ddb77400-4a60-4f13-ac83-bd4272e43111","html_url":"https://github.com/oscarcitoz/agent-config","commit_stats":null,"previous_names":["oscarcitoz/agent-config"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarcitoz%2Fagent-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarcitoz%2Fagent-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarcitoz%2Fagent-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarcitoz%2Fagent-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oscarcitoz","download_url":"https://codeload.github.com/oscarcitoz/agent-config/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244345101,"owners_count":20438241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-management","ai-integration","kotlin","microservice","openai","postgresql","tool-management","vector-db"],"created_at":"2025-01-25T03:57:13.393Z","updated_at":"2026-02-26T03:40:13.934Z","avatar_url":"https://github.com/oscarcitoz.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agent Config Microservice\n\n## Overview\nThe `Agent Config` microservice is responsible for managing agents, their configurations, and tools. It serves as an intermediary for the `Converse` microservice, providing necessary agent context and tools for communication with AI systems like OpenAI or Amazon Bedrock.\n\n## Documentation\nPuedes encontrar la colección completa de Postman con todos los endpoints aquí:\n[Colección Postman](https://sumer-07062021.postman.co/workspace/SUMER~148b538f-9145-4526-8806-bb1cc611d3bd/collection/16642082-cb410cc2-8ada-45d5-b47d-b3d303bee5fe?action=share\u0026creator=16642082\u0026active-environment=16640760-5fde9fd8-7328-4098-8d82-c9d5fa254624)\n\n## Construcción y Ejecución\n\n### Usando Docker\n\n1. Construir la imagen Docker (incluye la compilación):\n```bash\ndocker build -t agent-config-ms .\n```\n\n2. Ejecutar el contenedor:\n```bash\ndocker run -p 8080:8080 agent-config-ms\n```\n\n3. Para detener el contenedor:\n```bash\ndocker stop $(docker ps -q --filter ancestor=agent-config-ms)\n```\n\nEl servicio estará disponible en `http://localhost:8080`\n\n### Construcción local (alternativa)\nSi prefieres construir y ejecutar localmente sin Docker:\n```bash\n./gradlew clean build\n./gradlew run\n```\n\nThis microservice is written in Kotlin and uses PostgreSQL as its database. It has three main tables:\n- **agent_configs**: Stores the configuration details of each agent.\n- **tools**: Stores the details of various tools.\n- **agent_tool**: Represents the relationship between agents and their tools.\n\n## Features\n1. **Agent Configuration Management**: Create and manage agent configurations.\n2. **Tool Management**: Add, associate, and remove tools for agents.\n3. **Agent Retrieval**:\n   - Retrieve an agent by its `agent_id`.\n   - Retrieve an agent by query similarity via a separate microservice called `Vector DB`.\n\n## Endpoints\n\n### 1. Create an Agent Configuration\n**Endpoint:**\n```http\nPOST /api/ms/agent/config\n```\n**Request Headers:**\n```\nContent-Type: application/json\n```\n**Request Body:**\n```json\n{\n    \"agent_id\": \"mi_primer_agente\",\n    \"preferences\": {\n        \"example_response\": \"dasdasdas\"\n    }\n}\n```\n**Description:**\nCreates a new agent configuration.\n\n---\n\n### 2. Create a Tool\n**Endpoint:**\n```http\nPOST /api/ms/agent/tool\n```\n**Request Headers:**\n```\nContent-Type: application/json\n```\n**Request Body:**\n```json\n{\n    \"name\": \"mi_primera_herramienta\",\n    \"description\": \"Descripción de la herramienta\",\n    \"type\": \"Tipo de la herramienta\",\n    \"config\": {\"xasxa\": \"xaaz\"}\n}\n```\n**Description:**\nCreates a new tool.\n\n---\n\n### 3. Associate a Tool with an Agent\n**Endpoint:**\n```http\nPOST /api/ms/agent/config/{agent_id}/tools/{tool_name}\n```\n**Description:**\nAssociates an existing tool with a specific agent.\n\n**Example:**\n```bash\ncurl --location --request POST 'http://localhost:8080/api/ms/agent/config/mi_primer_agente/tools/mi_primera_herramienta'\n```\n\n---\n\n### 4. Remove a Tool from an Agent\n**Endpoint:**\n```http\nDELETE /api/ms/agent/config/{agent_id}/tools/{tool_name}\n```\n**Description:**\nRemoves the association between a tool and an agent.\n\n**Example:**\n```bash\ncurl --location --request DELETE 'http://localhost:8080/api/ms/agent/config/mi_primer_agente/tools/mi_primera_herramienta'\n```\n\n---\n\n### 5. Retrieve an Agent by Query Similarity\n**Description:**\nTo retrieve an agent by query similarity, the `Agent Config` microservice communicates with the `Vector DB` microservice. This external microservice handles the similarity search and returns the most relevant agent.\n\n---\n\n## Technologies Used\n- **Programming Language:** Kotlin\n- **Database:** PostgreSQL\n- **API Framework:** Micronaut\n- **Containerization:** Docker\n\n## Running Locally\n1. Clone the repository.\n2. Ensure PostgreSQL is installed and running.\n3. Update the database configuration in the application properties.\n4. Run the application using:\n   ```bash\n   ./gradlew run\n   ```\n\n## Notes\n- Make sure the `Vector DB` microservice is up and running to use the query similarity feature.\n- Customize the database schema and table names as needed.\n\n## Future Improvements\n- Add more detailed logging.\n- Enhance security features such as authentication and authorization.\n- Implement rate limiting for API endpoints.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscarcitoz%2Fagent-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foscarcitoz%2Fagent-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscarcitoz%2Fagent-config/lists"}